pypcapkit 1.3.5.post6__cp313-none-any.whl
Sign up to get free protection for your applications and to get access to all the features.
- pcapkit/__init__.py +124 -0
- pcapkit/__main__.py +138 -0
- pcapkit/all.py +136 -0
- pcapkit/const/__init__.py +81 -0
- pcapkit/const/arp/__init__.py +25 -0
- pcapkit/const/arp/hardware.py +181 -0
- pcapkit/const/arp/operation.py +131 -0
- pcapkit/const/ftp/__init__.py +25 -0
- pcapkit/const/ftp/command.py +309 -0
- pcapkit/const/ftp/return_code.py +304 -0
- pcapkit/const/hip/__init__.py +94 -0
- pcapkit/const/hip/certificate.py +77 -0
- pcapkit/const/hip/cipher.py +65 -0
- pcapkit/const/hip/di.py +59 -0
- pcapkit/const/hip/ecdsa_curve.py +59 -0
- pcapkit/const/hip/ecdsa_low_curve.py +56 -0
- pcapkit/const/hip/eddsa_curve.py +65 -0
- pcapkit/const/hip/esp_transform_suite.py +98 -0
- pcapkit/const/hip/group.py +86 -0
- pcapkit/const/hip/hi_algorithm.py +86 -0
- pcapkit/const/hip/hit_suite.py +68 -0
- pcapkit/const/hip/nat_traversal.py +62 -0
- pcapkit/const/hip/notify_message.py +200 -0
- pcapkit/const/hip/packet.py +89 -0
- pcapkit/const/hip/parameter.py +377 -0
- pcapkit/const/hip/registration.py +68 -0
- pcapkit/const/hip/registration_failure.py +84 -0
- pcapkit/const/hip/suite.py +71 -0
- pcapkit/const/hip/transport.py +59 -0
- pcapkit/const/http/__init__.py +39 -0
- pcapkit/const/http/error_code.py +95 -0
- pcapkit/const/http/frame.py +95 -0
- pcapkit/const/http/method.py +184 -0
- pcapkit/const/http/setting.py +96 -0
- pcapkit/const/http/status_code.py +298 -0
- pcapkit/const/ipv4/__init__.py +57 -0
- pcapkit/const/ipv4/classification_level.py +64 -0
- pcapkit/const/ipv4/option_class.py +55 -0
- pcapkit/const/ipv4/option_number.py +137 -0
- pcapkit/const/ipv4/protection_authority.py +63 -0
- pcapkit/const/ipv4/qs_function.py +51 -0
- pcapkit/const/ipv4/router_alert.py +251 -0
- pcapkit/const/ipv4/tos_del.py +51 -0
- pcapkit/const/ipv4/tos_ecn.py +55 -0
- pcapkit/const/ipv4/tos_pre.py +63 -0
- pcapkit/const/ipv4/tos_rel.py +51 -0
- pcapkit/const/ipv4/tos_thr.py +51 -0
- pcapkit/const/ipv4/ts_flag.py +53 -0
- pcapkit/const/ipv6/__init__.py +53 -0
- pcapkit/const/ipv6/extension_header.py +69 -0
- pcapkit/const/ipv6/option.py +137 -0
- pcapkit/const/ipv6/option_action.py +55 -0
- pcapkit/const/ipv6/qs_function.py +51 -0
- pcapkit/const/ipv6/router_alert.py +266 -0
- pcapkit/const/ipv6/routing.py +80 -0
- pcapkit/const/ipv6/seed_id.py +55 -0
- pcapkit/const/ipv6/smf_dpd_mode.py +51 -0
- pcapkit/const/ipv6/tagger_id.py +62 -0
- pcapkit/const/ipx/__init__.py +27 -0
- pcapkit/const/ipx/packet.py +72 -0
- pcapkit/const/ipx/socket.py +104 -0
- pcapkit/const/l2tp/__init__.py +21 -0
- pcapkit/const/l2tp/type.py +51 -0
- pcapkit/const/mh/__init__.py +204 -0
- pcapkit/const/mh/access_type.py +92 -0
- pcapkit/const/mh/ack_status_code.py +71 -0
- pcapkit/const/mh/ani_suboption.py +74 -0
- pcapkit/const/mh/auth_subtype.py +53 -0
- pcapkit/const/mh/binding_ack_flag.py +66 -0
- pcapkit/const/mh/binding_error.py +51 -0
- pcapkit/const/mh/binding_revocation.py +59 -0
- pcapkit/const/mh/binding_update_flag.py +81 -0
- pcapkit/const/mh/cga_extension.py +66 -0
- pcapkit/const/mh/cga_sec.py +57 -0
- pcapkit/const/mh/cga_type.py +68 -0
- pcapkit/const/mh/dhcp_support_mode.py +53 -0
- pcapkit/const/mh/dns_status_code.py +65 -0
- pcapkit/const/mh/dsmip6_tls_packet.py +62 -0
- pcapkit/const/mh/dsmipv6_home_address.py +74 -0
- pcapkit/const/mh/enumerating_algorithm.py +56 -0
- pcapkit/const/mh/fb_ack_status.py +62 -0
- pcapkit/const/mh/fb_action.py +71 -0
- pcapkit/const/mh/fb_indication_trigger.py +65 -0
- pcapkit/const/mh/fb_type.py +59 -0
- pcapkit/const/mh/flow_id_status.py +77 -0
- pcapkit/const/mh/flow_id_suboption.py +71 -0
- pcapkit/const/mh/handoff_type.py +71 -0
- pcapkit/const/mh/handover_ack_flag.py +54 -0
- pcapkit/const/mh/handover_ack_status.py +92 -0
- pcapkit/const/mh/handover_initiate_flag.py +57 -0
- pcapkit/const/mh/handover_initiate_status.py +62 -0
- pcapkit/const/mh/home_address_reply.py +71 -0
- pcapkit/const/mh/lla_code.py +63 -0
- pcapkit/const/mh/lma_mag_suboption.py +59 -0
- pcapkit/const/mh/mn_group_id.py +59 -0
- pcapkit/const/mh/mn_id_subtype.py +77 -0
- pcapkit/const/mh/operator_id.py +63 -0
- pcapkit/const/mh/option.py +260 -0
- pcapkit/const/mh/packet.py +119 -0
- pcapkit/const/mh/qos_attribute.py +89 -0
- pcapkit/const/mh/revocation_status_code.py +83 -0
- pcapkit/const/mh/revocation_trigger.py +86 -0
- pcapkit/const/mh/status_code.py +232 -0
- pcapkit/const/mh/traffic_selector.py +62 -0
- pcapkit/const/mh/upa_status.py +71 -0
- pcapkit/const/mh/upn_reason.py +80 -0
- pcapkit/const/ospf/__init__.py +27 -0
- pcapkit/const/ospf/authentication.py +65 -0
- pcapkit/const/ospf/packet.py +71 -0
- pcapkit/const/pcapng/__init__.py +51 -0
- pcapkit/const/pcapng/block_type.py +152 -0
- pcapkit/const/pcapng/filter_type.py +48 -0
- pcapkit/const/pcapng/hash_algorithm.py +59 -0
- pcapkit/const/pcapng/option_type.py +233 -0
- pcapkit/const/pcapng/record_type.py +57 -0
- pcapkit/const/pcapng/secrets_type.py +56 -0
- pcapkit/const/pcapng/verdict_type.py +53 -0
- pcapkit/const/reg/__init__.py +34 -0
- pcapkit/const/reg/apptype.py +32728 -0
- pcapkit/const/reg/ethertype.py +714 -0
- pcapkit/const/reg/linktype.py +890 -0
- pcapkit/const/reg/transtype.py +526 -0
- pcapkit/const/tcp/__init__.py +35 -0
- pcapkit/const/tcp/checksum.py +55 -0
- pcapkit/const/tcp/flags.py +73 -0
- pcapkit/const/tcp/mp_tcp_option.py +80 -0
- pcapkit/const/tcp/option.py +198 -0
- pcapkit/const/vlan/__init__.py +23 -0
- pcapkit/const/vlan/priority_level.py +71 -0
- pcapkit/corekit/__init__.py +59 -0
- pcapkit/corekit/fields/__init__.py +45 -0
- pcapkit/corekit/fields/collections.py +282 -0
- pcapkit/corekit/fields/field.py +269 -0
- pcapkit/corekit/fields/ipaddress.py +274 -0
- pcapkit/corekit/fields/misc.py +722 -0
- pcapkit/corekit/fields/numbers.py +375 -0
- pcapkit/corekit/fields/strings.py +245 -0
- pcapkit/corekit/infoclass.py +394 -0
- pcapkit/corekit/io.py +506 -0
- pcapkit/corekit/module.py +39 -0
- pcapkit/corekit/multidict.py +626 -0
- pcapkit/corekit/protochain.py +263 -0
- pcapkit/corekit/version.py +33 -0
- pcapkit/dumpkit/__init__.py +15 -0
- pcapkit/dumpkit/common.py +199 -0
- pcapkit/dumpkit/null.py +77 -0
- pcapkit/dumpkit/pcap.py +144 -0
- pcapkit/foundation/__init__.py +45 -0
- pcapkit/foundation/engines/__init__.py +36 -0
- pcapkit/foundation/engines/dpkt.py +230 -0
- pcapkit/foundation/engines/engine.py +194 -0
- pcapkit/foundation/engines/pcap.py +188 -0
- pcapkit/foundation/engines/pcapng.py +310 -0
- pcapkit/foundation/engines/pyshark.py +166 -0
- pcapkit/foundation/engines/scapy.py +161 -0
- pcapkit/foundation/extraction.py +915 -0
- pcapkit/foundation/reassembly/__init__.py +49 -0
- pcapkit/foundation/reassembly/data/__init__.py +48 -0
- pcapkit/foundation/reassembly/data/ip.py +117 -0
- pcapkit/foundation/reassembly/data/tcp.py +145 -0
- pcapkit/foundation/reassembly/ip.py +192 -0
- pcapkit/foundation/reassembly/ipv4.py +50 -0
- pcapkit/foundation/reassembly/ipv6.py +50 -0
- pcapkit/foundation/reassembly/reassembly.py +389 -0
- pcapkit/foundation/reassembly/tcp.py +249 -0
- pcapkit/foundation/registry/__init__.py +41 -0
- pcapkit/foundation/registry/foundation.py +327 -0
- pcapkit/foundation/registry/protocols.py +885 -0
- pcapkit/foundation/traceflow/__init__.py +44 -0
- pcapkit/foundation/traceflow/data/__init__.py +30 -0
- pcapkit/foundation/traceflow/data/tcp.py +105 -0
- pcapkit/foundation/traceflow/tcp.py +159 -0
- pcapkit/foundation/traceflow/traceflow.py +390 -0
- pcapkit/interface/__init__.py +22 -0
- pcapkit/interface/core.py +185 -0
- pcapkit/interface/misc.py +120 -0
- pcapkit/protocols/__init__.py +85 -0
- pcapkit/protocols/application/NotImplemented/bgp.py +0 -0
- pcapkit/protocols/application/NotImplemented/dhcp.py +0 -0
- pcapkit/protocols/application/NotImplemented/dhcpv6.py +0 -0
- pcapkit/protocols/application/NotImplemented/dns.py +0 -0
- pcapkit/protocols/application/NotImplemented/imap.py +0 -0
- pcapkit/protocols/application/NotImplemented/ldap.py +0 -0
- pcapkit/protocols/application/NotImplemented/mqtt.py +0 -0
- pcapkit/protocols/application/NotImplemented/nntp.py +0 -0
- pcapkit/protocols/application/NotImplemented/ntp.py +0 -0
- pcapkit/protocols/application/NotImplemented/onc_rpc.py +0 -0
- pcapkit/protocols/application/NotImplemented/pop.py +0 -0
- pcapkit/protocols/application/NotImplemented/rip.py +0 -0
- pcapkit/protocols/application/NotImplemented/rtp.py +0 -0
- pcapkit/protocols/application/NotImplemented/sip.py +0 -0
- pcapkit/protocols/application/NotImplemented/smtp.py +0 -0
- pcapkit/protocols/application/NotImplemented/snmp.py +0 -0
- pcapkit/protocols/application/NotImplemented/ssh.py +0 -0
- pcapkit/protocols/application/NotImplemented/telnet.py +0 -0
- pcapkit/protocols/application/NotImplemented/tls.py +0 -0
- pcapkit/protocols/application/NotImplemented/xmpp.py +0 -0
- pcapkit/protocols/application/__init__.py +34 -0
- pcapkit/protocols/application/application.py +114 -0
- pcapkit/protocols/application/ftp.py +206 -0
- pcapkit/protocols/application/http.py +176 -0
- pcapkit/protocols/application/httpv1.py +320 -0
- pcapkit/protocols/application/httpv2.py +1255 -0
- pcapkit/protocols/data/__init__.py +192 -0
- pcapkit/protocols/data/application/__init__.py +57 -0
- pcapkit/protocols/data/application/ftp.py +59 -0
- pcapkit/protocols/data/application/httpv1.py +79 -0
- pcapkit/protocols/data/application/httpv2.py +293 -0
- pcapkit/protocols/data/data.py +25 -0
- pcapkit/protocols/data/internet/__init__.py +298 -0
- pcapkit/protocols/data/internet/ah.py +31 -0
- pcapkit/protocols/data/internet/hip.py +804 -0
- pcapkit/protocols/data/internet/hopopt.py +351 -0
- pcapkit/protocols/data/internet/ipv4.py +369 -0
- pcapkit/protocols/data/internet/ipv6.py +67 -0
- pcapkit/protocols/data/internet/ipv6_frag.py +29 -0
- pcapkit/protocols/data/internet/ipv6_opts.py +368 -0
- pcapkit/protocols/data/internet/ipv6_route.py +86 -0
- pcapkit/protocols/data/internet/ipx.py +56 -0
- pcapkit/protocols/data/internet/mh.py +509 -0
- pcapkit/protocols/data/link/__init__.py +33 -0
- pcapkit/protocols/data/link/arp.py +74 -0
- pcapkit/protocols/data/link/ethernet.py +28 -0
- pcapkit/protocols/data/link/l2tp.py +63 -0
- pcapkit/protocols/data/link/ospf.py +58 -0
- pcapkit/protocols/data/link/vlan.py +42 -0
- pcapkit/protocols/data/misc/__init__.py +109 -0
- pcapkit/protocols/data/misc/null.py +18 -0
- pcapkit/protocols/data/misc/pcap/__init__.py +18 -0
- pcapkit/protocols/data/misc/pcap/frame.py +56 -0
- pcapkit/protocols/data/misc/pcap/header.py +53 -0
- pcapkit/protocols/data/misc/pcapng.py +925 -0
- pcapkit/protocols/data/misc/raw.py +25 -0
- pcapkit/protocols/data/protocol.py +32 -0
- pcapkit/protocols/data/transport/__init__.py +71 -0
- pcapkit/protocols/data/transport/tcp.py +555 -0
- pcapkit/protocols/data/transport/udp.py +29 -0
- pcapkit/protocols/internet/NotImplemented/ecn.py +0 -0
- pcapkit/protocols/internet/NotImplemented/esp.py +97 -0
- pcapkit/protocols/internet/NotImplemented/icmp.py +0 -0
- pcapkit/protocols/internet/NotImplemented/icmpv6.py +0 -0
- pcapkit/protocols/internet/NotImplemented/igmp.py +0 -0
- pcapkit/protocols/internet/NotImplemented/shim6.py +0 -0
- pcapkit/protocols/internet/__init__.py +43 -0
- pcapkit/protocols/internet/ah.py +275 -0
- pcapkit/protocols/internet/hip.py +4727 -0
- pcapkit/protocols/internet/hopopt.py +1879 -0
- pcapkit/protocols/internet/internet.py +249 -0
- pcapkit/protocols/internet/ip.py +51 -0
- pcapkit/protocols/internet/ipsec.py +50 -0
- pcapkit/protocols/internet/ipv4.py +1782 -0
- pcapkit/protocols/internet/ipv6.py +412 -0
- pcapkit/protocols/internet/ipv6_frag.py +258 -0
- pcapkit/protocols/internet/ipv6_opts.py +1890 -0
- pcapkit/protocols/internet/ipv6_route.py +708 -0
- pcapkit/protocols/internet/ipx.py +230 -0
- pcapkit/protocols/internet/mh.py +2764 -0
- pcapkit/protocols/link/NotImplemented/dsl.py +0 -0
- pcapkit/protocols/link/NotImplemented/eapol.py +1 -0
- pcapkit/protocols/link/NotImplemented/fddi.py +0 -0
- pcapkit/protocols/link/NotImplemented/isdn.py +0 -0
- pcapkit/protocols/link/NotImplemented/ndp.py +0 -0
- pcapkit/protocols/link/NotImplemented/ppp.py +0 -0
- pcapkit/protocols/link/__init__.py +35 -0
- pcapkit/protocols/link/arp.py +421 -0
- pcapkit/protocols/link/ethernet.py +248 -0
- pcapkit/protocols/link/l2tp.py +267 -0
- pcapkit/protocols/link/link.py +140 -0
- pcapkit/protocols/link/ospf.py +342 -0
- pcapkit/protocols/link/rarp.py +82 -0
- pcapkit/protocols/link/vlan.py +225 -0
- pcapkit/protocols/misc/__init__.py +37 -0
- pcapkit/protocols/misc/null.py +129 -0
- pcapkit/protocols/misc/pcap/__init__.py +17 -0
- pcapkit/protocols/misc/pcap/frame.py +478 -0
- pcapkit/protocols/misc/pcap/header.py +358 -0
- pcapkit/protocols/misc/pcapng.py +5520 -0
- pcapkit/protocols/misc/raw.py +180 -0
- pcapkit/protocols/protocol.py +1216 -0
- pcapkit/protocols/schema/__init__.py +140 -0
- pcapkit/protocols/schema/application/__init__.py +40 -0
- pcapkit/protocols/schema/application/ftp.py +21 -0
- pcapkit/protocols/schema/application/httpv1.py +21 -0
- pcapkit/protocols/schema/application/httpv2.py +384 -0
- pcapkit/protocols/schema/internet/__init__.py +294 -0
- pcapkit/protocols/schema/internet/ah.py +40 -0
- pcapkit/protocols/schema/internet/hip.py +1184 -0
- pcapkit/protocols/schema/internet/hopopt.py +679 -0
- pcapkit/protocols/schema/internet/ipv4.py +576 -0
- pcapkit/protocols/schema/internet/ipv6.py +63 -0
- pcapkit/protocols/schema/internet/ipv6_frag.py +48 -0
- pcapkit/protocols/schema/internet/ipv6_opts.py +680 -0
- pcapkit/protocols/schema/internet/ipv6_route.py +197 -0
- pcapkit/protocols/schema/internet/ipx.py +40 -0
- pcapkit/protocols/schema/internet/mh.py +718 -0
- pcapkit/protocols/schema/link/__init__.py +19 -0
- pcapkit/protocols/schema/link/arp.py +39 -0
- pcapkit/protocols/schema/link/ethernet.py +51 -0
- pcapkit/protocols/schema/link/l2tp.py +88 -0
- pcapkit/protocols/schema/link/ospf.py +90 -0
- pcapkit/protocols/schema/link/vlan.py +69 -0
- pcapkit/protocols/schema/misc/__init__.py +108 -0
- pcapkit/protocols/schema/misc/null.py +18 -0
- pcapkit/protocols/schema/misc/pcap/__init__.py +10 -0
- pcapkit/protocols/schema/misc/pcap/frame.py +51 -0
- pcapkit/protocols/schema/misc/pcap/header.py +63 -0
- pcapkit/protocols/schema/misc/pcapng.py +1689 -0
- pcapkit/protocols/schema/misc/raw.py +24 -0
- pcapkit/protocols/schema/schema.py +809 -0
- pcapkit/protocols/schema/transport/__init__.py +69 -0
- pcapkit/protocols/schema/transport/tcp.py +928 -0
- pcapkit/protocols/schema/transport/udp.py +90 -0
- pcapkit/protocols/transport/NotImplemented/dccp.py +0 -0
- pcapkit/protocols/transport/NotImplemented/rsvp.py +0 -0
- pcapkit/protocols/transport/NotImplemented/sctp.py +0 -0
- pcapkit/protocols/transport/__init__.py +27 -0
- pcapkit/protocols/transport/tcp.py +3025 -0
- pcapkit/protocols/transport/transport.py +158 -0
- pcapkit/protocols/transport/udp.py +214 -0
- pcapkit/py.typed +0 -0
- pcapkit/toolkit/__init__.py +57 -0
- pcapkit/toolkit/dpkt.py +306 -0
- pcapkit/toolkit/pcap.py +212 -0
- pcapkit/toolkit/pcapng.py +251 -0
- pcapkit/toolkit/pyshark.py +99 -0
- pcapkit/toolkit/scapy.py +297 -0
- pcapkit/utilities/__init__.py +20 -0
- pcapkit/utilities/compat.py +196 -0
- pcapkit/utilities/decorators.py +197 -0
- pcapkit/utilities/exceptions.py +365 -0
- pcapkit/utilities/logging.py +55 -0
- pcapkit/utilities/warnings.py +185 -0
- pcapkit/vendor/__init__.py +105 -0
- pcapkit/vendor/__main__.py +92 -0
- pcapkit/vendor/arp/__init__.py +27 -0
- pcapkit/vendor/arp/hardware.py +29 -0
- pcapkit/vendor/arp/operation.py +29 -0
- pcapkit/vendor/default.py +474 -0
- pcapkit/vendor/ftp/__init__.py +27 -0
- pcapkit/vendor/ftp/command.py +244 -0
- pcapkit/vendor/ftp/return_code.py +256 -0
- pcapkit/vendor/hip/__init__.py +94 -0
- pcapkit/vendor/hip/certificate.py +29 -0
- pcapkit/vendor/hip/cipher.py +29 -0
- pcapkit/vendor/hip/di.py +29 -0
- pcapkit/vendor/hip/ecdsa_curve.py +29 -0
- pcapkit/vendor/hip/ecdsa_low_curve.py +29 -0
- pcapkit/vendor/hip/eddsa_curve.py +85 -0
- pcapkit/vendor/hip/esp_transform_suite.py +29 -0
- pcapkit/vendor/hip/group.py +87 -0
- pcapkit/vendor/hip/hi_algorithm.py +29 -0
- pcapkit/vendor/hip/hit_suite.py +29 -0
- pcapkit/vendor/hip/nat_traversal.py +29 -0
- pcapkit/vendor/hip/notify_message.py +29 -0
- pcapkit/vendor/hip/packet.py +88 -0
- pcapkit/vendor/hip/parameter.py +88 -0
- pcapkit/vendor/hip/registration.py +29 -0
- pcapkit/vendor/hip/registration_failure.py +29 -0
- pcapkit/vendor/hip/suite.py +29 -0
- pcapkit/vendor/hip/transport.py +29 -0
- pcapkit/vendor/http/__init__.py +39 -0
- pcapkit/vendor/http/error_code.py +95 -0
- pcapkit/vendor/http/frame.py +91 -0
- pcapkit/vendor/http/method.py +167 -0
- pcapkit/vendor/http/setting.py +93 -0
- pcapkit/vendor/http/status_code.py +185 -0
- pcapkit/vendor/ipv4/__init__.py +57 -0
- pcapkit/vendor/ipv4/classification_level.py +91 -0
- pcapkit/vendor/ipv4/option_class.py +80 -0
- pcapkit/vendor/ipv4/option_number.py +105 -0
- pcapkit/vendor/ipv4/protection_authority.py +84 -0
- pcapkit/vendor/ipv4/qs_function.py +78 -0
- pcapkit/vendor/ipv4/router_alert.py +93 -0
- pcapkit/vendor/ipv4/tos_del.py +78 -0
- pcapkit/vendor/ipv4/tos_ecn.py +95 -0
- pcapkit/vendor/ipv4/tos_pre.py +84 -0
- pcapkit/vendor/ipv4/tos_rel.py +78 -0
- pcapkit/vendor/ipv4/tos_thr.py +77 -0
- pcapkit/vendor/ipv4/ts_flag.py +79 -0
- pcapkit/vendor/ipv6/__init__.py +53 -0
- pcapkit/vendor/ipv6/extension_header.py +171 -0
- pcapkit/vendor/ipv6/option.py +104 -0
- pcapkit/vendor/ipv6/option_action.py +90 -0
- pcapkit/vendor/ipv6/qs_function.py +78 -0
- pcapkit/vendor/ipv6/router_alert.py +93 -0
- pcapkit/vendor/ipv6/routing.py +87 -0
- pcapkit/vendor/ipv6/seed_id.py +81 -0
- pcapkit/vendor/ipv6/smf_dpd_mode.py +78 -0
- pcapkit/vendor/ipv6/tagger_id.py +81 -0
- pcapkit/vendor/ipx/__init__.py +37 -0
- pcapkit/vendor/ipx/packet.py +123 -0
- pcapkit/vendor/ipx/socket.py +125 -0
- pcapkit/vendor/l2tp/__init__.py +21 -0
- pcapkit/vendor/l2tp/type.py +78 -0
- pcapkit/vendor/mh/__init__.py +204 -0
- pcapkit/vendor/mh/access_type.py +87 -0
- pcapkit/vendor/mh/ack_status_code.py +88 -0
- pcapkit/vendor/mh/ani_suboption.py +88 -0
- pcapkit/vendor/mh/auth_subtype.py +83 -0
- pcapkit/vendor/mh/binding_ack_flag.py +148 -0
- pcapkit/vendor/mh/binding_error.py +78 -0
- pcapkit/vendor/mh/binding_revocation.py +87 -0
- pcapkit/vendor/mh/binding_update_flag.py +147 -0
- pcapkit/vendor/mh/cga_extension.py +91 -0
- pcapkit/vendor/mh/cga_sec.py +91 -0
- pcapkit/vendor/mh/cga_type.py +74 -0
- pcapkit/vendor/mh/dhcp_support_mode.py +77 -0
- pcapkit/vendor/mh/dns_status_code.py +87 -0
- pcapkit/vendor/mh/dsmip6_tls_packet.py +87 -0
- pcapkit/vendor/mh/dsmipv6_home_address.py +87 -0
- pcapkit/vendor/mh/enumerating_algorithm.py +82 -0
- pcapkit/vendor/mh/fb_ack_status.py +87 -0
- pcapkit/vendor/mh/fb_action.py +88 -0
- pcapkit/vendor/mh/fb_indication_trigger.py +87 -0
- pcapkit/vendor/mh/fb_type.py +88 -0
- pcapkit/vendor/mh/flow_id_status.py +87 -0
- pcapkit/vendor/mh/flow_id_suboption.py +87 -0
- pcapkit/vendor/mh/handoff_type.py +87 -0
- pcapkit/vendor/mh/handover_ack_flag.py +143 -0
- pcapkit/vendor/mh/handover_ack_status.py +87 -0
- pcapkit/vendor/mh/handover_initiate_flag.py +143 -0
- pcapkit/vendor/mh/handover_initiate_status.py +87 -0
- pcapkit/vendor/mh/home_address_reply.py +87 -0
- pcapkit/vendor/mh/lla_code.py +97 -0
- pcapkit/vendor/mh/lma_mag_suboption.py +88 -0
- pcapkit/vendor/mh/mn_group_id.py +87 -0
- pcapkit/vendor/mh/mn_id_subtype.py +87 -0
- pcapkit/vendor/mh/operator_id.py +87 -0
- pcapkit/vendor/mh/option.py +83 -0
- pcapkit/vendor/mh/packet.py +82 -0
- pcapkit/vendor/mh/qos_attribute.py +87 -0
- pcapkit/vendor/mh/revocation_status_code.py +87 -0
- pcapkit/vendor/mh/revocation_trigger.py +87 -0
- pcapkit/vendor/mh/status_code.py +91 -0
- pcapkit/vendor/mh/traffic_selector.py +87 -0
- pcapkit/vendor/mh/upa_status.py +87 -0
- pcapkit/vendor/mh/upn_reason.py +87 -0
- pcapkit/vendor/ospf/__init__.py +27 -0
- pcapkit/vendor/ospf/authentication.py +29 -0
- pcapkit/vendor/ospf/packet.py +29 -0
- pcapkit/vendor/pcapng/__init__.py +51 -0
- pcapkit/vendor/pcapng/block_type.py +94 -0
- pcapkit/vendor/pcapng/filter_type.py +77 -0
- pcapkit/vendor/pcapng/hash_algorithm.py +82 -0
- pcapkit/vendor/pcapng/option_type.py +287 -0
- pcapkit/vendor/pcapng/record_type.py +81 -0
- pcapkit/vendor/pcapng/secrets_type.py +81 -0
- pcapkit/vendor/pcapng/verdict_type.py +79 -0
- pcapkit/vendor/reg/__init__.py +34 -0
- pcapkit/vendor/reg/apptype.py +338 -0
- pcapkit/vendor/reg/ethertype.py +121 -0
- pcapkit/vendor/reg/linktype.py +110 -0
- pcapkit/vendor/reg/transtype.py +111 -0
- pcapkit/vendor/tcp/__init__.py +35 -0
- pcapkit/vendor/tcp/checksum.py +80 -0
- pcapkit/vendor/tcp/flags.py +149 -0
- pcapkit/vendor/tcp/mp_tcp_option.py +90 -0
- pcapkit/vendor/tcp/option.py +103 -0
- pcapkit/vendor/vlan/__init__.py +23 -0
- pcapkit/vendor/vlan/priority_level.py +97 -0
- pypcapkit-1.3.5.post6.dist-info/LICENSE +29 -0
- pypcapkit-1.3.5.post6.dist-info/METADATA +238 -0
- pypcapkit-1.3.5.post6.dist-info/RECORD +466 -0
- pypcapkit-1.3.5.post6.dist-info/WHEEL +5 -0
- pypcapkit-1.3.5.post6.dist-info/entry_points.txt +3 -0
- pypcapkit-1.3.5.post6.dist-info/top_level.txt +1 -0
@@ -0,0 +1,708 @@
|
|
1
|
+
# -*- coding: utf-8 -*-
|
2
|
+
"""IPv6-Route - Routing Header for IPv6
|
3
|
+
==========================================
|
4
|
+
|
5
|
+
.. module:: pcapkit.protocols.internet.ipv6_route
|
6
|
+
|
7
|
+
:mod:`pcapkit.protocols.internet.ipv6_route` contains
|
8
|
+
:class:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route`
|
9
|
+
only, which implements extractor for Routing Header for IPv6
|
10
|
+
(IPv6-Route) [*]_, whose structure is described as below:
|
11
|
+
|
12
|
+
======= ========= ==================== ===============================
|
13
|
+
Octets Bits Name Description
|
14
|
+
======= ========= ==================== ===============================
|
15
|
+
0 0 ``route.next`` Next Header
|
16
|
+
1 8 ``route.length`` Header Extensive Length
|
17
|
+
2 16 ``route.type`` Routing Type
|
18
|
+
3 24 ``route.seg_left`` Segments Left
|
19
|
+
4 32 ``route.data`` Type-Specific Data
|
20
|
+
======= ========= ==================== ===============================
|
21
|
+
|
22
|
+
.. [*] https://en.wikipedia.org/wiki/IPv6_packet#Routing
|
23
|
+
|
24
|
+
"""
|
25
|
+
import collections
|
26
|
+
import ipaddress
|
27
|
+
import math
|
28
|
+
import os.path as os_path
|
29
|
+
from typing import TYPE_CHECKING, cast, overload
|
30
|
+
|
31
|
+
from pcapkit.const.ipv6.routing import Routing as Enum_Routing
|
32
|
+
from pcapkit.const.reg.transtype import TransType as Enum_TransType
|
33
|
+
from pcapkit.protocols.data.internet.ipv6_route import RPL as Data_RPL
|
34
|
+
from pcapkit.protocols.data.internet.ipv6_route import IPv6_Route as Data_IPv6_Route
|
35
|
+
from pcapkit.protocols.data.internet.ipv6_route import SourceRoute as Data_SourceRoute
|
36
|
+
from pcapkit.protocols.data.internet.ipv6_route import Type2 as Data_Type2
|
37
|
+
from pcapkit.protocols.data.internet.ipv6_route import UnknownType as Data_UnknownType
|
38
|
+
from pcapkit.protocols.internet.internet import Internet
|
39
|
+
from pcapkit.protocols.schema.internet.ipv6_route import RPL as Schema_RPL
|
40
|
+
from pcapkit.protocols.schema.internet.ipv6_route import IPv6_Route as Schema_IPv6_Route
|
41
|
+
from pcapkit.protocols.schema.internet.ipv6_route import SourceRoute as Schema_SourceRoute
|
42
|
+
from pcapkit.protocols.schema.internet.ipv6_route import Type2 as Schema_Type2
|
43
|
+
from pcapkit.protocols.schema.internet.ipv6_route import UnknownType as Schema_UnknownType
|
44
|
+
from pcapkit.protocols.schema.schema import Schema
|
45
|
+
from pcapkit.utilities.exceptions import ProtocolError, UnsupportedCall
|
46
|
+
from pcapkit.utilities.warnings import RegistryWarning, warn
|
47
|
+
|
48
|
+
if TYPE_CHECKING:
|
49
|
+
from enum import IntEnum as StdlibEnum
|
50
|
+
from ipaddress import IPv6Address
|
51
|
+
from typing import IO, Any, Callable, DefaultDict, Optional, Type
|
52
|
+
|
53
|
+
from aenum import IntEnum as AenumEnum
|
54
|
+
from mypy_extensions import DefaultArg, KwArg, NamedArg
|
55
|
+
from typing_extensions import Literal
|
56
|
+
|
57
|
+
from pcapkit.protocols.schema.internet.ipv6_route import RoutingType as Schema_RoutingType
|
58
|
+
|
59
|
+
TypeParser = Callable[[Schema_RoutingType, NamedArg(Schema_IPv6_Route, 'header')], Data_IPv6_Route]
|
60
|
+
TypeConstructor = Callable[[Enum_Routing, DefaultArg(Optional[Data_IPv6_Route]),
|
61
|
+
NamedArg(Optional[IPv6Address], 'dst'), KwArg(Any)], Schema_RoutingType]
|
62
|
+
|
63
|
+
__all__ = ['IPv6_Route']
|
64
|
+
|
65
|
+
|
66
|
+
class IPv6_Route(Internet[Data_IPv6_Route, Schema_IPv6_Route],
|
67
|
+
schema=Schema_IPv6_Route, data=Data_IPv6_Route):
|
68
|
+
"""This class implements Routing Header for IPv6.
|
69
|
+
|
70
|
+
This class currently supports parsing of the following Routing Header for IPv6
|
71
|
+
routing data types, which are registered in the
|
72
|
+
:attr:`self.__routing__ <pcapkit.protocols.internet.ipv6_route.IPv6_Route.__routing__>`
|
73
|
+
attribute:
|
74
|
+
|
75
|
+
.. list-table::
|
76
|
+
:header-rows: 1
|
77
|
+
|
78
|
+
* - Routing Code
|
79
|
+
- Data Parser
|
80
|
+
- Data Constructor
|
81
|
+
* - :attr:`~pcapkit.const.ipv6.routing.Routing.Source_Route`
|
82
|
+
- :meth:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route._read_data_type_src`
|
83
|
+
- :meth:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route._make_data_type_src`
|
84
|
+
* - :attr:`~pcapkit.const.ipv6.routing.Routing.Type_2_Routing_Header`
|
85
|
+
- :meth:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route._read_data_type_2`
|
86
|
+
- :meth:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route._make_data_type_2`
|
87
|
+
* - :attr:`~pcapkit.const.ipv6.routing.Routing.RPL_Source_Route_Header`
|
88
|
+
- :meth:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route._read_data_type_rpl`
|
89
|
+
- :meth:`~pcapkit.protocols.internet.ipv6_route.IPv6_Route._make_data_type_rpl`
|
90
|
+
|
91
|
+
"""
|
92
|
+
|
93
|
+
##########################################################################
|
94
|
+
# Defaults.
|
95
|
+
##########################################################################
|
96
|
+
|
97
|
+
#: DefaultDict[Enum_Routing, str | tuple[TypeParser, TypeConstructor]]: Type
|
98
|
+
#: code to method mapping. Method names are expected to be referred to
|
99
|
+
#: the class by ``_read_data_type_${name}`` and/or ``_make_data_type_${name}``,
|
100
|
+
#: and if such name not found, the value should then be a method that can
|
101
|
+
#: parse the routing type by itself.
|
102
|
+
__routing__ = collections.defaultdict(
|
103
|
+
lambda: 'none',
|
104
|
+
{
|
105
|
+
Enum_Routing.Source_Route: 'src', # [RFC 5095] DEPRECATED
|
106
|
+
Enum_Routing.Type_2_Routing_Header: '2', # [RFC 6275]
|
107
|
+
Enum_Routing.RPL_Source_Route_Header: 'rpl', # [RFC 6554]
|
108
|
+
},
|
109
|
+
) # type: DefaultDict[Enum_Routing | int, str | tuple[TypeParser, TypeConstructor]]
|
110
|
+
|
111
|
+
##########################################################################
|
112
|
+
# Properties.
|
113
|
+
##########################################################################
|
114
|
+
|
115
|
+
@property
|
116
|
+
def name(self) -> 'Literal["Routing Header for IPv6"]':
|
117
|
+
"""Name of current protocol."""
|
118
|
+
return 'Routing Header for IPv6'
|
119
|
+
|
120
|
+
@property
|
121
|
+
def alias(self) -> 'Literal["IPv6-Route"]':
|
122
|
+
"""Acronym of corresponding protocol."""
|
123
|
+
return 'IPv6-Route'
|
124
|
+
|
125
|
+
@property
|
126
|
+
def length(self) -> 'int':
|
127
|
+
"""Header length of current protocol."""
|
128
|
+
return self._info.length
|
129
|
+
|
130
|
+
@property
|
131
|
+
def payload(self) -> 'Protocol | NoReturn':
|
132
|
+
"""Payload of current instance.
|
133
|
+
|
134
|
+
Raises:
|
135
|
+
UnsupportedCall: if the protocol is used as an IPv6 extension header
|
136
|
+
|
137
|
+
:rtype: pcapkit.protocols.protocol.Protocol
|
138
|
+
"""
|
139
|
+
if self._extf:
|
140
|
+
raise UnsupportedCall(f"'{self.__class__.__name__}' object has no attribute 'payload'")
|
141
|
+
return self._next
|
142
|
+
|
143
|
+
@property
|
144
|
+
def protocol(self) -> 'Optional[str] | NoReturn':
|
145
|
+
"""Name of next layer protocol (if any).
|
146
|
+
|
147
|
+
Raises:
|
148
|
+
UnsupportedCall: if the protocol is used as an IPv6 extension header
|
149
|
+
|
150
|
+
"""
|
151
|
+
if self._extf:
|
152
|
+
raise UnsupportedCall(f"'{self.__class__.__name__}' object has no attribute 'protocol'")
|
153
|
+
return super().protocol
|
154
|
+
|
155
|
+
@property
|
156
|
+
def protochain(self) -> 'ProtoChain | NoReturn':
|
157
|
+
"""Protocol chain of current instance.
|
158
|
+
|
159
|
+
Raises:
|
160
|
+
UnsupportedCall: if the protocol is used as an IPv6 extension header
|
161
|
+
|
162
|
+
"""
|
163
|
+
if self._extf:
|
164
|
+
raise UnsupportedCall(f"'{self.__class__.__name__}' object has no attribute 'protochain'")
|
165
|
+
return super().protochain
|
166
|
+
|
167
|
+
##########################################################################
|
168
|
+
# Methods.
|
169
|
+
##########################################################################
|
170
|
+
|
171
|
+
def read(self, length: 'Optional[int]' = None, *, extension: 'bool' = False, # pylint: disable=arguments-differ
|
172
|
+
**kwargs: 'Any') -> 'Data_IPv6_Route': # pylint: disable=unused-argument
|
173
|
+
"""Read Routing Header for IPv6.
|
174
|
+
|
175
|
+
Structure of IPv6-Route header [:rfc:`8200`][:rfc:`5095`]:
|
176
|
+
|
177
|
+
.. code-block:: text
|
178
|
+
|
179
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
180
|
+
| Next Header | Hdr Ext Len | Routing Type | Segments Left |
|
181
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
182
|
+
| |
|
183
|
+
. .
|
184
|
+
. type-specific data .
|
185
|
+
. .
|
186
|
+
| |
|
187
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
188
|
+
|
189
|
+
Args:
|
190
|
+
length: Length of packet data.
|
191
|
+
extension: If the packet is used as an IPv6 extension header.
|
192
|
+
**kwargs: Arbitrary keyword arguments.
|
193
|
+
|
194
|
+
Returns:
|
195
|
+
Parsed packet data.
|
196
|
+
|
197
|
+
"""
|
198
|
+
if length is None:
|
199
|
+
length = len(self)
|
200
|
+
schema = self.__header__
|
201
|
+
|
202
|
+
name = self.__routing__[schema.type]
|
203
|
+
if isinstance(name, str):
|
204
|
+
name = f'_read_data_type_{name.lower()}'
|
205
|
+
meth = cast('TypeParser',
|
206
|
+
getattr(self, name, self._read_data_type_none))
|
207
|
+
else:
|
208
|
+
meth = name[0]
|
209
|
+
ipv6_route = meth(schema.data, header=schema)
|
210
|
+
|
211
|
+
if extension:
|
212
|
+
return ipv6_route
|
213
|
+
return self._decode_next_layer(ipv6_route, schema.next, length - ipv6_route.length)
|
214
|
+
|
215
|
+
def make(self,
|
216
|
+
dst: 'Optional[IPv6Address | str | int| bytes]' = None,
|
217
|
+
next: 'Enum_TransType | StdlibEnum | AenumEnum | str | int' = Enum_TransType.UDP,
|
218
|
+
next_default: 'Optional[int]' = None,
|
219
|
+
next_namespace: 'Optional[dict[str, int] | dict[int, str] | Type[StdlibEnum] | Type[AenumEnum]]' = None, # pylint: disable=line-too-long
|
220
|
+
next_reversed: 'bool' = False,
|
221
|
+
type: 'Enum_Routing | StdlibEnum | AenumEnum | str | int' = Enum_Routing.Source_Route,
|
222
|
+
type_default: 'Optional[int]' = None,
|
223
|
+
type_namespace: 'Optional[dict[str, int] | dict[int, str] | Type[StdlibEnum] | Type[AenumEnum]]' = None, # pylint: disable=line-too-long
|
224
|
+
type_reversed: 'bool' = False,
|
225
|
+
seg_left: 'int' = 0,
|
226
|
+
data: 'bytes | Data_IPv6_Route | Schema_RoutingType | dict[str, Any]' = b'\x00\x00\x00\x00',
|
227
|
+
payload: 'Protocol | Schema | bytes' = b'',
|
228
|
+
**kwargs: 'Any') -> 'Schema_IPv6_Route':
|
229
|
+
"""Make (construct) packet data.
|
230
|
+
|
231
|
+
Args:
|
232
|
+
dst: Destination address.
|
233
|
+
next: Next header type.
|
234
|
+
next_default: Default value of next header type.
|
235
|
+
next_namespace: Namespace of next header type.
|
236
|
+
next_reversed: If the namespace of next header type is reversed.
|
237
|
+
type: Routing type.
|
238
|
+
type_default: Default value of routing type.
|
239
|
+
type_namespace: Namespace of routing type.
|
240
|
+
type_reversed: If the namespace of routing type is reversed.
|
241
|
+
seg_left: Segments left.
|
242
|
+
data: Routing data.
|
243
|
+
payload: Payload of current instance.
|
244
|
+
**kwargs: Arbitrary keyword arguments.
|
245
|
+
|
246
|
+
Returns:
|
247
|
+
Constructed packet data.
|
248
|
+
|
249
|
+
"""
|
250
|
+
next_val = cast('Enum_TransType',
|
251
|
+
self._make_index(next, next_default, namespace=next_namespace,
|
252
|
+
reversed=next_reversed, pack=False))
|
253
|
+
type_val = cast('Enum_Routing',
|
254
|
+
self._make_index(type, type_default, namespace=type_namespace,
|
255
|
+
reversed=type_reversed, pack=False))
|
256
|
+
|
257
|
+
if isinstance(data, bytes):
|
258
|
+
length = math.ceil((len(data) + 4) / 8)
|
259
|
+
data_val = data.ljust(length * 8 - 4, b'\x00') # type: bytes | Schema_RoutingType
|
260
|
+
elif isinstance(data, (dict, Data_IPv6_Route)):
|
261
|
+
name = self.__routing__[type_val]
|
262
|
+
if isinstance(name, str):
|
263
|
+
name = f'_make_data_type_{name.lower()}'
|
264
|
+
meth = cast('TypeConstructor',
|
265
|
+
getattr(self, name, self._make_data_type_none))
|
266
|
+
else:
|
267
|
+
meth = name[1]
|
268
|
+
|
269
|
+
dst_val = cast('IPv6Address', ipaddress.ip_address(dst)) if dst is not None else None
|
270
|
+
if isinstance(data, dict):
|
271
|
+
data_val = meth(type_val, dst=dst_val, **data)
|
272
|
+
else:
|
273
|
+
data_val = meth(type_val, data, dst=dst_val)
|
274
|
+
length = len(data_val.pack())
|
275
|
+
elif isinstance(data, Schema):
|
276
|
+
length = math.ceil((len(data.pack()) + 4) / 8)
|
277
|
+
data_val = data
|
278
|
+
else:
|
279
|
+
raise ProtocolError(f'{self.alias}: invalid routing data type: {data.__class__}')
|
280
|
+
|
281
|
+
return Schema_IPv6_Route(
|
282
|
+
next=next_val,
|
283
|
+
length=length,
|
284
|
+
type=type_val,
|
285
|
+
seg_left=seg_left,
|
286
|
+
data=data_val,
|
287
|
+
payload=payload,
|
288
|
+
)
|
289
|
+
|
290
|
+
@classmethod
|
291
|
+
def register_routing(cls, code: 'Enum_Routing', meth: 'str | tuple[TypeParser, TypeConstructor]') -> 'None':
|
292
|
+
"""Register an routing data parser.
|
293
|
+
|
294
|
+
Args:
|
295
|
+
code: IPv6-Route data type code.
|
296
|
+
meth: Method name or callable to parse and/or construct the data.
|
297
|
+
|
298
|
+
"""
|
299
|
+
if code in cls.__routing__:
|
300
|
+
warn(f'routing {code} already registered, overwriting', RegistryWarning)
|
301
|
+
cls.__routing__[code] = meth
|
302
|
+
|
303
|
+
##########################################################################
|
304
|
+
# Data models.
|
305
|
+
##########################################################################
|
306
|
+
|
307
|
+
@overload
|
308
|
+
def __post_init__(self, file: 'IO[bytes] | bytes', length: 'Optional[int]' = ..., *, # pylint: disable=arguments-differ
|
309
|
+
extension: 'bool' = ..., src_ip: 'Optional[IPv6Address]'= ...,
|
310
|
+
dst_ip: 'Optional[IPv6Address]'= ..., **kwargs: 'Any') -> 'None': ...
|
311
|
+
|
312
|
+
@overload
|
313
|
+
def __post_init__(self, **kwargs: 'Any') -> 'None': ... # pylint: disable=arguments-differ
|
314
|
+
|
315
|
+
def __post_init__(self, file: 'Optional[IO[bytes] | bytes]' = None, length: 'Optional[int]' = None, *, # pylint: disable=arguments-differ
|
316
|
+
extension: 'bool' = False, **kwargs: 'Any') -> 'None':
|
317
|
+
"""Post initialisation hook.
|
318
|
+
|
319
|
+
Args:
|
320
|
+
file: Source packet stream.
|
321
|
+
length: Length of packet data.
|
322
|
+
extension: If the protocol is used as an IPv6 extension header.
|
323
|
+
src_ip: source IP address
|
324
|
+
dst_ip: destination IP address
|
325
|
+
**kwargs: Arbitrary keyword arguments.
|
326
|
+
|
327
|
+
See Also:
|
328
|
+
For construction argument, please refer to :meth:`self.make <IPv6_Route.make>`.
|
329
|
+
|
330
|
+
"""
|
331
|
+
#: bool: If the protocol is used as an IPv6 extension header.
|
332
|
+
self._extf = extension
|
333
|
+
|
334
|
+
# call super __post_init__
|
335
|
+
super().__post_init__(file, length, extension=extension, **kwargs) # type: ignore[arg-type]
|
336
|
+
|
337
|
+
def __length_hint__(self) -> 'Literal[4]':
|
338
|
+
"""Return an estimated length for the object."""
|
339
|
+
return 4
|
340
|
+
|
341
|
+
@classmethod
|
342
|
+
def __index__(cls) -> 'Enum_TransType': # pylint: disable=invalid-index-returned
|
343
|
+
"""Numeral registry index of the protocol.
|
344
|
+
|
345
|
+
Returns:
|
346
|
+
Numeral registry index of the protocol in `IANA`_.
|
347
|
+
|
348
|
+
.. _IANA: https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml
|
349
|
+
|
350
|
+
"""
|
351
|
+
return Enum_TransType.IPv6_Route # type: ignore[return-value]
|
352
|
+
|
353
|
+
##########################################################################
|
354
|
+
# Utilities.
|
355
|
+
##########################################################################
|
356
|
+
|
357
|
+
@classmethod
|
358
|
+
def _make_data(cls, data: 'Data_IPv6_Route') -> 'dict[str, Any]': # type: ignore[override]
|
359
|
+
"""Create key-value pairs from ``data`` for protocol construction.
|
360
|
+
|
361
|
+
Args:
|
362
|
+
data: protocol data
|
363
|
+
|
364
|
+
Returns:
|
365
|
+
Key-value pairs for protocol construction.
|
366
|
+
|
367
|
+
"""
|
368
|
+
return {
|
369
|
+
'next': data.next,
|
370
|
+
'type': data.type,
|
371
|
+
'seg_left': data.seg_left,
|
372
|
+
'data': data,
|
373
|
+
'payload': cls._make_payload(data),
|
374
|
+
}
|
375
|
+
|
376
|
+
def _read_data_type_none(self, schema: 'Schema_UnknownType', *, header: 'Schema_IPv6_Route') -> 'Data_UnknownType':
|
377
|
+
"""Read IPv6-Route unknown type data.
|
378
|
+
|
379
|
+
Structure of IPv6-Route unknown type data [:rfc:`8200`][:rfc:`5095`]:
|
380
|
+
|
381
|
+
.. code-block:: text
|
382
|
+
|
383
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
384
|
+
| Next Header | Hdr Ext Len | Routing Type | Segments Left |
|
385
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
386
|
+
| |
|
387
|
+
. .
|
388
|
+
. type-specific data .
|
389
|
+
. .
|
390
|
+
| |
|
391
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
392
|
+
|
393
|
+
Args:
|
394
|
+
schema: parsed routing data schema
|
395
|
+
header: parsed IPv6-Route header schema
|
396
|
+
|
397
|
+
Returns:
|
398
|
+
Parsed route data.
|
399
|
+
|
400
|
+
"""
|
401
|
+
ipv6_route = Data_UnknownType(
|
402
|
+
next=header.next,
|
403
|
+
length=header.length * 8 + 8,
|
404
|
+
type=header.type,
|
405
|
+
seg_left=header.seg_left,
|
406
|
+
data=schema.data,
|
407
|
+
)
|
408
|
+
return ipv6_route
|
409
|
+
|
410
|
+
def _read_data_type_src(self, schema: 'Schema_SourceRoute', *, header: 'Schema_IPv6_Route') -> 'Data_SourceRoute':
|
411
|
+
"""Read IPv6-Route Source Route data.
|
412
|
+
|
413
|
+
Structure of IPv6-Route Source Route data [:rfc:`5095`]:
|
414
|
+
|
415
|
+
.. code-block:: text
|
416
|
+
|
417
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
418
|
+
| Next Header | Hdr Ext Len | Routing Type=0| Segments Left |
|
419
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
420
|
+
| Reserved |
|
421
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
422
|
+
| |
|
423
|
+
+ +
|
424
|
+
| |
|
425
|
+
+ Address[1] +
|
426
|
+
| |
|
427
|
+
+ +
|
428
|
+
| |
|
429
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
430
|
+
| |
|
431
|
+
+ +
|
432
|
+
| |
|
433
|
+
+ Address[2] +
|
434
|
+
| |
|
435
|
+
+ +
|
436
|
+
| |
|
437
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
438
|
+
. . .
|
439
|
+
. . .
|
440
|
+
. . .
|
441
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
442
|
+
| |
|
443
|
+
+ +
|
444
|
+
| |
|
445
|
+
+ Address[n] +
|
446
|
+
| |
|
447
|
+
+ +
|
448
|
+
| |
|
449
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
450
|
+
|
451
|
+
Args:
|
452
|
+
schema: parsed routing data schema
|
453
|
+
header: parsed IPv6-Route header schema
|
454
|
+
|
455
|
+
Returns:
|
456
|
+
Parsed route data.
|
457
|
+
|
458
|
+
"""
|
459
|
+
if (header.length - 8) % 16 != 0:
|
460
|
+
raise ProtocolError(f'{self.alias} [TypeNo {type}]: invalid format')
|
461
|
+
|
462
|
+
ipv6_route = Data_SourceRoute(
|
463
|
+
next=header.next,
|
464
|
+
length=header.length * 8 + 8,
|
465
|
+
type=header.type,
|
466
|
+
seg_left=header.seg_left,
|
467
|
+
ip=tuple(schema.ip),
|
468
|
+
)
|
469
|
+
return ipv6_route
|
470
|
+
|
471
|
+
def _read_data_type_2(self, schema: 'Schema_Type2', *, header: 'Schema_IPv6_Route') -> 'Data_Type2':
|
472
|
+
"""Read IPv6-Route Type 2 data.
|
473
|
+
|
474
|
+
Structure of IPv6-Route Type 2 data [:rfc:`6275`]:
|
475
|
+
|
476
|
+
.. code-block:: text
|
477
|
+
|
478
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
479
|
+
| Next Header | Hdr Ext Len=2 | Routing Type=2|Segments Left=1|
|
480
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
481
|
+
| Reserved |
|
482
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
483
|
+
| |
|
484
|
+
+ +
|
485
|
+
| |
|
486
|
+
+ Home Address +
|
487
|
+
| |
|
488
|
+
+ +
|
489
|
+
| |
|
490
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
491
|
+
|
492
|
+
Args:
|
493
|
+
schema: parsed routing data schema
|
494
|
+
header: parsed IPv6-Route header schema
|
495
|
+
|
496
|
+
Returns:
|
497
|
+
Parsed route data.
|
498
|
+
|
499
|
+
Raises:
|
500
|
+
ProtocolError: If ``length`` is **NOT** ``24``.
|
501
|
+
|
502
|
+
"""
|
503
|
+
if header.length != 24:
|
504
|
+
raise ProtocolError(f'{self.alias}: [TypeNo {type}] invalid format')
|
505
|
+
|
506
|
+
ipv6_route = Data_Type2(
|
507
|
+
next=header.next,
|
508
|
+
length=header.length * 8 + 8,
|
509
|
+
type=header.type,
|
510
|
+
seg_left=header.seg_left,
|
511
|
+
ip=schema.ip,
|
512
|
+
)
|
513
|
+
return ipv6_route
|
514
|
+
|
515
|
+
def _read_data_type_rpl(self, schema: 'Schema_RPL', *, header: 'Schema_IPv6_Route') -> 'Data_RPL':
|
516
|
+
"""Read IPv6-Route RPL Source data.
|
517
|
+
|
518
|
+
Structure of IPv6-Route RPL Source data [:rfc:`6554`]:
|
519
|
+
|
520
|
+
.. code-block:: text
|
521
|
+
|
522
|
+
0 1 2 3
|
523
|
+
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
|
524
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
525
|
+
| Next Header | Hdr Ext Len | Routing Type | Segments Left |
|
526
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
527
|
+
| CmprI | CmprE | Pad | Reserved |
|
528
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
529
|
+
| |
|
530
|
+
. .
|
531
|
+
. Addresses[1..n] .
|
532
|
+
. .
|
533
|
+
| |
|
534
|
+
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
535
|
+
|
536
|
+
Args:
|
537
|
+
length: route data length
|
538
|
+
|
539
|
+
Returns:
|
540
|
+
Parsed route data.
|
541
|
+
|
542
|
+
"""
|
543
|
+
if header.length % 16 != 0:
|
544
|
+
raise ProtocolError(f'{self.alias}: [TypeNo {type}] invalid format')
|
545
|
+
|
546
|
+
ipv6_route = Data_RPL(
|
547
|
+
next=header.next,
|
548
|
+
length=header.length * 8 + 8,
|
549
|
+
type=header.type,
|
550
|
+
seg_left=header.seg_left,
|
551
|
+
cmpr_i=schema.cmpr_i,
|
552
|
+
cmpr_e=schema.cmpr_e,
|
553
|
+
pad=schema.pad['pad_len'],
|
554
|
+
ip=tuple(schema.ip),
|
555
|
+
)
|
556
|
+
return ipv6_route
|
557
|
+
|
558
|
+
def _make_data_type_none(self, type: 'Enum_Routing', route: 'Optional[Data_UnknownType]' = None, *,
|
559
|
+
dst: 'Optional[IPv6Address]' = None,
|
560
|
+
data: 'bytes' = b'\x00\x00\x00\x00',
|
561
|
+
**kwargs: 'Any') -> 'Schema_UnknownType':
|
562
|
+
"""Make IPv6-Route unknown type data.
|
563
|
+
|
564
|
+
Args:
|
565
|
+
type: routing type
|
566
|
+
route: route data
|
567
|
+
dst: destination IPv6 address
|
568
|
+
data: raw route data as :obj:`bytes`
|
569
|
+
**kwargs: arbitrary keyword arguments
|
570
|
+
|
571
|
+
Returns:
|
572
|
+
Constructed route data schema.
|
573
|
+
|
574
|
+
"""
|
575
|
+
if route is not None:
|
576
|
+
data = route.data
|
577
|
+
|
578
|
+
pad_len = 8 - (len(data) + 4) % 8
|
579
|
+
if pad_len:
|
580
|
+
data += bytes(pad_len)
|
581
|
+
|
582
|
+
return Schema_UnknownType(
|
583
|
+
data=data,
|
584
|
+
)
|
585
|
+
|
586
|
+
def _make_data_type_src(self, type: 'Enum_Routing', route: 'Optional[Data_SourceRoute]' = None, *,
|
587
|
+
dst: 'Optional[IPv6Address]' = None,
|
588
|
+
ip: 'Optional[list[IPv6Address | str | bytes | int]]' = None,
|
589
|
+
**kwargs: 'Any') -> 'Schema_SourceRoute':
|
590
|
+
"""Make IPv6-Route Source Route data.
|
591
|
+
|
592
|
+
Args:
|
593
|
+
type: routing type
|
594
|
+
route: route data
|
595
|
+
dst: destination IPv6 address
|
596
|
+
ip: list of IPv6 addresses
|
597
|
+
**kwargs: arbitrary keyword arguments
|
598
|
+
|
599
|
+
Returns:
|
600
|
+
Constructed route data schema.
|
601
|
+
|
602
|
+
"""
|
603
|
+
if route is not None:
|
604
|
+
ip = cast('list[IPv6Address | str | bytes | int]', route.ip)
|
605
|
+
else:
|
606
|
+
ip = [] if ip is None else ip
|
607
|
+
|
608
|
+
return Schema_SourceRoute(
|
609
|
+
ip=ip,
|
610
|
+
)
|
611
|
+
|
612
|
+
def _make_data_type_2(self, type: 'Enum_Routing', route: 'Optional[Data_Type2]' = None, *,
|
613
|
+
dst: 'Optional[IPv6Address]' = None,
|
614
|
+
ip: 'IPv6Address | str | bytes | int' = '::',
|
615
|
+
**kwargs: 'Any') -> 'Schema_Type2':
|
616
|
+
"""Make IPv6-Route Type 2 data.
|
617
|
+
|
618
|
+
Args:
|
619
|
+
type: routing type
|
620
|
+
route: route data
|
621
|
+
dst: destination IPv6 address
|
622
|
+
ip: home address
|
623
|
+
**kwargs: arbitrary keyword arguments
|
624
|
+
|
625
|
+
Returns:
|
626
|
+
Constructed route data schema.
|
627
|
+
|
628
|
+
"""
|
629
|
+
if route is not None:
|
630
|
+
ip = cast('IPv6Address | str | bytes | int', route.ip)
|
631
|
+
|
632
|
+
return Schema_Type2(
|
633
|
+
ip=ip,
|
634
|
+
)
|
635
|
+
|
636
|
+
def _make_data_type_rpl(self, type: 'Enum_Routing', route: 'Optional[Data_RPL]' = None, *,
|
637
|
+
dst: 'Optional[IPv6Address]' = None,
|
638
|
+
ip: 'Optional[list[IPv6Address | str | bytes | int]]' = None,
|
639
|
+
**kwargs: 'Any') -> 'Schema_RPL':
|
640
|
+
"""Make IPv6-Route RPL Source data.
|
641
|
+
|
642
|
+
Args:
|
643
|
+
type: routing type
|
644
|
+
route: route data
|
645
|
+
dst: destination IPv6 address
|
646
|
+
ip: list of IPv6 addresses
|
647
|
+
**kwargs: arbitrary keyword arguments
|
648
|
+
|
649
|
+
Returns:
|
650
|
+
Constructed route data schema.
|
651
|
+
|
652
|
+
"""
|
653
|
+
if route is not None:
|
654
|
+
cmpr_i = route.cmpr_i
|
655
|
+
cmpr_e = route.cmpr_e
|
656
|
+
pad = route.pad
|
657
|
+
ip_val = [
|
658
|
+
addr if isinstance(addr, bytes) else addr.packed for addr in route.ip
|
659
|
+
]
|
660
|
+
else:
|
661
|
+
ip = [] if ip is None else ip
|
662
|
+
|
663
|
+
if dst is None:
|
664
|
+
pad = 0
|
665
|
+
cmpr_i = 0
|
666
|
+
cmpr_e = 0
|
667
|
+
ip_val = [
|
668
|
+
cast('IPv6Address', ipaddress.ip_address(addr)).packed for addr in ip
|
669
|
+
]
|
670
|
+
else:
|
671
|
+
test_list = [dst.packed] # type: list[bytes]
|
672
|
+
for item in ip[:-1]:
|
673
|
+
if isinstance(item, bytes):
|
674
|
+
test_list.append(item)
|
675
|
+
else:
|
676
|
+
test_list.append(cast('IPv6Address', ipaddress.ip_address(item)).packed)
|
677
|
+
prefix_i = os_path.commonprefix(test_list)
|
678
|
+
cmpr_i = len(prefix_i)
|
679
|
+
|
680
|
+
test_list = [dst.packed]
|
681
|
+
if isinstance(ip[-1], bytes):
|
682
|
+
test_list.append(ip[-1])
|
683
|
+
else:
|
684
|
+
test_list.append(cast('IPv6Address', ipaddress.ip_address(ip[-1])).packed)
|
685
|
+
prefix_e = os_path.commonprefix(test_list)
|
686
|
+
cmpr_e = len(prefix_e)
|
687
|
+
|
688
|
+
pad = 8 - ((len(ip) - 1) * (16 - cmpr_i) + (16 - cmpr_e)) % 8
|
689
|
+
|
690
|
+
ip_val = []
|
691
|
+
for item in ip[:-1]:
|
692
|
+
if isinstance(item, bytes):
|
693
|
+
ip_val.append(item[cmpr_i:])
|
694
|
+
else:
|
695
|
+
ip_val.append(cast('IPv6Address', ipaddress.ip_address(item)).packed[cmpr_i:])
|
696
|
+
if isinstance(ip[-1], bytes):
|
697
|
+
ip_val.append(ip[-1][cmpr_e:])
|
698
|
+
else:
|
699
|
+
ip_val.append(cast('IPv6Address', ipaddress.ip_address(ip[-1])).packed[cmpr_e:])
|
700
|
+
|
701
|
+
return Schema_RPL(
|
702
|
+
cmpr_i=cmpr_i,
|
703
|
+
cmpr_e=cmpr_e,
|
704
|
+
pad={
|
705
|
+
'pad_len': pad,
|
706
|
+
},
|
707
|
+
addresses=ip_val,
|
708
|
+
)
|