Skip to main content

Ipv4Layer

Struct Ipv4Layer 

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

A view into an IPv4 packet header.

Fields§

§index: LayerIndex

Implementations§

Source§

impl Ipv4Layer

Source

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

Create a new IPv4 layer view with specified bounds.

Source

pub const fn at_start() -> Self

Create a layer at offset 0 with minimum header length.

Source

pub const fn at_offset(offset: usize) -> Self

Create a layer at the specified offset with minimum header length.

Source

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

Create a layer at offset, calculating actual header length from IHL.

Source

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

Validate that the buffer contains a valid IPv4 header at the offset.

Source

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

Calculate the actual header length from the buffer.

Source

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

Get the options length (header length - 20).

Source

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

Read the version field (should be 4).

Source

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

Read the Internet Header Length (in 32-bit words).

Source

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

Read the header length in bytes.

Source

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

Read the Type of Service (TOS) field.

Source

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

Read the DSCP (Differentiated Services Code Point).

Source

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

Read the ECN (Explicit Congestion Notification).

Source

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

Read the total length field.

Source

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

Read the identification field.

Source

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

Read the flags as a structured type.

Source

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

Read the raw flags byte (upper 3 bits of flags/frag field).

Source

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

Read the fragment offset (in 8-byte units).

Source

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

Read the fragment offset in bytes.

Source

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

Read the Time to Live field.

Source

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

Read the protocol field.

Source

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

Read the header checksum.

Source

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

Read the source IP address.

Source

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

Read the destination IP address.

Source

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

Read the options bytes (if any).

Source

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

Parse and return the options.

Source

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

Set the version field.

Source

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

Set the IHL field.

Source

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

Set the TOS field.

Source

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

Set the DSCP field.

Source

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

Set the ECN field.

Source

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

Set the total length field.

Source

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

Set the identification field.

Source

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

Set the flags field.

Source

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

Set the fragment offset (in 8-byte units).

Source

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

Set the TTL field.

Source

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

Set the protocol field.

Source

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

Set the checksum field.

Source

pub fn set_src(&self, buf: &mut [u8], src: Ipv4Addr) -> Result<(), FieldError>

Set the source IP address.

Source

pub fn set_dst(&self, buf: &mut [u8], dst: Ipv4Addr) -> Result<(), FieldError>

Set the destination IP address.

Source

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

Compute and set the header checksum.

Source

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

Verify the header checksum.

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 field_names() -> &'static [&'static str]

Get list of field names.

Source

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

Check if this is a fragment.

Source

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

Check if this is the first fragment.

Source

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

Check if this is the last fragment.

Source

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

Check if the Don’t Fragment flag is set.

Source

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

Get the payload length (total_len - header_len).

Source

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

Get a slice of the payload data.

Source

pub fn header_bytes<'a>(&self, buf: &'a [u8]) -> &'a [u8]

Get the header bytes.

Source

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

Copy the header bytes.

Source

pub fn protocol_name(&self, buf: &[u8]) -> &'static str

Get the protocol name.

Source

pub fn next_layer(&self, buf: &[u8]) -> Option<LayerKind>

Determine the next layer kind based on protocol.

Source

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

Compute hash for packet matching (like Scapy’s hashret).

Source

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

Check if this packet answers another (for sr() matching).

Source

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

Extract padding from the packet. Returns (payload, padding) tuple.

Source

pub fn route(&self, buf: &[u8]) -> Ipv4Route

Get routing information for this packet.

Source

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

Estimate the original TTL.

Source

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

Estimate the number of hops.

Trait Implementations§

Source§

impl Clone for Ipv4Layer

Source§

fn clone(&self) -> Ipv4Layer

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 Ipv4Layer

Source§

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

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

impl From<Ipv4Layer> for LayerEnum

Source§

fn from(v: Ipv4Layer) -> LayerEnum

Converts to this type from the input type.
Source§

impl Layer for Ipv4Layer

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, buf: &[u8]) -> Vec<u8>

Compute a hash for packet matching.
Source§

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

Check if this packet answers another packet.
Source§

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

Extract padding from the packet.
Source§

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

Get the list of field names for this layer
Source§

impl LayerDispatch for Ipv4Layer

Source§

fn dispatch_kind(&self) -> LayerKind

Get the kind of this layer.
Source§

fn dispatch_index(&self) -> &LayerIndex

Get the layer index (start/end offsets).
Source§

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

Get a human-readable summary.
Source§

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

Get the header length in bytes.
Source§

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

Compute a hash for packet matching.
Source§

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

Get field names for this layer type.
Source§

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

Get a field value by name.
Source§

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

Set a field value by name.
Source§

fn dispatch_show_fields(&self, buf: &[u8]) -> Vec<(&'static str, String)>

Get show-fields output.
Source§

impl TryInto<Ipv4Layer> for LayerEnum

Source§

type Error = &'static str

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

fn try_into(self) -> Result<Ipv4Layer, <Self as TryInto<Ipv4Layer>>::Error>

Performs the conversion.

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> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
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