dadmin Command

Edit online

Purpose

Used to query and modify the status of the DHCP server.

Syntax

dadmin [ -?] [ -v] [ -h Hostname] [ -n interval] [ -f] -d IpAddress | [ -x] -i | [ -x] -s | -t on|off|Value | -q IpAddress | -r IpAddress | -p IpAddress | -c Clientld

Description

The dadmin command enables the DHCP administrator to query and modify the state of DHCP server databases. It gives the administrator the ability to query the DHCP server, locally or remotely, for the status of an IP address, query for a pool of IP addresses, query for a client, delete an IP address mapping, refresh the server, and change the server's tracing level.

The dadmin command is compatible with an earlier version of DHCP servers to list their IP address status and refresh.

When querying for an IP address information, the dadmin command returns the IP address's status. And depending on the IP address's status, the dadmin command might return the lease duration, start lease time, last leased time, whether the server supports DNS, a record update for this IP address, and the client identifier that is mapped to this IP address.

When querying for a client information, the dadmin command returns the client's IP address and IP address status, the last time the client was given any IP address, the host name and domain name that are used by the client, whether the server supports DNS, and a record update for this IP address.

When you modify the server tracing level, the dadmin command sets and returns the server tracing level in the form of a tracing mask. This mask represents a bit string where each bit represents whether a specific log item is being traced by the server (see DHCP Server Configuration File in the online documentation). From least significant to most significant order, these log items are LOG_NONE, LOG_SYSERR, LOG_OBJERR, LOG_PROTOCOL and LOG_PROTERR (same value), LOG_WARN, AND LOG_CONFIG (same value), LOG_EVENT, and LOG_PARSEERR (same value), LOG_ACTION, LOG_INFM, LOG_ACNTING, LOG_STAT, LOG_TRACE, LOG_START, and LOG_RTRACE.
Note: LOG_START cannot be disabled. It implies a mask range from 0x0800 through 0x1FFF.

Flags

Item Description
-c Clientld Returns the status for a specific client that might be known to the DHCP server. Clientld represents the client identifier that a DHCP client used to identify itself, or the field can either be specified as hexadecimal characters only, or in the TYPE-STRING representation that is used by the DHCP server.
-d IpAddress Deletes the lease information that is associated with IP address IpAddress. As a result, the address is moved to the FREE state and be available for binding again.
-f To be used with the -d flag. The -f flag forces the deletion of the address without any prompting. Deletes the lease information that is associated with IP.
-h Hostname Used to specify the destination DHCP server. Hostname can either be a name or IP address.
-i Reinitializes the DHCP server. This flag signals the server to sync its databases and restarts by rereading the configuration file.
-n interval Displays server statistics, summaries, and any requested intervals.
-p IpAddress Returns the status of each address in a subnet. IpAddress is used to identify the subnet to a list.
-q IpAddress Returns the status of a specific IP address.
-r IpAddress Puts the IP address in the Free state.
-s Returns the status of each address in the DHCP server's configured pools.
-t on|off|Value Changes the tracing level of the DHCP server. Trace values are reported in a hexadecimal format that represents the tracing mask in use on the server. Value can be specified as either a decimal or hexadecimal format. The keywords on and off enable or disable a single bit at a time in the tracing mask.
-v Runs the command in verbose mode.
-x Use Version 1 of the dadmin protocol. The -x flag is used to connect to previous release DHCP servers and is only valid for the -i and -s flags. Follow with 6 when you connect with DHCPv6 server.
-? Displays the usage syntax.

Exit Status

Item Description
0 Successful completion.
>0 An error occurred.

Security

To secure connections from the dadmin clients, the DHCP server allows connections only from the server itself or from remote systems that are included in the superuser's .rhosts file. To prevent ordinary users from modifying the DHCP server's address mappings, the administrator must ensure that the execution of the dadmin command is limited to the proper users on those systems that are allowed access.

Files

Item Description
/usr/sbin/dadmin Contains the dadmin command.