Struct DhcpPacket

Source

pub struct DhcpPacket<'a> { /* private fields */ }

Expand description

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

Implementations§

Source §

impl<'a> Packet<'a>

Source

pub const fn new_unchecked(buffer: &'a mut [u8]) -> Packet<'a>

Imbue a raw octet buffer with DHCP packet structure.

Source

pub fn new_checked(buffer: &'a mut [u8]) -> Result<Packet<'a>>

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 opcode(&self) -> OpCode

Return the operation code of this packet.

Source

pub fn hardware_type(&self) -> Hardware

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

Source

pub fn hardware_len(&self) -> u8

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

Source

pub fn transaction_id(&self) -> u32

Return 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

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

Only ethernet is supported, so this returns an EthernetAddress.

Source

pub fn hops(&self) -> u8

Return 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

Return 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

Return 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

Return 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

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

Source

pub fn server_ip(&self) -> Ipv4Address

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

Source

pub fn relay_agent_ip(&self) -> Ipv4Address

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

Source

pub fn flags(&self) -> Flags

Return the flags field.

Source

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

Return an iterator over the options.

Iteration stops at the end marker, at the end of the buffer, or at the first malformed option.

Source

pub fn option(&self, kind: u8) -> Option<&[u8]>

Return the data of the first option of the given kind, if present.

Source

pub fn message_type(&self) -> Result<MessageType>

Return the message type, from the message type option.

Errors if the option is missing or malformed.

Source

pub fn get_sname(&self) -> Result<&str>

Return the sname (server name) field as a string.

Errors if it is empty or not valid UTF-8.

Source

pub fn get_boot_file(&self) -> Result<&str>

Return the file (boot file name) field as a string.

Errors if it is empty or not valid UTF-8.

Source

pub fn set_sname_and_boot_file_to_zero(&mut self)

Set 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)

Set the OpCode for the packet.

Source

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

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

Source

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

Set 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)

Set 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)

Set the ethernet address of the client.

Sets the chaddr field.

Source

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

Set 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)

Set 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)

Set 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)

Set 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

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

Set the value of the yiaddr field.

Source

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

Set the value of the siaddr field.

Source

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

Set the value of the giaddr field.

Source

pub fn set_flags(&mut self, val: Flags)

Set the flags to the specified value.

Source

pub fn options_mut(&mut self) -> OptionWriter<'_>

Return a writer for the options field.

Source

pub fn fill_client_header( &mut self, message_type: MessageType, client_hardware_address: EthernetAddress, )

Fill in the fixed part of a client message: opcode, Ethernet hardware type and length, zero hops and secs, zero sname and file, and the magic cookie.

The addresses, flags, transaction ID and options are left for the caller.