pypcapkit 1.3.5.post6__cp313-none-any.whl

pcapkit/protocols/link/ethernet.py

@@ -0,0 +1,248 @@
+# -*- coding: utf-8 -*-
+"""Ethernet Protocol
+=======================
+
+.. module:: pcapkit.protocols.link.ethernet
+
+:mod:`pcapkit.protocols.link.ethernet` contains
+:class:`~pcapkit.protocols.link.ethernet.Ethernet`
+only, which implements extractor for Ethernet
+Protocol [*]_, whose structure is described as
+below:
+
+.. table::
+
+   ====== ===== ============ =========================
+   Octets Bits  Name         Description
+   ====== ===== ============ =========================
+   0          0 ``eth.dst``  Destination MAC Address
+   ------ ----- ------------ -------------------------
+   1          8 ``eth.src``  Source MAC Address
+   ------ ----- ------------ -------------------------
+   2         16 ``eth.type`` Protocol (Internet Layer)
+   ====== ===== ============ =========================
+
+.. [*] https://en.wikipedia.org/wiki/Ethernet
+
+"""
+import re
+import sys
+import textwrap
+from typing import TYPE_CHECKING
+
+from pcapkit.const.reg.ethertype import EtherType as Enum_EtherType
+from pcapkit.const.reg.linktype import LinkType as Enum_LinkType
+from pcapkit.protocols.data.link.ethernet import Ethernet as Data_Ethernet
+from pcapkit.protocols.link.link import Link
+from pcapkit.protocols.schema.link.ethernet import Ethernet as Schema_Ethernet
+from pcapkit.utilities.exceptions import ProtocolError
+
+if TYPE_CHECKING:
+    from enum import IntEnum as StdlibEnum
+    from typing import Any, Optional, Type
+
+    from aenum import IntEnum as AenumEnum
+    from typing_extensions import Literal
+
+    from pcapkit.protocols.protocol import ProtocolBase as Protocol
+    from pcapkit.protocols.schema.schema import Schema
+
+__all__ = ['Ethernet']
+
+# check Python version
+py38 = ((version_info := sys.version_info).major >= 3 and version_info.minor >= 8)
+
+# Ethernet address pattern
+PAT_MAC_ADDR = re.compile(rb'(?i)(?:[0-9a-f]{2}[:-]){5}[0-9a-f]{2}')
+
+
+class Ethernet(Link[Data_Ethernet, Schema_Ethernet],
+               schema=Schema_Ethernet, data=Data_Ethernet):
+    """This class implements Ethernet Protocol."""
+
+    ##########################################################################
+    # Properties.
+    ##########################################################################
+
+    @property
+    def name(self) -> 'Literal["Ethernet Protocol"]':
+        """Name of current protocol."""
+        return 'Ethernet Protocol'
+
+    @property
+    def length(self) -> 'Literal[14]':
+        """Header length of current protocol."""
+        return 14
+
+    @property
+    def protocol(self) -> 'Enum_EtherType':
+        """Name of next layer protocol."""
+        return self._info.type
+
+    # source mac address
+    @property
+    def src(self) -> 'str':
+        """Source mac address."""
+        return self._info.src
+
+    # destination mac address
+    @property
+    def dst(self) -> 'str':
+        """Destination mac address."""
+        return self._info.dst
+
+    ##########################################################################
+    # Methods.
+    ##########################################################################
+
+    def read(self, length: 'Optional[int]' = None, **kwargs: 'Any') -> 'Data_Ethernet':  # pylint: disable=unused-argument
+        """Read Ethernet Protocol.
+
+        Structure of Ethernet header [:rfc:`7042`]:
+
+        .. code-block:: text
+
+            0                   1                   2                   3
+            0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |                         Dst MAC Addr                          |
+           +                               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |                               |                               |
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               +
+           |                         Src MAC Addr                          |
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |          Ether Type           |
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+        Args:
+            length: Length of packet data.
+            **kwargs: Arbitrary keyword arguments.
+
+        Returns:
+            Parsed packet data.
+
+        """
+        if length is None:
+            length = len(self)
+        schema = self.__header__
+
+        _dstm = self._read_mac_addr(schema.dst)
+        _srcm = self._read_mac_addr(schema.src)
+        _type = schema.type
+
+        ethernet = Data_Ethernet(
+            dst=_dstm,
+            src=_srcm,
+            type=_type,
+        )
+        return self._decode_next_layer(ethernet, _type, length - self.length)
+
+    def make(self,
+             dst: 'str | bytes | bytearray' = '00:00:00:00:00:00',
+             src: 'str | bytes | bytearray' = '00:00:00:00:00:00',
+             type: 'Enum_EtherType | StdlibEnum | AenumEnum | str | int' = Enum_EtherType.Internet_Protocol_version_4,
+             type_default: 'Optional[int]' = None,
+             type_namespace: 'Optional[dict[str, int] | dict[int, str] | Type[StdlibEnum] | Type[AenumEnum]]' = None,  # pylint: disable=line-too-long
+             type_reversed: 'bool' = False,
+             payload: 'bytes | Protocol | Schema' = b'',
+             **kwargs: 'Any') -> 'Schema_Ethernet':
+        """Make (construct) packet data.
+
+        Args:
+            dst: Destination MAC address.
+            src: Source MAC address.
+            type: EtherType.
+            type_default: Default EtherType.
+            type_namespace: EtherType namespace.
+            type_reversed: Whether EtherType is reversed.
+            payload: Payload data.
+            **kwargs: Arbitrary keyword arguments.
+
+        Returns:
+            Constructed packet data.
+
+        """
+        _type = self._make_index(type, type_default, namespace=type_namespace,
+                                 reversed=type_reversed, pack=False)
+
+        return Schema_Ethernet(
+            dst=self._make_mac_addr(dst),
+            src=self._make_mac_addr(src),
+            type=_type,  # type: ignore[arg-type]
+            payload=payload,
+        )
+
+    ##########################################################################
+    # Data models.
+    ##########################################################################
+
+    def __length_hint__(self) -> 'Literal[14]':
+        """Return an estimated length for the object."""
+        return 14
+
+    @classmethod
+    def __index__(cls) -> 'Enum_LinkType':  # pylint: disable=invalid-index-returned
+        """Numeral registry index of the protocol.
+
+        Returns:
+            Numeral registry index of the protocol in `tcpdump`_ link-layer
+            header types.
+
+        .. _tcpdump: https://www.tcpdump.org/linktypes.html
+
+        """
+        return Enum_LinkType.ETHERNET  # type: ignore[return-value]
+
+    ##########################################################################
+    # Utilities.
+    ##########################################################################
+
+    @classmethod
+    def _make_data(cls, data: 'Data_Ethernet') -> 'dict[str, Any]':  # type: ignore[override]
+        """Create key-value pairs from ``data`` for protocol construction.
+
+        Args:
+            data: protocol data
+
+        Returns:
+            Key-value pairs for protocol construction.
+
+        """
+        return {
+            'dst': data.dst,
+            'src': data.src,
+            'type': data.type,
+            'payload': cls._make_payload(data),
+        }
+
+    def _read_mac_addr(self, addr: 'bytes') -> 'str':
+        """Read MAC address.
+
+        Args:
+            addr: MAC address.
+
+        Returns:
+            Colon (``:``) seperated *hex* encoded MAC address.
+
+        """
+        if py38:
+            _addr = addr.hex(':')
+        else:
+            _addr = ':'.join(textwrap.wrap(addr.hex(), 2))
+        return _addr
+
+    def _make_mac_addr(self, addr: 'str | bytes | bytearray') -> 'bytes':
+        """Make MAC address.
+
+        Args:
+            addr: MAC address.
+
+        Returns:
+            MAC address.
+
+        """
+        _addr = addr.encode() if isinstance(addr, str) else addr
+
+        if PAT_MAC_ADDR.fullmatch(_addr) is not None:
+            return _addr.replace(b':', b'').replace(b'-', b'')
+        raise ProtocolError(f'invalid MAC address: {addr!r}')

pcapkit/protocols/link/l2tp.py

@@ -0,0 +1,267 @@
+# -*- coding: utf-8 -*-
+"""L2TP - Layer Two Tunnelling Protocol
+==========================================
+
+.. module:: pcapkit.protocols.link.l2tp
+
+:mod:`pcapkit.protocols.link.l2tp` contains
+:class:`~pcapkit.protocols.link.l2tp.L2TP` only,
+which implements extractor for Layer Two Tunnelling
+Protocol (L2TP) [*]_, whose structure is described
+as below:
+
+.. table::
+
+   ======= ===== ===================== ==========================================
+    Octets Bits  Name                  Description
+   ======= ===== ===================== ==========================================
+    0          0 ``l2tp.flags``        Flags and Version Info
+   ------- ----- --------------------- ------------------------------------------
+    0          0 ``l2tp.flags.type``   Type (control / data)
+   ------- ----- --------------------- ------------------------------------------
+    0          1 ``l2tp.flags.len``    Length
+   ------- ----- --------------------- ------------------------------------------
+    0          2                       Reserved (must be zero ``x00``)
+   ------- ----- --------------------- ------------------------------------------
+    0          4 ``l2tp.flags.seq``    Sequence
+   ------- ----- --------------------- ------------------------------------------
+    0          5                       Reserved (must be zero ``x00``)
+   ------- ----- --------------------- ------------------------------------------
+    0          6 ``l2tp.flags.offset`` Offset
+   ------- ----- --------------------- ------------------------------------------
+    0          7 ``l2tp.flags.prio``   Priority
+   ------- ----- --------------------- ------------------------------------------
+    1          8                       Reserved (must be zero ``x00``)
+   ------- ----- --------------------- ------------------------------------------
+    1         12 ``l2tp.ver``          Version (``2``)
+   ------- ----- --------------------- ------------------------------------------
+    2         16 ``l2tp.length``       Length (optional by ``len``)
+   ------- ----- --------------------- ------------------------------------------
+    4         32 ``l2tp.tunnelid``     Tunnel ID
+   ------- ----- --------------------- ------------------------------------------
+    6         48 ``l2tp.sessionid``    Session ID
+   ------- ----- --------------------- ------------------------------------------
+    8         64 ``l2tp.ns``           Sequence Number (optional by ``seq``)
+   ------- ----- --------------------- ------------------------------------------
+    10        80 ``l2tp.nr``           Next Sequence Number (optional by ``seq``)
+   ------- ----- --------------------- ------------------------------------------
+    12        96 ``l2tp.offset``       Offset Size (optional by ``offset``)
+   ======= ===== ===================== ==========================================
+
+.. [*] https://en.wikipedia.org/wiki/Layer_2_Tunneling_Protocol
+
+"""
+from typing import TYPE_CHECKING
+
+from pcapkit.const.l2tp.type import Type as Enum_Type
+from pcapkit.protocols.data.link.l2tp import L2TP as Data_L2TP
+from pcapkit.protocols.data.link.l2tp import Flags as Data_Flags
+from pcapkit.protocols.link.link import Link
+from pcapkit.protocols.schema.link.l2tp import L2TP as Schema_L2TP
+from pcapkit.utilities.exceptions import UnsupportedCall
+
+if TYPE_CHECKING:
+    from enum import IntEnum as StdlibEnum
+    from typing import Any, NoReturn, Optional, Type
+
+    from aenum import IntEnum as AenumEnum
+    from typing_extensions import Literal
+
+    from pcapkit.protocols.protocol import ProtocolBase as Protocol
+    from pcapkit.protocols.schema.schema import Schema
+
+__all__ = ['L2TP']
+
+
+class L2TP(Link[Data_L2TP, Schema_L2TP],
+           schema=Schema_L2TP, data=Data_L2TP):
+    """This class implements Layer Two Tunnelling Protocol."""
+
+    ##########################################################################
+    # Properties.
+    ##########################################################################
+
+    @property
+    def name(self) -> 'Literal["Layer 2 Tunnelling Protocol"]':
+        """Name of current protocol."""
+        return 'Layer 2 Tunnelling Protocol'
+
+    @property
+    def length(self) -> 'int':
+        """Header length of current protocol."""
+        return self._info.hdr_len
+
+    @property
+    def type(self) -> 'Literal["control", "data"]':
+        """L2TP type."""
+        return self._info.flags.type
+
+    ##########################################################################
+    # Methods.
+    ##########################################################################
+
+    def read(self, length: 'Optional[int]' = None, **kwargs: 'Any') -> 'Data_L2TP':  # pylint: disable=unused-argument
+        """Read Layer Two Tunnelling Protocol.
+
+        Structure of L2TP header [:rfc:`2661`]:
+
+        .. code-block:: text
+
+            0                   1                   2                   3
+            0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |T|L|x|x|S|x|O|P|x|x|x|x|  Ver  |          Length (opt)         |
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |           Tunnel ID           |           Session ID          |
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |             Ns (opt)          |             Nr (opt)          |
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+           |      Offset Size (opt)        |    Offset pad... (opt)
+           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+        Args:
+            length: Length of packet data.
+            **kwargs: Arbitrary keyword arguments.
+
+        Returns:
+            Parsed packet data.
+
+        """
+        schema = self.__header__
+        _flag = schema.flags
+
+        flags = Data_Flags(
+            type=Enum_Type(_flag['type']),
+            len=bool(_flag['len']),
+            seq=bool(_flag['seq']),
+            offset=bool(_flag['offset']),
+            prio=bool(_flag['prio']),
+        )
+
+        _size = schema.offset if flags.offset else 0
+        hdr_len = 6 + 2 * (flags.len + 2 * flags.seq + flags.offset) + _size
+
+        l2tp = Data_L2TP(
+            flags=flags,
+            version=_flag['version'],
+            length=schema.length if flags.len else None,
+            tunnelid=schema.tunnel_id,
+            sessionid=schema.session_id,
+            ns=schema.ns if flags.seq else None,
+            nr=schema.nr if flags.seq else None,
+            offset=_size if flags.offset else None,
+        )
+
+        l2tp.__update__([
+            ('hdr_len', hdr_len),
+        ])
+        if _size:
+            self._read_fileng(_size)
+            # l2tp['padding'] = self._read_fileng(_size)
+
+        length = schema.length if flags.len else (length or len(self))
+        return self._decode_next_layer(l2tp, length - hdr_len)
+
+    def make(self,
+             version: 'Literal[2]' = 2,
+             type: 'Enum_Type | StdlibEnum | AenumEnum | str | int' = Enum_Type.Data,
+             type_default: 'Optional[int]' = None,
+             type_namespace: 'Optional[dict[str, int] | dict[int, str] | Type[StdlibEnum] | Type[AenumEnum]]' = None,  # pylint: disable=line-too-long
+             type_reversed: 'bool' = False,
+             priority: 'bool' = False,
+             length: 'Optional[int]' = None,
+             tunnel_id: 'int' = 0,
+             session_id: 'int' = 0,
+             ns: 'Optional[int]' = None,
+             nr: 'Optional[int]' = None,
+             offset: 'Optional[int]' = None,
+             payload: 'bytes | Protocol | Schema' = b'',
+             **kwargs: 'Any') -> 'Schema_L2TP':  # pylint: disable=unused-argument
+        """Make (construct) packet data.
+
+        Args:
+            version: L2TP version.
+            type: L2TP type.
+            type_default: Default value of type.
+            type_namespace: Namespace of type.
+            type_reversed: Reversed namespace of type.
+            priority: Priority flag.
+            length: Length of packet data.
+            tunnel_id: Tunnel ID.
+            session_id: Session ID.
+            ns: Sequence number.
+            nr: Acknowledgement number.
+            offset: Offset size.
+            payload: Payload data.
+            **kwargs: Arbitrary keyword arguments.
+
+        Returns:
+            Constructed packet data.
+
+        """
+        type_ = self._make_index(type, type_default, namespace=type_namespace,
+                                 reversed=type_reversed, pack=False)
+
+        return Schema_L2TP(
+            flags={
+                'type': type_,
+                'len': length is not None,
+                'seq': ns is not None and nr is not None,
+                'offset': offset is not None,
+                'prio': priority,
+                'version': version,
+            },
+            length=length,
+            tunnel_id=tunnel_id,
+            session_id=session_id,
+            ns=ns,
+            nr=nr,
+            offset=offset,
+            payload=payload,
+        )
+
+    ##########################################################################
+    # Data models.
+    ##########################################################################
+
+    def __length_hint__(self) -> 'Literal[16]':
+        """Return an estimated length for the object."""
+        return 16
+
+    @classmethod
+    def __index__(cls) -> 'NoReturn':  # pylint: disable=invalid-index-returned
+        """Numeral registry index of the protocol.
+
+        Raises:
+            UnsupportedCall: This protocol has no registry entry.
+
+        """
+        raise UnsupportedCall(f'{cls.__name__!r} object cannot be interpreted as an integer')
+
+    ##########################################################################
+    # Utilities.
+    ##########################################################################
+
+    @classmethod
+    def _make_data(cls, data: 'Data_L2TP') -> 'dict[str, Any]':  # type: ignore[override]
+        """Create key-value pairs from ``data`` for protocol construction.
+
+        Args:
+            data: protocol data
+
+        Returns:
+            Key-value pairs for protocol construction.
+
+        """
+        return {
+            'type': data.flags.type,
+            'prio': data.flags.prio,
+            'version': data.version,
+            'length': data.length,
+            'tunnel_id': data.tunnelid,
+            'session_id': data.sessionid,
+            'ns': data.ns,
+            'nr': data.nr,
+            'offset': data.offset,
+            'payload': cls._make_payload(data),
+        }

pcapkit/protocols/link/link.py

@@ -0,0 +1,140 @@
+# -*- coding: utf-8 -*-
+# mypy: disable-error-code=dict-item
+"""Base Protocol
+===================
+
+.. module:: pcapkit.protocols.link.link
+
+:mod:`pcapkit.protocols.link.link` contains
+:class:`~pcapkit.protocols.link.link.Link`,
+which is a base class for link layer protocols, e.g.
+:class:`~pcapkit.protocols.link.arp.ARP`/:class:`~pcapkit.protocols.link.arp.InARP`,
+:class:`~pcapkit.protocols.link.ethernet.Ethernet`,
+:class:`~pcapkit.protocols.link.l2tp.L2TP`,
+:class:`~pcapkit.protocols.link.ospf.OSPF`,
+:class:`~pcapkit.protocols.link.rarp.RARP`/:class:`~pcapkit.protocols.link.rarp.DRARP`
+and etc.
+
+"""
+import collections
+from typing import TYPE_CHECKING, Generic
+
+from pcapkit.const.reg.ethertype import EtherType as Enum_EtherType
+from pcapkit.corekit.module import ModuleDescriptor
+from pcapkit.protocols.protocol import _PT, _ST
+from pcapkit.protocols.protocol import ProtocolBase as Protocol
+from pcapkit.utilities.exceptions import RegistryError
+from pcapkit.utilities.warnings import RegistryWarning, warn
+
+if TYPE_CHECKING:
+    from typing import DefaultDict, Type
+
+    from typing_extensions import Literal
+
+__all__ = ['Link']
+
+
+class Link(Protocol[_PT, _ST], Generic[_PT, _ST]):  # pylint: disable=abstract-method
+    """Abstract base class for link layer protocol family.
+
+    This class currently supports parsing of the following protocols, which are
+    registered in the :attr:`self.__proto__ <pcapkit.protocols.link.link.Link.__proto__>`
+    attribute:
+
+    .. list-table::
+       :header-rows: 1
+
+       * - Index
+         - Protocol
+       * - :attr:`~pcapkit.const.reg.ethertype.EtherType.Address_Resolution_Protocol`
+         - :class:`pcapkit.protocols.link.arp.ARP`
+       * - :attr:`~pcapkit.const.reg.ethertype.EtherType.Reverse_Address_Resolution_Protocol`
+         - :class:`pcapkit.protocols.link.rarp.RARP`
+       * - :attr:`~pcapkit.const.reg.ethertype.EtherType.Customer_VLAN_Tag_Type`
+         - :class:`pcapkit.protocols.link.vlan.VLAN`
+       * - :attr:`~pcapkit.const.reg.ethertype.EtherType.Internet_Protocol_version_4`
+         - :class:`pcapkit.protocols.internet.ipv4.IPv4`
+       * - :attr:`~pcapkit.const.reg.ethertype.EtherType.Internet_Protocol_version_6`
+         - :class:`pcapkit.protocols.internet.ipv6.IPv6`
+       * - 0x8137
+         - :class:`pcapkit.protocols.internet.ipx.IPX`
+
+    """
+
+    ##########################################################################
+    # Defaults.
+    ##########################################################################
+
+    #: Layer of protocol.
+    __layer__ = 'Link'  # type: Literal['Link']
+
+    #: DefaultDict[int, ModuleDescriptor[Protocol] | Type[Protocol]]: Protocol index mapping for decoding next layer,
+    #: c.f. :meth:`self._decode_next_layer <pcapkit.protocols.protocol.Protocol._decode_next_layer>`
+    #: & :meth:`self._import_next_layer <pcapkit.protocols.protocol.Protocol._import_next_layer>`.
+    __proto__ = collections.defaultdict(
+        lambda: ModuleDescriptor('pcapkit.protocols.misc.raw', 'Raw'),
+        {
+            Enum_EtherType.Address_Resolution_Protocol:         ModuleDescriptor('pcapkit.protocols.link.arp',      'ARP'),
+            Enum_EtherType.Reverse_Address_Resolution_Protocol: ModuleDescriptor('pcapkit.protocols.link.rarp',     'RARP'),
+            Enum_EtherType.Customer_VLAN_Tag_Type:              ModuleDescriptor('pcapkit.protocols.link.vlan',     'VLAN'),
+            Enum_EtherType.Internet_Protocol_version_4:         ModuleDescriptor('pcapkit.protocols.internet.ipv4', 'IPv4'),
+            Enum_EtherType.Internet_Protocol_version_6:         ModuleDescriptor('pcapkit.protocols.internet.ipv6', 'IPv6'),
+
+            # c.f., https://en.wikipedia.org/wiki/EtherType#Values
+            0x8137:                                             ModuleDescriptor('pcapkit.protocols.internet.ipx',  'IPX'),
+        },
+    )  # type: DefaultDict[int | Enum_EtherType, ModuleDescriptor[Protocol] | Type[Protocol]]
+
+    ##########################################################################
+    # Properties.
+    ##########################################################################
+
+    # protocol layer
+    @property
+    def layer(self) -> 'Literal["Link"]':
+        """Protocol layer."""
+        return self.__layer__
+
+    ##########################################################################
+    # Methods.
+    ##########################################################################
+
+    @classmethod
+    def register(cls, code: 'Enum_EtherType', protocol: 'ModuleDescriptor[Protocol] | Type[Protocol]') -> 'None':  # type: ignore[override]
+        r"""Register a new protocol class.
+
+        Notes:
+            The full qualified class name of the new protocol class
+            should be as ``{protocol.module}.{protocol.name}``.
+
+        Arguments:
+            code: protocol code as in :class:`~pcapkit.const.reg.ethertype.EtherType`
+            protocol: module descriptor or a
+                :class:`~pcapkit.protocols.protocol.Protocol` subclass
+
+        """
+        if isinstance(protocol, ModuleDescriptor):
+            protocol = protocol.klass
+        if not issubclass(protocol, Protocol):
+            raise RegistryError(f'protocol must be a Protocol subclass, not {protocol!r}')
+        if code in cls.__proto__:
+            warn(f'protocol {code} already registered, overwriting', RegistryWarning)
+        cls.__proto__[code] = protocol
+
+    ##########################################################################
+    # Utilities.
+    ##########################################################################
+
+    def _read_protos(self, size: int) -> 'Enum_EtherType':
+        """Read next layer protocol type.
+
+        Arguments:
+            size: buffer size
+
+        Returns:
+            Internet layer protocol enumeration.
+
+        """
+        _byte = self._read_unpack(size)
+        _prot = Enum_EtherType.get(_byte)
+        return _prot