Struct Packet 

pub struct Packet { /* private fields */ }

A network packet with zero-copy buffer storage.

Architecture

The Packet struct implements a “Lazy Zero-Copy View” model:

• Zero-Copy: The data field uses Bytes, a reference-counted buffer.
• Lazy: Fields are not parsed until accessed.
• Copy-on-Write: Mutation triggers cloning only when buffer is shared.

Implementations

impl Packet

pub fn empty() -> Self

Creates an empty packet with no data.

pub fn from_bytes(data: impl Into<Bytes>) -> Self

Creates a packet from raw bytes without parsing.

pub fn from_slice(data: &[u8]) -> Self

Creates a packet from a byte slice by copying the data.

pub fn with_capacity(capacity: usize) -> Self

Creates a new packet with pre-allocated capacity.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn is_dirty(&self) -> bool

pub fn layer_count(&self) -> usize

pub fn is_parsed(&self) -> bool

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

pub fn bytes(&self) -> Bytes

pub fn into_bytes(self) -> Bytes

pub fn layers(&self) -> &[LayerIndex]

pub fn get_layer(&self, kind: LayerKind) -> Option<&LayerIndex>

pub fn layer_bytes(&self, kind: LayerKind) -> Result<&[u8]>

Returns the bytes for a specific layer.

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

Returns the payload (data after all parsed headers).

pub fn ethernet(&self) -> Option<EthernetLayer>

Get the Ethernet layer view if present.

pub fn ipv4(&self) -> Option<Ipv4Layer>

Get the IPv4 layer view if present.

pub fn arp(&self) -> Option<ArpLayer>

Get the ARP layer view if present.

pub fn icmp(&self) -> Option<IcmpLayer>

Get the ICMP layer view if present.

pub fn tcp(&self) -> Option<TcpLayer>

Get the TCP layer view if present.

pub fn udp(&self) -> Option<UdpLayer>

Get the UDP layer view if present.

pub fn dns(&self) -> Option<DnsLayer>

Get the DNS layer view if present.

pub fn tls(&self) -> Option<TlsLayer>

Get the TLS layer view if present.

pub fn layer_enum(&self, idx: &LayerIndex) -> LayerEnum

Get a LayerEnum for a given LayerIndex.

pub fn layer_enums(&self) -> Vec<LayerEnum>

Get all layers as LayerEnum objects.

pub fn parse(&mut self) -> Result<()>

Parses the packet to identify layer boundaries.

pub fn with_data_mut<F, R>(&mut self, f: F) -> R

where F: FnOnce(&mut [u8]) -> R,

Applies a mutation function to the packet data.

pub fn set_byte(&mut self, offset: usize, value: u8)

pub fn set_bytes(&mut self, offset: usize, values: &[u8])

pub fn mark_dirty(&mut self)

pub fn mark_clean(&mut self)

pub fn add_layer(&mut self, index: LayerIndex)

pub fn set_data(&mut self, data: BytesMut)

Trait Implementations

impl AsRef<[u8]> for Packet

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Packet

fn clone(&self) -> Packet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Packet

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

Formats the value using the given formatter.

impl Default for Packet

fn default() -> Self

Returns the “default value” for a type.

impl From<&[u8]> for Packet

fn from(data: &[u8]) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for Packet

fn from(data: Vec<u8>) -> Self

Converts to this type from the input type.