NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO
The pntadm command manages the dhcp network DHCP client tables. One of the following option flags must be specified: -C, -A, -M, -D, -R, or -L.
Note also that if the networks you wish to add are subnetted, you will need to update the netmasks(4) table. Depending on the resource type (-r option), you must have the proper file permissions or NIS+ credentials.
For a description of the format of dhcp network tables, see dhcp_network(4).
pntadm supports the following options:
Add a client entry with hostname or client IP address, name_IP_address, to the named dhcp network table. Optional sub-options, with defaults, are:
Option(s) | Argument | Description | Default |
-c | comment | Comment text | NULL |
-e | mm/dd/yyyy | Absolute lease | 0 |
-f | num | keywords | Flag value | 00 |
-h | host name | Client hostname | NULL |
-i | client ID | Client identifier[-a] | 00 |
-m | dhcptab macro[-y] | Macro name | UNKNOWN |
-s | server | Server IP or name | nodename |
When the -h option is used in this mode, the host name is added to the hosts table within the resource. The command will fail if this host name is already present in the hosts table.
The flag (-f) option can be specified either as a single number denoting the intended flag value, or as a series of the following keywords, combined using the plus (+) symbol:
Keyword | Numeric | Description |
DYNAMIC | 00 | Server manages assignment |
PERMANENT | 01 | Lease on entry is permanent |
MANUAL | 02 | Administrator managed assignment |
UNUSABLE | 04 | Entry is not valid |
BOOTP | 08 | Entry reserved for BOOTP clients |
For a more detailed description of the flag values, see dhcp_network(4).
The -i option modified with -a specifies that the client identifier is in ASCII format, and thus needs to be converted to hexadecimal format before insertion into the table.
The -m option modified with -y verifies the existence of the named macro in the dhcptab table before adding the entry.
Create the DHCP network table for the network specified by network. See OPERANDS. For details, see dhcp_network(4) and networks(4).
Delete the specified client entry with hostname or client IP address, name_IP_address, in the named dhcp network table. (See dhcp_network(4).) Optional sub-options are:
Option | Description |
-y | Remove associated host table entry |
The -y option requests that all hostnames associated with the IP address in the hosts table in the resource be removed.
List the DHCP network tables presently configured, one per line, on standard output. If none are found, no output will be printed and an exit status of zero will be returned.
Modify the specified client entry with hostname or client IP address, name_IP_address, in the named dhcp network table. See dhcp_network(4). Optional sub-options are:
Option(s) | Argument | Description | Default |
-c | comment | Comment text | NULL |
-e | mm/dd/yyyy | Absolute lease | 0 |
-f | num | keywords | Flag value | 00 |
-h | host name | Client hostname | NULL |
-i | client ID | Client identifier[-a] | 00 |
-m | dhcptab macro[-y] | Macro name | UNKNOWN |
-n | client IP | New IP address | NULL |
-s | server | Server IP or name | nodename |
The -h option allows you to change the current hostname associated with the IP address or to add a new hostname to the hosts table if an entry associated with this IP address does not exist.
For more detailed description of the sub-options and flag values, see the information given under -A option above and dhcp_network(4).
Display the named dhcp network table. See dhcp_network(4). Optional sub-options are:
Options | Description |
-v | Display lease time in verbose format |
Override the /etc/default/dhcp configuration value for resource path, path. The resource path for the files resource is an absolute UNIX pathname and a fully specified nisplus directory (including the tailing period) for the NIS+ resource. See dhcp(4) for more details.
Remove the named dhcp network table. See dhcp_network(4).
Override the /etc/default/dhcp configuration value for resource type, resource. Currently supported resource types are files or nisplus. See dhcp(4) for more details.
The network address or network name which corresponds to the dhcp network table. See dhcp_network(4).
The following command creates a table for the 10.0.0.0 (subnetted to class C) DHCP network table. Note that if you have an alias for this network in your networks(4) table, you can use that value rather than the dotted Internet Address notation.
example# pntadm -C 10.0.0.0 |
The following command adds an entry to the 10.0.0.0 table in the files resource in the /var/mydhcp directory:
example# pntadm -r files -p /var/mydhcp -A 10.0.0.1 10.0.0.0 |
The following command modifies the 10.0.0.1 entry of the 10.0.0.0 table, changing the macro name to Green, setting the flags field to MANUAL and PERMANENT:
example# pntadm -M 10.0.0.1 -m Green -f 'PERMANENT + MANUAL' 10.0.0.0 |
The following command changes the 10.0.0.1 entry to 10.0.0.2, making an entry in the hosts(4) table called myclient:
example# pntadm -M 10.0.0.1 -n 10.0.0.2 -h myclient 10.0.0.0 |
The following command sets the client ID as ASCII aruba.foo.com for the myclient entry:
example# pntadm -M myclient -i 'aruba.foo.com' -a 10.0.0.0 |
The following command deletes the myclient (10.0.0.2) entry from the 10.0.0.0 table:
example# pntadm -D myclient 10.0.0.0 |
The following command removes the named DHCP network table in the nisplus directory specified:
example# pntadm -r nisplus -p Test.Nis.Plus. -R 10.0.0.0 |
The following command lists the configured DHCP network tables:
example# pntadm -L 192.168.0.0 10.0.0.0 |
Successful completion.
Object already exists.
Object does not exist.
Non-critical error.
Critical error.
files or NIS+ tables where XXX represents octets of the dotted IP address
DHCP service configuration file
file or NIS+ table
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWdhcsu |
dhcpconfig(1M), dhcpmgr(1M),dhcp(4), dhcp_network(4), dhcptab(4), hosts(4), netmasks(4), networks(4), attributes(5)
Alexander, S., and R. Droms, DHCP Options and BOOTP Vendor Extensions, RFC 1533, Lachman Technology, Inc., Bucknell University, October 1993.
Droms, R., Interoperation Between DHCP and BOOTP, RFC 1534, Bucknell University, October 1993.
Droms, R., Dynamic Host Configuration Protocol, RFC 1541, Bucknell University, October 1993.
Wimer, W., Clarifications and Extensions for the Bootstrap Protocol, RFC 1542, Carnegie Mellon University, October 1993.
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO