dhcplease 0.2.1

A cross-platform DHCP server library and CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! # dhcplease
//!
//! A DHCP server library implementing RFC 2131 (DHCP) and RFC 2132 (DHCP Options).
//!
//! ## Features
//!
//! - Full DHCP protocol: DISCOVER, OFFER, REQUEST, ACK, NAK, RELEASE, DECLINE, INFORM
//! - BOOTP compatibility for legacy clients
//! - Static MAC-to-IP bindings
//! - Lease persistence across restarts
//! - Relay agent support (Option 82)
//! - Rate limiting per client
//! - Async/await with Tokio
//!
//! ## Quick Start
//!
//! ```no_run
//! use dhcplease::{Config, DhcpServer};
//!
//! #[tokio::main]
//! async fn main() -> dhcplease::Result<()> {
//!     let config = Config::load_or_create("config.json").await?;
//!     let server = DhcpServer::new(config).await?;
//!     server.run().await
//! }
//! ```
//!
//! ## Architecture
//!
//! - [`Config`] - Server configuration (IP pool, lease duration, DNS, etc.)
//! - [`DhcpServer`] - Main server that listens on UDP port 67
//! - [`Leases`] - Thread-safe lease manager with persistence
//! - [`DhcpPacket`] - DHCP packet parsing and encoding
//! - [`DhcpOption`] - DHCP option types per RFC 2132

pub mod config;
pub mod error;
pub mod lease;
pub mod options;
pub mod packet;
pub mod server;

pub use config::{Config, StaticBinding, normalize_mac, sanitize_domain_name, sanitize_hostname};
pub use error::{Error, Result};
pub use lease::{Lease, Leases};
pub use options::{DhcpOption, MessageType};
pub use packet::DhcpPacket;
pub use server::{DHCP_CLIENT_PORT, DHCP_SERVER_PORT, DhcpServer};