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: 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.

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.

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.

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.

Trait Implementations

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

type Error = IpParseError<Ipv6>

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> 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 = IpParseError<Ipv6>

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.