Struct Ipv6PacketRaw 

pub struct Ipv6PacketRaw<B> { /* private fields */ }

A partially parsed and not yet validated IPv6 packet.

Ipv6PacketRaw provides minimal parsing of an IPv6 packet, namely it only requires that the fixed header part ([HeaderPrefix]) be retrieved, all the other parts of the packet may be missing when attempting to create it.

Ipv6Packet provides a FromRaw implementation that can be used to validate an Ipv6PacketRaw.

Implementations

impl<B> Ipv6PacketRaw<B>

pub fn body_mut(&mut self) -> Option<&mut B>

Returns a mutable reference to the body bytes of this Ipv6PacketRaw.

Might not be complete if a full packet was not received.

impl<B: SplitByteSlice> Ipv6PacketRaw<B>

pub fn body_proto( &self, ) -> Result<(MaybeParsed<&[u8], &[u8]>, Ipv6Proto), ExtHdrParseError>

Returns the body and upper-layer Protocol Number.

If extension headers failed to parse, body_proto returns Err(ExtHdrParseError). Extension headers must be parsed in order to find the bounds of the upper-layer payload and to find that last extension header’s Next Header field, which is the Protocol Number of the upper-layer payload.

Note that extension header parsing stops after the first Fragment header. For packets with a Fragment header, the returned body is the Fragmentable Part of the packet following the Fragment header, and the returned Protocol Number is the Fragment header’s Next Header value, which may not be an upper-layer protocol (e.g. it may identify another extension header).

The returned body will be MaybeParsed::Complete if all the body bytes were consumed (as stated by the header’s payload length value) or MaybeParsed::Incomplete containing the bytes that were present otherwise.

pub fn body(&self) -> Result<MaybeParsed<&[u8], &[u8]>, ExtHdrParseError>

Returns the body.

If extension headers failed to parse, body returns Err(ExtHdrParseError). Extension headers must be parsed in order to find the bounds of the upper-layer payload.

Note that for packets with a Fragment header, the returned body is the Fragmentable Part of the packet following the Fragment header. See Ipv6PacketRaw::body_proto for details.

The returned body will be MaybeParsed::Complete if all the body bytes were consumed (as stated by the header’s payload length value) or MaybeParsed::Incomplete containing the bytes that were present otherwise.

pub fn proto(&self) -> Result<Ipv6Proto, ExtHdrParseError>

Returns the upper-layer Protocol Number.

If extension headers failed to parse, body_proto returns Err(ExtHdrParseError). Extension headers must be parsed in order to find the last extension header’s Next Header field, which is the Protocol Number of the upper-layer payload.

Note that for packets with a Fragment header, the returned Protocol Number is the Fragment header’s Next Header value, which may not be an upper-layer protocol. See Ipv6PacketRaw::body_proto for details.

impl<B: SplitByteSliceMut> Ipv6PacketRaw<B>

pub fn set_src_ip(&mut self, addr: Ipv6Addr)

Set the source IP address.

pub fn set_dst_ip(&mut self, addr: Ipv6Addr)

Set the destination IP address.

pub fn set_payload_len(&mut self, payload_len: u16)

Set the payload length of the IPv6 packet.

Trait Implementations

impl<B: SplitByteSlice> FromRaw<Ipv6PacketRaw<B>, ()> for Ipv6Packet<B>

type Error = Ipv6ParseError

The type of error that may happen during validation.

fn try_from_raw_with( raw: Ipv6PacketRaw<B>, _args: (), ) -> Result<Self, Self::Error>

Attempts to create Self from the raw form in raw with args.

fn try_from_raw(raw: R) -> Result<Self, Self::Error>

where Self: FromRaw<R, (), Error = Self::Error>,

Attempts to create Self from the raw form in raw.

impl<B: SplitByteSlice, I: IpExt> GenericOverIp<I> for Ipv6PacketRaw<B>

type Type = <I as IpExt>::PacketRaw<B>

The type of Self when its IP-generic parameter is replaced with the type NewIp.

impl<B: SplitByteSlice> IpPacketRaw<B, Ipv6> for Ipv6PacketRaw<B>

impl<B: SplitByteSlice> Ipv6Header for Ipv6PacketRaw<B>

fn get_fixed_header(&self) -> &FixedHeader

Gets a reference to the IPv6 FixedHeader.

fn hop_limit(&self) -> u8

The Hop Limit.

fn next_header(&self) -> u8

The Next Header.

fn src_ip(&self) -> Ipv6Addr

The source IP address.

fn dst_ip(&self) -> Ipv6Addr

The destination IP address.

fn dscp_and_ecn(&self) -> DscpAndEcn

The Differentiated Services Code Point (DSCP) and the Explicit Congestion Notification (ECN).

impl<B: SplitByteSlice> ParsablePacket<B, ()> for Ipv6PacketRaw<B>

type Error = Ipv6ParseError

The type of errors returned from parse and parse_mut.

fn parse<BV: BufferView<B>>(buffer: BV, _args: ()) -> Result<Self, Self::Error>

Parses a packet from a buffer.

fn parse_metadata(&self) -> ParseMetadata

Gets metadata about this packet required by GrowBuffer::undo_parse.

fn parse_mut<BV>(buffer: BV, args: ParseArgs) -> Result<Self, Self::Error>

where BV: BufferViewMut<B>, B: SplitByteSliceMut,

Parses a packet from a mutable buffer.