Lib.rs

› Parser implementations | Network programming
#dhcp #dhcp-server #dhcpv6 #dhcpv4

dhcproto

A DHCP parser and encoder for DHCPv4/DHCPv6. dhcproto aims to be a functionally complete DHCP implementation.

by Evan Cameron and 7 contributors

12 releases (breaking)

0.11.0 Nov 6, 2023
0.9.0 Mar 6, 2023
0.8.0 Jul 6, 2022
0.7.0 Mar 18, 2022
0.1.0 Jul 15, 2021

#130 in Parser implementations

Download history 1837/week @ 2024-01-15 3105/week @ 2024-01-22 2388/week @ 2024-01-29 2125/week @ 2024-02-05 2391/week @ 2024-02-12 1779/week @ 2024-02-19 2306/week @ 2024-02-26 3605/week @ 2024-03-04 3259/week @ 2024-03-11 3759/week @ 2024-03-18 5438/week @ 2024-03-25 3942/week @ 2024-04-01 3964/week @ 2024-04-08 4022/week @ 2024-04-15 3146/week @ 2024-04-22 3546/week @ 2024-04-29

14,874 downloads per month
Used in 5 crates (3 directly)

MIT license

225KB
5K SLoC

dhcproto

A DHCP parser and encoder for DHCPv4/DHCPv6. dhcproto aims to be a functionally complete DHCP implementation. Many common option types are implemented, PRs are welcome to flesh out missing types.

Attention! We are developing a DHCP server using this library called dora!

features

  • v4 is 100% safe rust (v6 uses get_unchecked after bounds have been checked)
  • v4 & v6 Message types
  • v4 & v6 message header getters/setters, all data mutable
  • option types with 100's of fully type safe variants (accepting PR's for unknown variants)
  • Long option encoding supported (RFC 3396) (allows encoding options longer than 255 bytes)
  • benchmarked encoding/decoding

crates.io

https://crates.io/crates/dhcproto

Minimum Rust Version

This crate uses const generics, Rust 1.53 is required

Examples

(v4) Decoding/Encoding

use dhcproto::v4::{Message, Encoder, Decoder, Decodable, Encodable};
// decode
let bytes = dhcp_offer();
let msg = Message::decode(&mut Decoder::new(&bytes))?;
// now encode
let mut buf = Vec::new();
let mut e = Encoder::new(&mut buf);
msg.encode(&mut e)?;

(v4) Constructing messages

use dhcproto::{v4, Encodable, Encoder};
// hardware addr
let chaddr = vec![
    29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44,
];
// construct a new Message
let mut msg = v4::Message::default();
msg.set_flags(v4::Flags::default().set_broadcast()) // set broadcast to true
    .set_chaddr(&chaddr) // set chaddr
    .opts_mut()
    .insert(v4::DhcpOption::MessageType(v4::MessageType::Discover)); // set msg type

// set some more options
msg.opts_mut()
    .insert(v4::DhcpOption::ParameterRequestList(vec![
        v4::OptionCode::SubnetMask,
        v4::OptionCode::Router,
        v4::OptionCode::DomainNameServer,
        v4::OptionCode::DomainName,
    ]));
msg.opts_mut()
    .insert(v4::DhcpOption::ClientIdentifier(chaddr));

// now encode to bytes
let mut buf = Vec::new();
let mut e = Encoder::new(&mut buf);
msg.encode(&mut e)?;
// buf now has the contents of the encoded DHCP message

RFCs supported

DHCPv6:

DHCPv4:

Dependencies

~7MB
~154K SLoC