Struct Ipv6Ref

pub struct Ipv6Ref<'a> { /* private fields */ }

An IPv6 (Internet Protocol version 6) packet.

Packet Layout

   .    Octet 0    .    Octet 1    .    Octet 2    .    Octet 3    .
   |0 1 2 3 4 5 6 7|0 1 2 3 4 5 6 7|0 1 2 3 4 5 6 7|0 1 2 3 4 5 6 7|
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 0 |Version| Traffic Class |              Flow Label               |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 4 |    Options & Payload Length   | Next Hdr Type |   Hop Limit   |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 8 |                         Source Address                        |
   |                                                               |
   |                                                               |
   |                                                               |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
24 |                      Destination Address                      |
   |                                                               |
   |                                                               |
   |                                                               |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
40 Z               Payload (or next Extension Header)              Z
   Z                                                               Z
.. .                              ...                              .
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Implementations

impl<'a> Ipv6Ref<'a>

pub fn version(&self) -> u8

The Internet Protocol Version of the packet (should be equal to 6).

pub fn traffic_class(&self) -> TrafficClass

The Traffic Class of the packet.

pub fn flow_label(&self) -> FlowLabel

The Flow Label of the packet.

pub fn data_length(&self) -> u16

The combined length of the IPv6 extension headers and payload.

pub fn next_header(&self) -> u8

A single byte value indicating the next header type following the IPv6 header.

If any IPv6 Extension Headers are present in the packet, the Next Header Type field will indicate the type of the first Extension Header. That option then contains a Next Header field that indicates the type of the next header after it, and so on; the final header in the IPv6 packet indicates the type of the payload.

The pkts library treats each of these Extension Headers as a distinct Layer type.

pub fn hop_limit(&self) -> u8

The hop limit of the packet.

Similar to Ipv4::ttl(), this field indicates the number of routing hops the message should be permitted to traverse before being dropped.

When a router receives an IPv6 packet, it checks the Hop Limit field of the packet. If the hop limit is 0, the router drops the packet and optionally sends an ICMP “Time Exceeded” packet back to the address that sent the packet; otherwise, it decrements the value of the hop limit by 1 and routes the packet to its next hop.

the Hop Limit field is primarily used to avoid resource exhaustion in the event that a routing loop forms, though tools like traceroute also use its functionality to identify routing paths across a network.

pub fn src(&self) -> Ipv6Addr

Available on crate feature std or rustc_1_77 only.

The source IP address of the packet.

pub fn src_bytes(&self) -> [u8; 16]

The source IP address of the packet, in bytes.

pub fn dst(&self) -> Ipv6Addr

Available on crate feature std or rustc_1_77 only.

The destination IP address of the packet.

pub fn dst_bytes(&self) -> [u8; 16]

The destination IP address of the packet, in bytes.

pub fn payload_raw(&self) -> &[u8]

The payload of the packet, in raw bytes.

Trait Implementations

impl<'a> Clone for Ipv6Ref<'a>

fn clone(&self) -> Ipv6Ref<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Ipv6Ref<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&Ipv6Ref<'_>> for Ipv6

fn from(r: &Ipv6Ref<'_>) -> Self

Converts to this type from the input type.

impl From<Ipv6Ref<'_>> for Ipv6

fn from(value: Ipv6Ref<'_>) -> Self

Converts to this type from the input type.

impl<'a> From<Ipv6Ref<'a>> for &'a [u8]

fn from(value: Ipv6Ref<'a>) -> Self

Converts to this type from the input type.

impl<'a> FromBytesRef<'a> for Ipv6Ref<'a>

fn from_bytes_unchecked(packet: &'a [u8]) -> Self

Converts a slice of bytes into a LayerRef type.

fn from_bytes(bytes: &'a [u8]) -> Result<Self, ValidationError>

Converts a slice of bytes into a LayerRef type, returning an error if the bytes would not form a valid layer.

impl<'a> IndexLayerRef<'a> for Ipv6Ref<'a>

fn get_layer<T: LayerRef<'a> + FromBytesRef<'a>>(&'a self) -> Option<T>

Retrieves a reference to the first sublayer of type T, if such a sublayer exists.

fn get_nth_layer<T: LayerRef<'a> + FromBytesRef<'a> + BaseLayerMetadata>( &'a self, n: usize, ) -> Option<T>

Retrieves a reference to the nth sublayer of type T, if such a sublayer exists.

fn index_layer<T: LayerRef<'a> + FromBytesRef<'a> + BaseLayerMetadata>( &'a self, ) -> T

Retrieves a reference to the first sublayer of type T.

fn index_nth_layer<T: LayerRef<'a> + FromBytesRef<'a> + BaseLayerMetadata>( &'a self, n: usize, ) -> T

Retrieves a reference to the nth sublayer of type T.

impl LayerIdentifier for Ipv6Ref<'_>

fn layer_id() -> LayerId

A unique identifier for the layer type.

impl LayerLength for Ipv6Ref<'_>

fn len(&self) -> usize

The length (in bytes) of the layer.

impl<'a> LayerObjectMetadata for Ipv6Ref<'a>

fn layer_metadata(&self) -> &dyn LayerMetadata

Static metadata associated with the given layer. This method is normally only used internally or when defining a custom Layer type.

impl<'a> LayerObjectName for Ipv6Ref<'a>

fn layer_name(&self) -> &'static str

The name of the layer, usually (though not guaranteed to be) the same as the name of the struct.

impl<'a> ToBoxedLayer for Ipv6Ref<'a>

Available on crate feature alloc only.

fn to_boxed_layer(&self) -> Box<dyn LayerObject>

Clone the given instance in a Box and return it as a dyn Layer type.

impl ToLayer for Ipv6Ref<'_>

Available on crate feature alloc only.

type Owned = Ipv6

fn to_layer(&self) -> Self::Owned

Creates a new Layer out of the given layer instance.

impl Validate for Ipv6Ref<'_>

fn validate(bytes: &[u8]) -> Result<(), ValidationError>

Checks that bytes represents a valid serialization of the layer type.

impl<'a> Copy for Ipv6Ref<'a>

impl<'a> LayerRef<'a> for Ipv6Ref<'a>

impl<'a> StatelessLayer for Ipv6Ref<'a>