Page tree
Skip to end of metadata
Go to start of metadata

Successfully pass the free certification exam at IW Academy and become an Infinet Certified Engineer.

To the certification exam


DHCP client is used for automatic retrieving of different parameters from DHCP server for one or several unit’s network interfaces. Among the parameters are IP-address, network mask, default gateway etc.


  dhcpc [options] [IFNAME] [commands]options:
        -l (none|default|$ACLNAME|acl:ACLNAME) - set server id accesslist name
        -k (none|default|key:KEYVALUE)         - set authorization method
        -a (none|default|NUMBER)               - set arp attempts number
        -c (none|default|CLIENT-CLASS ID)      - set DHCP Client Class ID - any string
                                                 Default Class ID - "IW-R5000-MESH"
        If IFNAME was not specified, it sets default option(s) value
        -t (on|off)                            - turn trace on/off
        start  - start dhcp on specified interface
        stop   - stop dhcp on specified interface
        delete - remove dhcp from specified interface
        dump   - show current dhcp status


startStarts DHCP client on the specified interface.
stopStops DHCP client on the specified interface.
deleteStops DHCP client on the specified interface and clears all options.
dumpShows current status of DHCP client.


Name of the network interface to which options are referred. If no interface name is specified, options are set as default for the whole client.

There are special values that can be specified for upcoming parameters: "none" and "default".

  • "none" this parameter does not work for this interface even though default value of this parameter exists.
  • "default" there is no specific parameter value. Default option value is not displayed in DHCP client configuration.
-l (none|default|$ACLNAME|acl:ACLNAME)

Sets the list of IP-addresses of DHCP servers from which the client is permitted to receive parameters.

  • "ACLNAME" – the name of access control list (see acl command). If specified list is not configured in the system (this acl does not exist), DHCP client will be able to receive parameters from any DHCP server.
-k (none|default|key:KEYVALUE)Sets authorization key. DHCP authorization is in accordance with "RFC 3118 - Authentication for DHCP Messages".
-a (none|default|NUMBER)Sets the number of repeated arp requests which sends DHCP client after getting a lease of IP-address from DHCP server. In accordance with DHCP, the client is obliged to check received IP-address if there are any other network devices with the same IP-address. For higher reliability, DHCP client sends a series of such request with 1/4 second interval. If arp requests number is not specified for all of the interfaces (including absence of default value for this parameter), DHCP client sends 16 requests.
–c (none|default|CLIENT-CLASS ID)

Sets the class identifier of DHCP client.

"CLIENT-CLASS ID" – the name of identifier. Type of input data: any string (for example "IW-R5000-MESH").

-t (on|off)This option turns on/off sending debug information to the system log. The option is not attached to any specific interface.


This configuration sets the number for ARP requests of 5.

dhcpc –a 5

For "eth0" interface the list of allowed DHCP servers is specified in "DHCP_SERVERS".

dhcpc –l $DHCP_SERVERS eth0 start

The client is started for "eth0" interface. For "rf5.0" interface none option is set for the number of ARP requests. Thus, "rf5.0" will send 16 ARP requests. Also, DHCP client on "rf5.0" interface will use "qwerty" as authorization key.

dhcpc –a none –k key:qwerty  rf5.0 start

The command prints current status of DHCP client.

dhcpc dump

Here, clients are started on "eth0" and "rf5.0" interfaces.

For "eth0" interface DHCP client obtained a lease for "" IP-address with 26 bits network mask length from "" DHCP server. The lease expires in 35 minutes and 16 seconds.

DHCP client on "rf5.0" interface has not yet received any parameters.

ID  I-face   IP address/mask   Gateway address    Server ID    Lease exp.
== ======== ================== =============== ===
 0   eth0 000:35:16
 1   rf5.0  ------------------ ---------------