Struct Ipv4Builder 

pub struct Ipv4Builder { /* private fields */ }

Builder for IPv4 packets.

Example

use stackforge_core::layer::ipv4::{Ipv4Builder, protocol};
use std::net::Ipv4Addr;

let packet = Ipv4Builder::new()
    .src(Ipv4Addr::new(192, 168, 1, 1))
    .dst(Ipv4Addr::new(192, 168, 1, 2))
    .ttl(64)
    .protocol(protocol::TCP)
    .dont_fragment()
    .build();

assert_eq!(packet.len(), 20); // Minimum header, no payload

Implementations

impl Ipv4Builder

pub fn new() -> Self

Create a new IPv4 builder with default values.

pub fn from_bytes(data: &[u8]) -> Result<Self, FieldError>

Create a builder initialized from an existing packet.

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

Set the IP version (should normally be 4).

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

Set the Internet Header Length (in 32-bit words). If not set, will be calculated automatically.

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

Set the Type of Service field.

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

Set the DSCP (Differentiated Services Code Point).

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

Set the ECN (Explicit Congestion Notification).

pub fn total_len(self, len: u16) -> Self

Set the total length field. If not set, will be calculated automatically.

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

Alias for total_len (Scapy compatibility).

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

Set the identification field.

pub fn flags(self, flags: Ipv4Flags) -> Self

Set the flags field.

pub fn dont_fragment(self) -> Self

Set the Don’t Fragment flag.

pub fn allow_fragment(self) -> Self

Clear the Don’t Fragment flag.

pub fn more_fragments(self) -> Self

Set the More Fragments flag.

pub fn evil(self) -> Self

Set the reserved/evil bit.

pub fn frag_offset(self, offset: u16) -> Self

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

pub fn frag_offset_bytes(self, offset: u32) -> Self

Set the fragment offset in bytes (will be divided by 8).

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

Set the TTL (Time to Live).

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

Set the protocol number.

pub fn proto(self, protocol: u8) -> Self

Alias for protocol (Scapy compatibility).

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

Set the checksum manually. If not set, will be calculated automatically.

pub fn chksum(self, checksum: u16) -> Self

Alias for checksum (Scapy compatibility).

pub fn src(self, src: Ipv4Addr) -> Self

Set the source IP address.

pub fn dst(self, dst: Ipv4Addr) -> Self

Set the destination IP address.

pub fn options(self, options: Ipv4Options) -> Self

Set the options.

pub fn option(self, option: Ipv4Option) -> Self

Add a single option.

pub fn with_options<F>(self, f: F) -> Self

where F: FnOnce(Ipv4OptionsBuilder) -> Ipv4OptionsBuilder,

Add options using a builder function.

pub fn record_route(self, slots: usize) -> Self

Add a Record Route option.

pub fn lsrr(self, route: Vec<Ipv4Addr>) -> Self

Add a Loose Source Route option.

pub fn ssrr(self, route: Vec<Ipv4Addr>) -> Self

Add a Strict Source Route option.

pub fn router_alert(self, value: u16) -> Self

Add a Router Alert option.

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

Set the payload data.

pub fn append_payload(self, data: &[u8]) -> Self

Append data to the payload.

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

Enable or disable automatic checksum calculation.

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

Enable or disable automatic length calculation.

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

Enable or disable automatic IHL calculation.

pub fn header_size(&self) -> usize

Calculate the header size (including options).

pub fn packet_size(&self) -> usize

Calculate the total packet size.

pub fn build(&self) -> Vec<u8>

Build the IPv4 packet.

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

Build the IPv4 packet into an existing buffer.

pub fn build_header(&self) -> Vec<u8>

Build only the header (no payload).

impl Ipv4Builder

pub fn icmp() -> Self

Create an ICMP packet builder.

pub fn tcp() -> Self

Create a TCP packet builder.

pub fn udp() -> Self

Create a UDP packet builder.

pub fn ipip() -> Self

Create an IP-in-IP tunnel packet builder.

pub fn gre() -> Self

Create a GRE tunnel packet builder.

pub fn to(dst: Ipv4Addr) -> Self

Create a packet destined for a specific address.

pub fn from(src: Ipv4Addr) -> Self

Create a packet from a specific source.

impl Ipv4Builder

pub fn random_id(self) -> Self

Set a random ID.

Trait Implementations

impl Clone for Ipv4Builder

fn clone(&self) -> Ipv4Builder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ipv4Builder

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

Formats the value using the given formatter.

impl Default for Ipv4Builder

fn default() -> Self

Returns the “default value” for a type.

impl From<Ipv4Builder> for LayerStack

fn from(builder: Ipv4Builder) -> Self

Converts to this type from the input type.

impl IntoLayerStackEntry for Ipv4Builder

fn into_layer_stack_entry(self) -> LayerStackEntry