نمایش مبدأ برای Dhcpcd

{{Translateme|این صفحه نیاز به ترجمه دارد.}}

''dhcpcd'' یک کلاینت برای DHCP و DHCPv6 است. این کلاینت هم‌اکنون بیشترین امکانات را در در میان کلاینت‌های متن‌باز DHCP دارد. برای دیدن فهرست امکانات آن [https://roy.marples.name/projects/dhcpcd این پیوند] را ببینید.

{{نکته|''dhcpcd'' (منظور دیمون کلاینت DHCP) همان [[dhcpd]] (منظور دیمون سرور DHCP) ''نیست''.}}

== نصب ==

بسته {{Pkg|dhcpcd}} بخشی از مجموعه بسته های {{Grp|base}} میباشد، پس به احتمال زیاد این بسته هم‌اکنون بر روی سیستم شما نصب میباشد

{{AUR|dhcpcd-ui}} یک رابط گرافیکی ساخته شده بر پایه [[GTK+]] برای دیمون ''dhcpcd'' بوده که میتوانید از طریق مخزن [[AUR]] به نصب ان اقدام نمایید. این رابط به شما اجازه انتخاب و اعمال رمز عبور برای برای یک شبکه بدون سیم را میدهد.

== اجرا ==
برای فعال کردن این دیمون بر روی تمامی رابط های ارتباطی شبکه سرویس {{ic|dhcpcd.service}} را اجرا یا فعال نمایید.

برای فعال کردن این سرویس بر روی رابط خاص به شکل {{ic|dhcpcd@''interface''.service}} عمل نمایید.

یا برای اجرای این سرویس به صورت دستی از دستور زیر استفاده نمایید.

 # dhcpcd ''interface''

در تمامی مراحل بالا به سیستم شما یک ادرس آی پی متغییر تعلق میگیرد. اگر خواهان ادرس آی پی ایستا(static) هستید [[#Static profile]] را مشاهده کنید.

== تنظیمات ==

تنظیمات اصلی در فایل {{ic|/etc/dhcpcd.conf}} انجام میگیرد. جهت اطلاعات بیشتر به {{man|5|dhcpcd.conf}} مراجعه کنید. در پایین به برخی از پر استفاده ترین تنظیمات میپردازیم.

=== مسیر ایستای DHCP ===
اگر نیاز به یک مسیر ایستای سمت کلاینت دارید، دستور زیر را به {{ic|/etc/dhcpcd.exit-hook}} اضافه کنید. مثال زیر یک هوک-اسکریپت رادنشان می‌دهد که یک مسیر ایستا به یک VPN subnet در {{ic|10.11.12.0/24}} توسط یک gateway در {{ic|192.168.192.5}} اضافه می‌کند:

{{hc|/etc/dhcpcd.exit-hook|
ip route add 10.11.12.0/24 via 192.168.192.5
}}

همچنین می‌توانید چندین مسیر به این پرونده اضافه کنید.

=== DHCP Client Identifier ===

The DHCP client may be uniquely identified in different ways by the server: 
# hostname (or the hostname value sent by the client), 
# MAC address of the network interface controller through which the connection is being made, linked to this is the third, 
# Identity Association ID (IAID), which is an abstraction layer to differentiate different use-cases and/or interfaces on a single host, 
# DHCP Unique Identifier (DUID). 
For a further description, see [https://tools.ietf.org/html/rfc3315#section-4.2 RFC 3315]. 

It depends on the DHCP-server configuration which options are optional or required to request a DHCP IP lease. 
{{Note|The ''dhcpcd'' default configuration should be sufficient usually. The listed identifiers are determined automatically and manual configuration changes only be required in case of problems.}} 

If the ''dhcpcd'' default configuration fails to obtain an IP, the following options are available to use in {{ic|dhcpcd.conf}}: 
* {{ic|hostname}} sends the hostname set in {{ic|/etc/hostname}}
* {{ic|clientid}} sends the MAC address as identifier
* {{ic|iaid <interface>}} derives the IAID to use for DHCP discovery. It has to be used in an interface block (started by {{ic|interface <interface>}}, see [https://bbs.archlinux.org/viewtopic.php?pid=1388376#p1388376]), but more frequently the next option is used:  
* {{ic|duid}} triggers using a combination of DUID and IAID as identifier. 

The DUID value is set in {{ic|/var/lib/dhcpcd/duid}}. For efficient DHCP lease operation it is important that it is unique for the system and applies to all network interfaces alike, while the IAID represents an identifier for each of the systems' interfaces (see [https://tools.ietf.org/html/rfc4361#section-6.1 RFC 4361]). 

Care must be taken on a network running [[Wikipedia:Dynamic DNS|Dynamic DNS]] to ensure that all three IDs are unique. If duplicate DUID values are presented to the DNS server, e.g. in the case where a virtual machine has been cloned and the hostname and MAC have been made unique but the DUID has not been changed, then the result will be that as each client with the duplicated DUID requests a lease the server will remove the predecessor from the DNS record.

=== Static profile ===

Required settings are explained in [[Network configuration]]. These typically include the [[network interface]] name, ''IP address'', ''router address'', and ''name server''.

Configure a static profile for ''dhcpcd'' in {{ic|/etc/dhcpcd.conf}}, for example: 

{{hc|1=/etc/dhcpcd.conf|2=
interface eth0
static ip_address=192.168.0.10/24	
static routers=192.168.0.1
static domain_name_servers=192.168.0.1 8.8.8.8
}}

More complicated configurations are possible, for example combining with the {{ic|arping}} option. See {{man|5|dhcpcd.conf}} for details.

==== Fallback profile ====

It is possible to configure a static profile within ''dhcpcd'' and fall back to it when DHCP lease fails. This is useful particularly for [[wikipedia:Headless computer|headless machines]], where the static profile can be used as "recovery" profile to ensure that it is always possible to connect to the machine.

The following example configures a {{ic|static_eth0}} profile with {{ic|192.168.1.23}} as IP address, {{ic|192.168.1.1}} as gateway and name server, and makes this profile fallback for interface {{ic|eth0}}.

{{hc|1=/etc/dhcpcd.conf|2=
# define static profile
profile static_eth0
static ip_address=192.168.1.23/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1

# fallback to static profile on eth0
interface ''eth0''
fallback static_eth0
}}

== Hooks ==

''dhcpcd'' executes all scripts found in {{ic|/usr/lib/dhcpcd/dhcpcd-hooks/}} in a lexical order. See {{man|5|dhcpcd.conf}} and {{man|8|dhcpcd-run-hooks}} for details.

{{Note|
* Each script can be disabled using the {{ic|nohook}} option in {{ic|dhcpcd.conf}}.
* The {{ic|env}} option can be used to set an environment variable for '''all''' hooks. For example, you can force the hostname hook to always set the hostname with {{ic|1=env force_hostname=YES}}.
}}

{{Expansion|describe (at least some) provided hooks.}}

=== 10-wpa_supplicant ===

Enable this hook by creating a symbolic link (to ensure that always the current version is used, even after package updates):

 # ln -s /usr/share/dhcpcd/hooks/10-wpa_supplicant /usr/lib/dhcpcd/dhcpcd-hooks/

The {{ic|10-wpa_supplicant}} hook, if enabled, automatically launches [[WPA supplicant]] on wireless interfaces. It is started only if:

* no ''wpa_supplicant'' process is already listening on that interface.
* a ''wpa_supplicant'' configuration file exists. ''dhcpcd'' checks

 /etc/wpa_supplicant/wpa_supplicant-''interface''.conf
 /etc/wpa_supplicant/wpa_supplicant.conf
 /etc/wpa_supplicant-''interface''.conf
 /etc/wpa_supplicant.conf

by default, in that order, but a custom path can be set by adding {{ic|1=env wpa_supplicant_conf=''configuration_file_path''}} into {{ic|/etc/dhcpcd.conf}}.

{{Note|The hook stops at the first configuration file found, thus you should take this into consideration if you have several ''wpa_supplicant'' configuration files, otherwise ''dhcpcd'' might end up using the wrong file.}}

If you manage wireless connections with ''wpa_supplicant'' itself, the hook may create unwanted connection events. For example, if you stop ''wpa_supplicant'' the hook may bring the interface up again. Also, if you use [[Netctl#Special systemd units|netctl-auto]], ''wpa_supplicant'' is started automatically with {{ic|/run/network/wpa_supplicant_''interface''.conf}} for config, so starting it again from the hook is unnecessary and may result in boot-time parse errors of the {{ic|/etc/wpa_supplicant/wpa_supplicant.conf}} file, which only contains dummy values in the default packaged version. 

To disable the hook, add {{ic|nohook wpa_supplicant}} to {{ic|dhcpcd.conf}}.

== Tips and tricks ==

=== Speed up DHCP by disabling ARP probing ===

''dhcpcd'' contains an implementation of a recommendation of the DHCP standard ([https://www.ietf.org/rfc/rfc2131.txt RFC2131] section 2.2) to check via ARP if the assigned IP address is really not taken. This seems mostly useless in home networks, so you can save about 5 seconds on every connect by adding the following line to {{ic|/etc/dhcpcd.conf}}:

 noarp

This is equivalent to passing {{ic|--noarp}} to {{ic|dhcpcd}}, and disables the described ARP probing, speeding up connections to networks with DHCP.

=== Remove old DHCP lease ===

The file {{ic|/var/lib/dhcpcd/''interface''.lease}}, where {{ic|''interface''}} is the name of the interface on which you have a lease, contains the actual DHCP lease reply sent by the DHCP server. For a wireless interface, the filename is {{ic|/var/lib/dhcpcd/''interface''-''ssid''.lease}}, where {{ic|''ssid''}} is the name of the wireless network. It is used to determine the last lease from the server, and its {{ic|mtime}} attribute is used to determine when it was issued. This last lease information is then used to request the same IP address previously held on a network, if it is available. If you do not want that, simply delete this file. 

If the DHCP server still assigns the same IP address, this may happen because it is configured to keep the assignment stable and recognizes the requesting DHCP client id or DUID (see [[#DHCP Client Identifier]]). You can test it by stopping ''dhcpcd'' and removing or renaming {{ic|/var/lib/dhcpcd/duid}}. ''dhcpcd'' will generate a new one on next run. 

Keep in mind that the DUID is intended as persistent machine identifier across reboots and interfaces. If you are transferring the system to new computer, preserving this file should make it appear as old one.

=== Different IPs when multi-booting ===

If you are dualbooting Arch and OS X or Windows and want each to receive different IP addresses, you can exert control about the IPs leased by specifying a different DUID in each operating system installation. 

In Windows (post XP) the DUID should be stored in the 
 \HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters\Dhcpv6DUID 
registry key. 

On OS X it is directly accessible in {{ic|Network\adapter\dhcp preferences panel}}.

If you are using a [[dnsmasq]] DHCP server, the different DUIDs can be used in appropriate {{ic|1=dhcp-host=}} rules in its configuration.

=== resolv.conf ===

''dhcpcd''' by default overwrites [[resolv.conf]].

This can be stopped by adding the following to the last section of {{ic|/etc/dhcpcd.conf}}: 

 nohook resolv.conf

Alternatively, you can create a file called {{ic|/etc/resolv.conf.head}} containing your DNS servers. ''dhcpcd'' will prepend this file to the beginning of {{ic|/etc/resolv.conf}}.

Or you can configure dhcpcd to use the same DNS servers every time. To do this, add the following line at the end of your {{ic|/etc/dhcpcd.conf}}, where {{ic|''dns-server-ip-addressses''}} is a space separated list of DNS IP addresses.

 static domain_name_servers=''dns-server-ip-addresses''

For example, to set it to Google's DNS servers:

 static domain_name_servers=8.8.8.8 8.8.4.4

== Troubleshooting ==

=== Client ID ===

If you are on a network with DHCPv4 that filters Client IDs based on MAC addresses, you may need to change the following line:

{{hc|/etc/dhcpcd.conf|
# Use the same DUID + IAID as set in DHCPv6 for DHCPv4 Client ID as per RFC4361. 
duid
}}

To:

{{hc|/etc/dhcpcd.conf|
# Use the hardware address of the interface for the Client ID (DHCPv4).
clientid
}}

Else, you may not obtain a lease since the DHCP server may not read your [[wikipedia:DHCPv6|DHCPv6-style]] Client ID correctly. See [https://tools.ietf.org/html/rfc4361 RFC 4361] for more information.

=== Check DHCP problem by releasing IP first ===

A problem may occur when DHCP gets a wrong IP assignment, such as when two routers are tied together through a VPN. The router that is connected through the VPN may be assigning IP address. To fix it, as root, release the IP address:

 # dhcpcd -k

Then request a new one:

 # dhcpcd

You may have to run those two commands many times.

=== Problems with noncompliant routers ===

For some (noncompliant) routers, you will not be able to connect properly unless you comment the line

 require dhcp_server_identifier

in {{ic|/etc/dhcpcd.conf}}. This should not cause issues unless you have multiple DHCP servers on your network (not typical); see [https://technet.microsoft.com/en-us/library/cc977442.aspx this page] for more information.

=== dhcpcd and systemd network interfaces  ===

{{ic|dhcpcd.service}} can be [[enabled]] without specifying an interface. This may, however, create a race condition at boot with ''systemd-udevd'' trying to apply a predictable network interface name: 
 error changing net interface name wlan0 to wlp4s0: Device or resource busy" 

To avoid it, enable ''dhcpcd'' per interface it should bind to as described in [[#Running]]. The downside of the template unit is, however, that it does not support hot-plugging of a wired connection and will fail if the network cable is not connected. To work-around the failure, see [[#Timeout delay]].

It is also possible to use {{ic|denyinterfaces}} or {{ic|allowinterfaces}} in {{man|5|dhcpcd.conf}} to stop dhcpcd from binding to kernel names, for example

 denyinterfaces wlan* eth*

=== Timeout delay ===

If ''dhcpcd'' operates on a single interface and fails to obtain a lease after 30 seconds (for example when the server is not ready or the cable not plugged), it will exit with an error. 

To have ''dhcpcd'' wait indefinitely for one-time, [[edit]] the unit and set the {{ic|timeout}} option to {{ic|0}}:

{{hc|/etc/systemd/system/dhcpcd@.service.d/timeout.conf|2=
[Service]
ExecStart=
ExecStart=/usr/bin/dhcpcd -w -q '''-t 0''' %I
}}

To have it wait indefinitely, let the unit restart after it exited: 

{{hc|/etc/systemd/system/dhcpcd@.service.d/dhcpcdrestart.conf|2=
[Service]
Restart=always
}}

== Known issues ==

=== dhcpcd@.service causes slow startup ===

By default the {{ic|dhcpcd@.service}} waits to get an IP address before forking into the background via the {{ic|-w}} flag for ''dhcpcd''. If the unit is enabled, this may cause the boot to wait for an IP address before continuing. To fix this, create a [[systemd#Drop-in files|drop-in file]] for the unit with the following:

{{hc|/etc/systemd/system/dhcpcd@.service.d/no-wait.conf|2=
[Service]
ExecStart=
ExecStart=/usr/bin/dhcpcd -b -q %I
}}

See also {{Bug|49685}}.

=== dhcpcd does not remove IP address from interface on release ===

{{Remove|Bug was fixed.}}

The issue is described in https://roy.marples.name/archives/dhcpcd-discuss/0002131.html. It is fixed in dhcpcd version 7.0.7, which is the current package version.

== See also ==

* {{man|8|dhcpcd}}
* {{man|5|dhcpcd.conf}}