Struct etherparse::PacketHeaders

pub struct PacketHeaders<'a> {
    pub link: Option<Ethernet2Header>,
    pub vlan: Option<VlanHeader>,
    pub ip: Option<IpHeader>,
    pub transport: Option<TransportHeader>,
    pub payload: &'a [u8],
}

Decoded packet headers (data link layer and higher). You can use PacketHeaders::from_ethernet_slice or PacketHeader::from_ip_slice to decode and get this struct as a result.

Fields

link: Option<Ethernet2Header>

vlan: Option<VlanHeader>

ip: Option<IpHeader>

transport: Option<TransportHeader>

payload: &'a [u8]

Rest of the packet that could not be decoded as a header (usually the payload).

Implementations

impl<'a> PacketHeaders<'a>

pub fn from_ethernet_slice(
    packet: &[u8]
) -> Result<PacketHeaders<'_>, ReadError>

Tries to decode as much as possible of a packet.

pub fn from_ip_slice(packet: &[u8]) -> Result<PacketHeaders<'_>, ReadError>

Tries to decode an ip packet and its transport headers.
Assumes the given slice starts with the first byte of the IP header

Example

// build a UDP packet
let payload = [0u8;18];
let builder = PacketBuilder::
   ipv4([192,168,1,1], //source ip
         [192,168,1,2], //desitionation ip
         20)            //time to life
   .udp(21,    //source port 
        1234); //desitnation port

// serialize the packet
let packet = {
    let mut packet = Vec::<u8>::with_capacity(
                    builder.size(payload.len()));
    builder.write(&mut packet, &payload).unwrap();
    packet
};

// parse the ip packet from a slice
let p = PacketHeaders::from_ip_slice(&packet)
    .expect("Failed to decode the packet");

Trait Implementations

impl<'a> Clone for PacketHeaders<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for PacketHeaders<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<PacketHeaders<'a>> for PacketHeaders<'a>

fn eq(&self, other: &PacketHeaders<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for PacketHeaders<'a>

impl<'a> StructuralEq for PacketHeaders<'a>

impl<'a> StructuralPartialEq for PacketHeaders<'a>