Struct DhcpPacket

Source

pub struct DhcpPacket<T: AsRef<[u8]>> { /* private fields */ }

Expand description

A read/write wrapper around a Dynamic Host Configuration Protocol packet buffer.

Implementations§

Source §

impl<T: AsRef<[u8]>> Packet<T>

Source

pub const fn new_unchecked(buffer: T) -> Packet<T>

Imbue a raw octet buffer with DHCP packet structure.

Source

pub fn new_checked(buffer: T) -> Result<Packet<T>>

Shorthand for a combination of new_unchecked and check_len.

Source

pub fn check_len(&self) -> Result<()>

Ensure that no accessor method will panic if called. Returns Err(Error) if the buffer is too short.

Source

pub fn into_inner(self) -> T

Consume the packet, returning the underlying buffer.

Source

pub fn opcode(&self) -> OpCode

Returns the operation code of this packet.

Source

pub fn hardware_type(&self) -> Hardware

Returns the hardware protocol type (e.g. ethernet).

Source

pub fn hardware_len(&self) -> u8

Returns the length of a hardware address in bytes (e.g. 6 for ethernet).

Source

pub fn transaction_id(&self) -> u32

Returns the transaction ID.

The transaction ID (called xid in the specification) is a random number used to associate messages and responses between client and server. The number is chosen by the client.

Source

pub fn client_hardware_address(&self) -> EthernetAddress

Returns the hardware address of the client (called chaddr in the specification).

Only ethernet is supported by smoltcp, so this functions returns an EthernetAddress.

Source

pub fn hops(&self) -> u8

Returns the value of the hops field.

The hops field is set to zero by clients and optionally used by relay agents.

Source

pub fn secs(&self) -> u16

Returns the value of the secs field.

The secs field is filled by clients and describes the number of seconds elapsed since client began process.

Source

pub fn magic_number(&self) -> u32

Returns the value of the magic cookie field in the DHCP options.

This field should be always be 0x63825363.

Source

pub fn client_ip(&self) -> Ipv4Address

Returns the Ipv4 address of the client, zero if not set.

This corresponds to the ciaddr field in the DHCP specification. According to it, this field is “only filled in if client is in BOUND, RENEW or REBINDING state and can respond to ARP requests”.

Source

pub fn your_ip(&self) -> Ipv4Address

Returns the value of the yiaddr field, zero if not set.

Source

pub fn server_ip(&self) -> Ipv4Address

Returns the value of the siaddr field, zero if not set.

Source

pub fn relay_agent_ip(&self) -> Ipv4Address

Returns the value of the giaddr field, zero if not set.

Source

pub fn flags(&self) -> Flags

Source

pub fn options(&self) -> impl Iterator<Item = DhcpOption<'_>> + '_

Return an iterator over the options.

Source

pub fn set_sname_and_boot_file_to_zero(&mut self)

Sets the optional sname (“server name”) and file (“boot file name”) fields to zero.

The fields are not commonly used, so we set their value always to zero. This method must be called when creating a packet, otherwise the emitted values for these fields are undefined!

Source

pub fn set_opcode(&mut self, value: OpCode)

Sets the OpCode for the packet.

Source

pub fn set_hardware_type(&mut self, value: Hardware)

Sets the hardware address type (only ethernet is supported).

Source

pub fn set_hardware_len(&mut self, value: u8)

Sets the hardware address length.

Only ethernet is supported, so this field should be set to the value 6.

Source

pub fn set_transaction_id(&mut self, value: u32)

Sets the transaction ID.

The transaction ID (called xid in the specification) is a random number used to associate messages and responses between client and server. The number is chosen by the client.

Source

pub fn set_client_hardware_address(&mut self, value: EthernetAddress)

Sets the ethernet address of the client.

Sets the chaddr field.

Source

pub fn set_hops(&mut self, value: u8)

Sets the hops field.

The hops field is set to zero by clients and optionally used by relay agents.

Source

pub fn set_secs(&mut self, value: u16)

Sets the secs field.

The secs field is filled by clients and describes the number of seconds elapsed since client began process.

Source

pub fn set_magic_number(&mut self, value: u32)

Sets the value of the magic cookie field in the DHCP options.

This field should be always be 0x63825363.

Source

pub fn set_client_ip(&mut self, value: Ipv4Address)

Sets the Ipv4 address of the client.

This corresponds to the ciaddr field in the DHCP specification. According to it, this field is “only filled in if client is in BOUND, RENEW or REBINDING state and can respond to ARP requests”.

Source