Skip to main content

Dot11Layer

Struct Dot11Layer 

Source
pub struct Dot11Layer {
    pub index: LayerIndex,
}
Expand description

IEEE 802.11 layer - a zero-copy view into the packet buffer.

Provides lazy field access for all 802.11 header fields. The Frame Control field is always little-endian.

Frame Control layout (2 bytes, little-endian):

Byte 0: [subtype(4) | type(2) | protocol_version(2)]
Byte 1: [order | protected | more_data | pwr_mgt | retry | more_frag | from_ds | to_ds]

Fields§

§index: LayerIndex

Implementations§

Source§

impl Dot11Layer

Source

pub fn new(start: usize, end: usize) -> Self

Create a new Dot11Layer from start/end offsets.

Source

pub fn validate(buf: &[u8], offset: usize) -> Result<(), FieldError>

Validate that the buffer contains enough data for this layer.

Source

pub fn frame_control_raw(&self, buf: &[u8]) -> Result<u16, FieldError>

Read the raw Frame Control field (2 bytes, little-endian).

Source

pub fn protocol_version(&self, buf: &[u8]) -> Result<u8, FieldError>

Protocol version (2 bits from FC byte 0, bits 0-1).

Source

pub fn frame_type(&self, buf: &[u8]) -> Result<u8, FieldError>

Frame type (2 bits from FC byte 0, bits 2-3).

Source

pub fn subtype(&self, buf: &[u8]) -> Result<u8, FieldError>

Frame subtype (4 bits from FC byte 0, bits 4-7).

Source

pub fn flags(&self, buf: &[u8]) -> Result<u8, FieldError>

Flags byte (FC byte 1, bits 8-15 of the FC word).

Source

pub fn to_ds(&self, buf: &[u8]) -> Result<bool, FieldError>

To DS flag (bit 0 of flags byte).

Source

pub fn from_ds(&self, buf: &[u8]) -> Result<bool, FieldError>

From DS flag (bit 1 of flags byte).

Source

pub fn more_frag(&self, buf: &[u8]) -> Result<bool, FieldError>

More Fragments flag (bit 2 of flags byte).

Source

pub fn retry(&self, buf: &[u8]) -> Result<bool, FieldError>

Retry flag (bit 3 of flags byte).

Source

pub fn pwr_mgt(&self, buf: &[u8]) -> Result<bool, FieldError>

Power Management flag (bit 4 of flags byte).

Source

pub fn more_data(&self, buf: &[u8]) -> Result<bool, FieldError>

More Data flag (bit 5 of flags byte).

Source

pub fn protected(&self, buf: &[u8]) -> Result<bool, FieldError>

Protected Frame flag (bit 6 of flags byte).

Source

pub fn htc_order(&self, buf: &[u8]) -> Result<bool, FieldError>

HTC/Order flag (bit 7 of flags byte).

Source

pub fn duration(&self, buf: &[u8]) -> Result<u16, FieldError>

Duration/ID field (2 bytes, little-endian).

Source

pub fn addr1(&self, buf: &[u8]) -> Result<MacAddress, FieldError>

Address 1 (always present, 6 bytes at offset 4).

Source

pub fn addr2(&self, buf: &[u8]) -> Result<MacAddress, FieldError>

Address 2 (present in most frames except some control frames).

Source

pub fn addr3(&self, buf: &[u8]) -> Result<MacAddress, FieldError>

Address 3 (present in management and data frames).

Source

pub fn addr4(&self, buf: &[u8]) -> Result<MacAddress, FieldError>

Address 4 (only present in WDS frames: to_DS=1 AND from_DS=1).

Source

pub fn has_addr4(&self, buf: &[u8]) -> bool

Check if this frame has a 4th address field (WDS mode).

Source

pub fn is_control(&self, buf: &[u8]) -> bool

Check if this is a control frame (which may have fewer addresses).

Source

pub fn seq_ctrl_raw(&self, buf: &[u8]) -> Result<u16, FieldError>

Raw Sequence Control field (2 bytes, little-endian).

Source

pub fn fragment_num(&self, buf: &[u8]) -> Result<u8, FieldError>

Fragment number (lower 4 bits of Sequence Control).

Source

pub fn sequence_num(&self, buf: &[u8]) -> Result<u16, FieldError>

Sequence number (upper 12 bits of Sequence Control).

Source

pub fn compute_header_len(&self, buf: &[u8]) -> usize

Calculate the actual header length based on frame type and flags.

Source

pub fn set_frame_control( &self, buf: &mut [u8], fc: u16, ) -> Result<(), FieldError>

Write the Frame Control field (little-endian).

Source

pub fn set_duration(&self, buf: &mut [u8], dur: u16) -> Result<(), FieldError>

Write the Duration/ID field (little-endian).

Source

pub fn set_addr1( &self, buf: &mut [u8], mac: MacAddress, ) -> Result<(), FieldError>

Write Address 1.

Source

pub fn set_addr2( &self, buf: &mut [u8], mac: MacAddress, ) -> Result<(), FieldError>

Write Address 2.

Source

pub fn set_addr3( &self, buf: &mut [u8], mac: MacAddress, ) -> Result<(), FieldError>

Write Address 3.

Source

pub fn set_addr4( &self, buf: &mut [u8], mac: MacAddress, ) -> Result<(), FieldError>

Write Address 4.

Source

pub fn set_seq_ctrl(&self, buf: &mut [u8], sc: u16) -> Result<(), FieldError>

Write the Sequence Control field (little-endian).

Source

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

Field names for dynamic access.

Source

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

Get a field value by name.

Source

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

Set a field value by name.

Source

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

Compute hash for packet matching.

Source

pub fn answers(&self, buf: &[u8], other: &Dot11Layer, other_buf: &[u8]) -> bool

Check if this packet answers another 802.11 packet.

Trait Implementations§

Source§

impl Clone for Dot11Layer

Source§

fn clone(&self) -> Dot11Layer

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Dot11Layer

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Layer for Dot11Layer

Source§

fn kind(&self) -> LayerKind

Get the kind of this layer
Source§

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

Get a human-readable summary of this layer
Source§

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

Get the header length for this layer
Source§

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

Compute a hash for packet matching.
Source§

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

Get the list of field names for this layer
Source§

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

Check if this packet answers another packet.
Source§

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

Extract padding from the packet.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V