Struct Dot11 

pub struct Dot11 { /* private fields */ }

IEEE 802.11 MAC layer.

Implementations

impl Dot11

pub fn new() -> Self

Create a three-address data MAC header with deterministic safe defaults.

pub fn management(subtype: Dot11ManagementSubtype) -> Self

Create a management frame with the given subtype.

pub fn control(subtype: Dot11ControlSubtype) -> Self

Create a control frame with the given subtype.

pub fn data() -> Self

Create a data frame.

pub fn qos_data() -> Self

Create a QoS data frame with a zero QoS control field.

pub fn beacon() -> Self

Create a beacon management frame.

pub fn probe_request() -> Self

Create a probe request management frame.

pub fn probe_response() -> Self

Create a probe response management frame.

pub fn association_request() -> Self

Create an association request management frame.

pub fn association_response() -> Self

Create an association response management frame.

pub fn reassociation_request() -> Self

Create a reassociation request management frame.

pub fn reassociation_response() -> Self

Create a reassociation response management frame.

pub fn authentication() -> Self

Create an authentication management frame.

pub fn deauthentication() -> Self

Create a deauthentication management frame.

pub fn disassociation() -> Self

Create a disassociation management frame.

pub fn action() -> Self

Create an action management frame with a zero category field.

pub fn action_no_ack() -> Self

Create an action-no-ack management frame with a zero category field.

pub fn ack() -> Self

Create an ACK control frame.

pub fn rts() -> Self

Create an RTS control frame.

pub fn cts() -> Self

Create a CTS control frame.

pub fn block_ack() -> Self

Create a Block Ack control frame.

pub fn block_ack_request() -> Self

Create a Block Ack Request control frame.

pub fn ps_poll() -> Self

Create a PS-Poll control frame.

pub fn cf_end() -> Self

Create a CF-End control frame.

pub fn cf_end_cf_ack() -> Self

Create a CF-End + CF-Ack control frame.

pub fn frame_control(self, frame_control: Dot11FrameControl) -> Self

Set the frame-control field.

pub fn more_fragments(self, enabled: bool) -> Self

Set or clear the More Fragments frame-control bit.

pub fn duration_id(self, duration_id: u16) -> Self

Set the duration/ID field.

pub fn addr1(self, addr: impl Into<MacAddr>) -> Self

Set address 1.

pub fn addr2(self, addr: impl Into<MacAddr>) -> Self

Set address 2.

pub fn addr3(self, addr: impl Into<MacAddr>) -> Self

Set address 3.

pub fn addr4(self, addr: impl Into<MacAddr>) -> Self

Set address 4.

pub fn sequence_control(self, sequence_control: Dot11SequenceControl) -> Self

Set the sequence-control field.

pub fn sequence_number(self, sequence_number: u16) -> Self

Set the twelve-bit sequence number in the sequence-control field.

pub fn fragment_number(self, fragment_number: u8) -> Self

Set the four-bit fragment number in the sequence-control field.

pub fn qos_control(self, qos_control: u16) -> Self

Set the QoS control field.

pub fn with_qos_control_fields(self, qos_control: Dot11QosControl) -> Self

Set the QoS control field from typed subfields.

pub fn ht_control(self, ht_control: u32) -> Self

Set the HT Control field.

pub fn fixed_parameters(self, fixed_parameters: impl Into<Vec<u8>>) -> Self

Set raw fixed management-field bytes to emit after the MAC header.

pub fn with_beacon_fixed_fields( self, fixed_fields: Dot11BeaconFixedFields, ) -> Self

Set Beacon fixed fields without changing the frame subtype.

pub fn with_probe_response_fixed_fields( self, fixed_fields: Dot11BeaconFixedFields, ) -> Self

Set Probe Response fixed fields without changing the frame subtype.

pub fn with_association_request_fixed_fields( self, fixed_fields: Dot11AssociationRequestFixedFields, ) -> Self

Set Association Request fixed fields without changing the frame subtype.

pub fn with_association_response_fixed_fields( self, fixed_fields: Dot11AssociationResponseFixedFields, ) -> Self

Set Association Response fixed fields without changing the frame subtype.

pub fn with_reassociation_request_fixed_fields( self, fixed_fields: Dot11ReassociationRequestFixedFields, ) -> Self

Set Reassociation Request fixed fields without changing the frame subtype.

pub fn with_reassociation_response_fixed_fields( self, fixed_fields: Dot11AssociationResponseFixedFields, ) -> Self

Set Reassociation Response fixed fields without changing the frame subtype.

pub fn with_authentication_fixed_fields( self, fixed_fields: Dot11AuthenticationFixedFields, ) -> Self

Set Authentication fixed fields without changing the frame subtype.

pub fn with_deauthentication_fixed_fields( self, fixed_fields: Dot11ReasonCodeFixedFields, ) -> Self

Set Deauthentication fixed fields without changing the frame subtype.

pub fn with_disassociation_fixed_fields( self, fixed_fields: Dot11ReasonCodeFixedFields, ) -> Self

Set Disassociation fixed fields without changing the frame subtype.

pub fn with_action_fixed_fields( self, fixed_fields: Dot11ActionFixedFields, ) -> Self

Set Action fixed fields without changing the frame subtype.

pub fn tag(self, tag: Dot11TaggedParameter) -> Self

Append a raw tagged parameter.

pub fn tags(self, tags: impl Into<Vec<Dot11TaggedParameter>>) -> Self

Replace raw tagged parameters.

pub fn ssid(self, ssid: impl Into<Vec<u8>>) -> Self

Append an SSID tagged parameter.

pub fn supported_rates(self, rates: impl Into<Vec<u8>>) -> Self

Append a Supported Rates tagged parameter.

pub fn ds_parameter_set(self, current_channel: u8) -> Self

Append a DS Parameter Set tagged parameter with the current channel.

pub fn tim(self, data: impl Into<Vec<u8>>) -> Self

Append a raw TIM tagged parameter.

pub fn rsn(self, data: impl Into<Vec<u8>>) -> Self

Append a raw RSN tagged parameter.

pub fn with_rsn_information(self, rsn: &RsnInformation) -> Result<Self>

Append an RSN tagged parameter from typed RSN information.

pub fn frame_control_value(&self) -> Dot11FrameControl

Current frame-control value.

pub fn frame_type(&self) -> Dot11FrameType

Current typed frame type.

pub fn management_subtype(&self) -> Option<Dot11ManagementSubtype>

Current typed management subtype, when applicable.

pub fn control_subtype(&self) -> Option<Dot11ControlSubtype>

Current typed control subtype, when applicable.

pub fn data_subtype(&self) -> Option<Dot11DataSubtype>

Current typed data subtype, when applicable.

pub fn duration_id_value(&self) -> Option<u16>

Current duration/ID field value, if present.

pub fn addr1_value(&self) -> Option<MacAddr>

Current address 1 value, if present.

pub fn addr2_value(&self) -> Option<MacAddr>

Current address 2 value, if present.

pub fn addr3_value(&self) -> Option<MacAddr>

Current address 3 value, if present.

pub fn addr4_value(&self) -> Option<MacAddr>

Current address 4 value, if present.

pub fn receiver(&self) -> Option<MacAddr>

Receiver address for data, management, or supported control frames.

pub fn transmitter(&self) -> Option<MacAddr>

Transmitter address for data, management, or supported two-address control frames.

pub fn destination(&self) -> Option<MacAddr>

Destination address for data or management frames.

pub fn source(&self) -> Option<MacAddr>

Source address for data or management frames.

pub fn bssid(&self) -> Option<MacAddr>

BSSID address for data or management frames when the role is defined.

pub fn fourth_address(&self) -> Option<MacAddr>

Fourth address for four-address data frames when present.

pub fn sequence_control_value(&self) -> Option<Dot11SequenceControl>

Current sequence-control field value, if present.

pub fn sequence_number_value(&self) -> Option<u16>

Current sequence-number subfield value, if the frame has sequence control.

pub fn fragment_number_value(&self) -> Option<u8>

Current fragment-number subfield value, if the frame has sequence control.

pub fn qos_control_value(&self) -> Option<u16>

Current QoS control field value, if present.

pub fn qos_control_fields(&self) -> Option<Dot11QosControl>

Current typed QoS control field value, if present.

pub fn ht_control_value(&self) -> Option<u32>

Current HT Control field value, if present.

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

Raw fixed management-field bytes.

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

Raw fixed management-field bytes, including unsupported or malformed shapes.

pub fn management_fixed_fields(&self) -> Dot11ManagementFixedFields<'_>

Typed management fixed fields, or raw bytes when the shape is unsupported.

pub fn beacon_fixed_fields(&self) -> Option<Dot11BeaconFixedFields>

Beacon fixed fields when this frame has the supported Beacon shape.

pub fn probe_response_fixed_fields(&self) -> Option<Dot11BeaconFixedFields>

Probe Response fixed fields when this frame has the supported shape.

pub fn association_request_fixed_fields( &self, ) -> Option<Dot11AssociationRequestFixedFields>

Association Request fixed fields when this frame has the supported shape.

pub fn association_response_fixed_fields( &self, ) -> Option<Dot11AssociationResponseFixedFields>

Association Response fixed fields when this frame has the supported shape.

pub fn reassociation_request_fixed_fields( &self, ) -> Option<Dot11ReassociationRequestFixedFields>

Reassociation Request fixed fields when this frame has the supported shape.

pub fn reassociation_response_fixed_fields( &self, ) -> Option<Dot11AssociationResponseFixedFields>

Reassociation Response fixed fields when this frame has the supported shape.

pub fn authentication_fixed_fields( &self, ) -> Option<Dot11AuthenticationFixedFields>

Authentication fixed fields when this frame has the supported shape.

pub fn deauthentication_fixed_fields( &self, ) -> Option<Dot11ReasonCodeFixedFields>

Deauthentication fixed fields when this frame has the supported shape.

pub fn disassociation_fixed_fields(&self) -> Option<Dot11ReasonCodeFixedFields>

Disassociation fixed fields when this frame has the supported shape.

pub fn action_fixed_fields(&self) -> Option<Dot11ActionFixedFields>

Action fixed fields when this frame has the supported Action shape.

pub fn tags_value(&self) -> &[Dot11TaggedParameter]

Raw tagged parameters.

pub fn tagged_parameters(&self) -> &[Dot11TaggedParameter]

Raw tagged parameters.

pub fn rsn_information(&self) -> Option<Result<RsnInformation>>

First RSN information element carried by the raw tagged parameters.

pub fn rsn_information_elements( &self, ) -> impl Iterator<Item = Result<RsnInformation>> + '_

RSN information elements carried by the raw tagged parameters.

pub fn is_protected(&self) -> bool

Return true when the Protected Frame bit is set.

pub fn has_more_fragments(&self) -> bool

Return true when the More Fragments frame-control bit is set.

pub fn is_fragmented(&self) -> bool

Return true when this frame carries 802.11 fragmentation metadata.

crafter exposes this metadata for inspection but does not reassemble fragmented 802.11 payloads.

pub fn encrypted_body_len(&self) -> Option<usize>

Decoded encrypted body length for protected data frames.

pub fn minimum_header_len(&self) -> usize

Minimum header length implied by this frame’s type/subtype and flags.

This is the source-backed decode boundary: MAC header fields, optional address four, QoS control, HT Control when signaled by supported +HTC/Order shapes, and selected management fixed fields. It does not include tagged parameters or higher-layer payload bytes.

pub fn minimum_header_len_for(frame_control: Dot11FrameControl) -> usize

Minimum header length implied by a frame-control word.

pub fn header_len_from_bytes(bytes: impl AsRef<[u8]>) -> Result<usize>

Read frame control from bytes, compute the minimum header length, and return a structured error when the buffer is truncated before that boundary.

Trait Implementations

impl Clone for Dot11

fn clone(&self) -> Dot11

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dot11

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

Formats the value using the given formatter.

impl Default for Dot11

fn default() -> Self

Returns the “default value” for a type.

impl<R> Div<R> for Dot11

where R: IntoPacket,

type Output = Packet

The resulting type after applying the / operator.

fn div(self, rhs: R) -> Self::Output

Performs the / operation.

impl Eq for Dot11

impl Layer for Dot11

fn name(&self) -> &'static str

Stable layer name used by summaries and generated tools.

fn summary(&self) -> String

A one-line layer summary.

fn inspection_fields(&self) -> Vec<(&'static str, String)>

Stable field/value pairs used by packet inspection output.

fn encoded_len(&self) -> usize

Encoded length for this layer before dependent auto-fill.

fn compile(&self, _ctx: &LayerContext<'_>, out: &mut Vec<u8>) -> Result<()>

Encode this layer into out.

fn clone_layer(&self) -> Box<dyn Layer>

Clone this layer behind a trait object.

fn as_any(&self) -> &dyn Any

Return this layer as Any for typed packet access.

fn as_any_mut(&mut self) -> &mut dyn Any

Return this layer mutably as Any for typed packet access.

fn into_any(self: Box<Self>) -> Box<dyn Any>

Convert an owned trait object into Any for downcasting.

fn encoded_len_with_context(&self, _ctx: &LayerContext<'_>) -> usize

Encoded length for this layer once neighboring-layer context is known.

fn consumes_following(&self) -> bool

Whether this layer’s compile() emits all following layers itself.

fn transport_checksum_context( &self, _transport_protocol: u8, ) -> Option<TransportChecksumContext>

Return pseudo-header data for a following transport layer, when present.

impl PartialEq for Dot11

fn eq(&self, other: &Dot11) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for Dot11