Struct GenericLayer 

pub struct GenericLayer {
    pub index: LayerIndex,
    pub name: Arc<str>,
    pub field_descs: Arc<Vec<GenericFieldDesc>>,
}

A dynamically-defined protocol layer for custom / user-defined protocols.

The field descriptors are shared (Arc) so they can be defined once and reused across many packet instances efficiently.

Fields

index: LayerIndex

Position of this layer within the packet buffer.

name: Arc<str>

Protocol name as defined by the caller.

field_descs: Arc<Vec<GenericFieldDesc>>

Shared field descriptors.

Implementations

impl GenericLayer

pub fn new( index: LayerIndex, name: Arc<str>, field_descs: Arc<Vec<GenericFieldDesc>>, ) -> Self

Create a new GenericLayer.

pub fn summary(&self, _buf: &[u8]) -> String

Human-readable summary: "<name> (<N> fields)".

pub fn header_len(&self, _buf: &[u8]) -> usize

Header length = sum of all field sizes.

pub fn field_names_dynamic(&self) -> Vec<String>

Dynamic list of field names (not &'static str because names come from user-defined strings at runtime).

pub fn get_field( &self, buf: &[u8], name: &str, ) -> Option<Result<FieldValue, FieldError>>

Read a field from the buffer.

Returns:

• Some(Ok(value)) if the field was found and the buffer is long enough.
• Some(Err(e)) if the field was found but the buffer is too short.
• None if no field with this name exists in this layer.

pub fn set_field( &self, buf: &mut [u8], name: &str, value: FieldValue, ) -> Option<Result<(), FieldError>>

Write a field into the (mutable) buffer.

Returns:

• Some(Ok(())) if the field was found and written successfully.
• Some(Err(e)) if the field was found but the buffer is too short or the value type is wrong.
• None if no field with this name exists in this layer.

Trait Implementations

impl Clone for GenericLayer

fn clone(&self) -> GenericLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GenericLayer

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

Formats the value using the given formatter.

impl Layer for GenericLayer

fn field_names(&self) -> &'static [&'static str]

The Layer trait requires &'static [&'static str], which is not possible for dynamically-generated field names. Returns an empty slice; callers that need the full list should call field_names_dynamic directly.

fn kind(&self) -> LayerKind

Get the kind of this layer

fn summary(&self, data: &[u8]) -> String

Get a human-readable summary of this layer

fn header_len(&self, data: &[u8]) -> usize

Get the header length for this layer

fn hashret(&self, _data: &[u8]) -> Vec<u8>

Compute a hash for packet matching.

fn answers(&self, _data: &[u8], _other: &Self, _other_data: &[u8]) -> bool

Check if this packet answers another packet.

fn extract_padding<'a>(&self, data: &'a [u8]) -> (&'a [u8], &'a [u8])

Extract padding from the packet.