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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

# RFC Compliance


## RFC 2131 - Dynamic Host Configuration Protocol


| Section | Feature | Status |
|---------|---------|--------|
| 2 | Protocol Summary | ✅ |
| 3.1 | Client-server model | ✅ |
| 3.1 | UDP ports 67/68 | ✅ |
| 3.1 | Transaction ID (xid) | ✅ |
| 3.1 | Broadcast flag | ✅ |
| 4.1 | DHCPDISCOVER | ✅ |
| 4.2 | DHCPOFFER | ✅ |
| 4.3 | DHCPREQUEST | ✅ |
| 4.3.1 | REQUEST in SELECTING state | ✅ |
| 4.3.2 | REQUEST in INIT-REBOOT state | ✅ |
| 4.3.4 | REQUEST in RENEWING state | ✅ |
| 4.3.5 | REQUEST in REBINDING state | ✅ |
| 4.3.3 | DHCPINFORM | ✅ |
| 4.4.1 | DHCPACK | ✅ |
| 4.4.2 | DHCPNAK | ✅ |
| 4.4.3 | DHCPRELEASE | ✅ |
| 4.4.4 | DHCPDECLINE | ✅ |
| 4.1 | Relay agent (giaddr) | ✅ |
| 4.1 | Minimum packet size (300 bytes) | ✅ |
| 4.1 | Maximum hop count (16) | ✅ |
| 4.3.1 | Server identifier in REQUEST | ✅ |
| 4.4.1 | Lease time negotiation | ✅ |
| 3.3 | T1/T2 timers | ✅ |
| 4.4.4 | Declined IP quarantine | ✅ (1 hour) |
| 3.5 | Parameter Request List | ✅ |

## RFC 2132 - DHCP Options


| Option | Name | Status |
|--------|------|--------|
| 0 | Pad | ✅ |
| 1 | Subnet Mask | ✅ |
| 3 | Router | ✅ |
| 6 | Domain Name Server | ✅ |
| 12 | Host Name | ✅ |
| 15 | Domain Name | ✅ |
| 26 | Interface MTU | ✅ |
| 28 | Broadcast Address | ✅ |
| 50 | Requested IP Address | ✅ |
| 51 | IP Address Lease Time | ✅ |
| 52 | Option Overload | ✅ (parsing) |
| 53 | DHCP Message Type | ✅ |
| 54 | Server Identifier | ✅ |
| 55 | Parameter Request List | ✅ |
| 58 | Renewal Time (T1) | ✅ |
| 59 | Rebinding Time (T2) | ✅ |
| 61 | Client Identifier | ✅ |
| 255 | End | ✅ |

### Options NOT Implemented


| Option | Name | Reason |
|--------|------|--------|
| 2 | Time Offset | Rarely used |
| 4 | Time Server | Rarely used |
| 5 | Name Server | Obsolete (IEN 116) |
| 7-11 | Various servers | Rarely used |
| 13 | Boot File Size | BOOTP legacy |
| 16 | Swap Server | Rarely used |
| 17 | Root Path | PXE/diskless boot |
| 18 | Extensions Path | Rarely used |
| 19-25 | IP layer params | Rarely needed |
| 27 | All Subnets Local | Rarely used |
| 29-36 | Various | Rarely used |
| 40-49 | NIS/NetBIOS | Legacy |
| 56 | Message | Could add |
| 57 | Maximum Message Size | Could add |
| 60 | Vendor Class ID | Could add |
| 66 | TFTP Server Name | PXE boot |
| 67 | Bootfile Name | PXE boot |

## RFC 3046 - Relay Agent Information Option


| Feature | Status |
|---------|--------|
| Option 82 parsing | ✅ |
| Option 82 echoing | ✅ |
| Sub-option parsing | ❌ (preserved as raw bytes) |

## RFC 4361 - Node-specific Client Identifiers


| Feature | Status |
|---------|--------|
| DUID-based client ID | ✅ (accepts any Option 61) |
| IAID handling | ❌ |

## BOOTP Compatibility (RFC 951)


| Feature | Status |
|---------|--------|
| BOOTREQUEST/BOOTREPLY | ✅ |
| Packets without Option 53 | ✅ (treated as BOOTP) |
| Infinite lease for BOOTP | ✅ |

## Not Implemented


| Feature | RFC | Reason |
|---------|-----|--------|
| DHCPv6 | 8415 | IPv4 only |
| Failover | 7031 | Single server |
| DDNS updates | 4702 | Out of scope |
| Authentication | 3118 | Rarely used |
| Rapid Commit | 4039 | Could add |
| Lease Query | 4388 | Could add |