dhcpcd  7.2.2
About: dhcpcd is a RFC2131 compliant DHCP (Dynamic Host Configuration Protocol) client.
  Fossies Dox: dhcpcd-7.2.2.tar.xz  ("inofficial" and yet experimental doxygen-generated source code documentation)  

dhcpcd Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steel blue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies dhcpcd-7.2.2.tar.xz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).


dhcpcd is a DHCP and a DHCPv6 client. It's also an IPv4LL (aka ZeroConf) client. In layman's terms, dhcpcd runs on your machine and silently configures your computer to work on the attached networks without trouble and mostly without configuration.

If you're a desktop user then you may also be interested in Network Configurator (dhcpcd-ui) which sits in the notification area and monitors the state of the network via dhcpcd. It also has a nice configuration dialog and the ability to enter a pass phrase for wireless networks.

dhcpcd may not be the only daemon running that wants to configure DNS on the host, so it uses openresolv to ensure they can co-exist.

See BUILDING.md for how to build dhcpcd.

If you wish to file a support ticket or help out with development, please visit the Development Area or join the mailing list below.


You should read the dhcpcd.conf man page and put your options into /etc/dhcpcd.conf. The default configuration file should work for most people just fine. Here it is, in case you lose it.

# A sample configuration for dhcpcd.
# See dhcpcd.conf(5) for details.

# Allow users of this group to interact with dhcpcd via the control socket.
#controlgroup wheel

# Inform the DHCP server of our hostname for DDNS.

# Use the hardware address of the interface for the Client ID.
# or
# Use the same DUID + IAID as set in DHCPv6 for DHCPv4 ClientID as per RFC4361.
# Some non-RFC compliant DHCP servers do not reply with this set.
# In this case, comment out duid and enable clientid above.

# Persist interface configuration when dhcpcd exits.

# Rapid commit support.
# Safe to enable by default because it requires the equivalent option set
# on the server to actually work.
option rapid_commit

# A list of options to request from the DHCP server.
option domain_name_servers, domain_name, domain_search, host_name
option classless_static_routes
# Respect the network MTU. This is applied to DHCP routes.
option interface_mtu

# Most distributions have NTP support.
#option ntp_servers

# A ServerID is required by RFC2131.
require dhcp_server_identifier

# Generate SLAAC address using the Hardware Address of the interface
#slaac hwaddr
# OR generate Stable Private IPv6 Addresses based from the DUID
slaac private

The dhcpcd man page has a lot of the same options and more, which only apply to calling dhcpcd from the command line.


dhcpcd-5 is only fully command line compatible with dhcpcd-4 For compatibility with older versions, use dhcpcd-4


dhcpcd-7 defaults the database directory to /var/db/dhcpcd instead of /var/db and now stores dhcpcd.duid and dhcpcd.secret in there instead of in /etc. The Makefile _confinstall target will attempt to move the files correctly from the old locations to the new locations. Of course this won't work if dhcpcd-7 is packaged up, so packagers will need to install similar logic into their dhcpcd package.


We no longer supply a ChangeLog. However, you're more than welcome to read the commit log and archived release announcements.