DHCP Option 119, the Domain Suffix Search List option, allows DHCP servers to provide clients with a prioritized list of domain suffixes for DNS resolution. This is particularly useful in enterprise environments where multiple internal domains exist.
- Windows: Supported since Windows 2000 (all subsequent versions including Win10/11 and Server editions)
- Linux:
- Distros using dhclient (v3.0+): Ubuntu, Debian, RHEL/CentOS 7+
- Systemd-networkd (v230+): Modern Arch, Fedora, openSUSE
- macOS: Supported since Mac OS X 10.2 (Jaguar)
- BSD: FreeBSD 4.3+, OpenBSD 3.4+, NetBSD 2.0+
- Mobile: Android 4.0+, iOS 3.0+
For Linux systems using dhclient, check the lease file:
cat /var/lib/dhcp/dhclient.leases | grep domain-search
Windows systems can verify with:
ipconfig /all | findstr "Suffix"
ISC DHCP Server configuration:
option domain-search "corp.example.com", "example.com";
Windows Server DHCP configuration (PowerShell):
Set-DhcpServerv4OptionValue -OptionId 119 -Value "corp.example.com,example.com"
- Ensure clients request the option: Check for
request domain-search
in dhclient.conf - Verify option length: Maximum of 255 bytes total for all domains
- Check for DNS resolution issues after implementation
For Linux systems that don't natively process Option 119, you can use a dhclient exit hook:
#!/bin/bash
if [ -n "$new_domain_search" ]; then
echo "search $new_domain_search" > /etc/resolv.conf
fi
DHCP Option 119 (Domain Suffix Search List) allows DHCP servers to provide clients with a prioritized list of domain suffixes for DNS resolution. This eliminates the need for manual domain suffix configuration and enables seamless network access across multiple domains. The option's format consists of a compressed list of domain names using name compression as specified in RFC 1035.
Early implementations showed limited support across operating systems. Windows clients prior to Windows 7 and Linux distributions before 2009 typically lacked native support, requiring manual workarounds or third-party DHCP clients.
Windows Family
Fully supported in:
- Windows 7 and later (including Server 2008 R2+)
- Windows 10/11 all versions
- Windows Server 2012 R2 through 2022
Linux Distributions
Support varies by DHCP client implementation:
# Example dhclient.conf configuration for Option 119
interface "eth0" {
request domain-search;
require domain-search;
}
Supported in:
- ISC dhclient 4.1+ (common in RHEL/CentOS 6+, Ubuntu 12.04+)
- systemd-networkd 230+ (default in recent Debian/Ubuntu)
- NetworkManager 1.4+ with dhclient backend
macOS and BSD Variants
- macOS 10.6 (Snow Leopard) and later
- FreeBSD 8.0+ with ISC dhclient
- OpenBSD 5.5+ using dhcpleased
Mobile Platforms
- Android 4.0+ (implementation varies by vendor)
- iOS 5.0+
Windows Verification
PS C:\> Get-DnsClient | Select-Object ConnectionSpecificSuffixSearchList
Linux Verification
$ cat /etc/resolv.conf
# Generated by dhclient
search example.com corp.example.com
When implementing Option 119 in mixed environments:
- Test legacy client fallback behavior
- Monitor DNS query patterns after deployment
- Consider combining with Option 15 (Domain Name) for backward compatibility
Common issues include:
- Option 119 being ignored due to client misconfiguration
- Conflicts with manually configured search domains
- Maximum search list length limitations (typically 256 bytes total)
ISC DHCP Server
option domain-search code 119 = domain-list;
option domain-search "example.com", "corp.example.com";
Windows DHCP Server
Configure through DHCP Manager under Server Options:
- Right-click "Server Options"
- Select "Configure Options"
- Check option 119 and enter domain suffixes
Emerging implementations include:
- DHCPv6 Option 24 support for IPv6-only networks
- Cloud-init integration for cloud instances
- Container runtime support in Kubernetes CNI plugins