pntadm(1M)
NAME
pntadm - DHCP network table management utility
SYNOPSIS
pntadm -C [-r resource] [-p path] [-u uninterpreted] network
pntadm -A name_IP_address [-c comment] [-e mm/dd/yyyy] [-
f num | keywords] [ -h client_hostname] [ -i [-a]
client_ID] [ -m [-y] macro] [-s server] [-r resource] [-
p path] [-u uninterpreted] network
pntadm -M name_IP_address [-c comment] [-e mm/dd/yyyy] [-
f num | keywords] [ -h client_hostname] [ -i [-a] client
ID] [ -m [-y] macro] [-n new_client_IP_address] [-s server]
[-r resource] [-p path] [-u uninterpreted] network
pntadm -D name_IP_address [-y] [-r resource] [-p path] [-
u uninterpreted] network
pntadm -P [-v] [-x] [-r resource] [-p path] [-
u uninterpreted] network
pntadm -R [-r resource] [-p path] [-u uninterpreted] network
pntadm -L [-r resource] [-p path] [-u uninterpreted]
pntadm -B [-v] [batchfile]
DESCRIPTION
The pntadm command is used to manage the Dynamic Host Confi-
guration Protocol (DHCP) network tables. It is used to add
and remove networks under DHCP management, and add, delete,
or modify IP address records within network tables, or to
view tables. For a description of the format of DHCP network
tables, see dhcp_network(4).
pntadm can be run as root or by other users assigned to the
DHCP Management profile. See rbac(5) and user_attr(4).
If the networks you want to add are subnetted, you need to
update the netmasks(4) table.
One of the following options (function flags) must be speci-
fied with the pntadm command: -A, -B, -C, -D, -L, -M, -P,
or-R.
OPTIONS
The following options are supported:
-A name_IP_address
Add a client entry with hostname or client IP
address, name_IP_address, to the named DHCP
network table.
The following sub-options are optional:
-c comment
Comment text. The default is NULL.
-e mm/dd/yyyy
Absolute lease. The default is 0.
-f num | keywords
Flag value. The default is 00.
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:
DYNAMIC or 00
Server manager's assignment.
PERMANENT or 01
Lease on entry is permanent.
MANUAL or 02
Administrator managed assignment.
UNUSABLE or 04
Entry is not valid.
BOOTP or 08
Entry reserved for BOOTP clients.
For a more detailed description of the flag
values, see dhcp_network(4).
-h client_hostname
Client hostname. The default is NULL.
When the -h option is used in this mode,
the client_hostname is added to the hosts
table within the resource used for storing
host names (files, NIS+ or DNS). The com-
mand will fail if this client_hostname is
already present in the hosts table.
-i client_ID [-a]
Client identifier [-a]. The default is 00.
The -i option modified with -a specifies
that the client identifier is in ASCII for-
mat, and thus needs to be converted to hex-
adecimal format before insertion into the
table.
-m macro [-y]
Macro name. Default is UNKNOWN.
The -m option modified with -y verifies the
existence of the named macro in the dhcptab
table before adding the entry.
-s server
Server IP or name. Default is system name
(uname -n).
-B Activate batch mode. pntadm will read from the
specified file or from standard input a series of
pntadm commands and execute them within the same
process. Processing many pntadm commands using
this method is much faster than running an exe-
cutable batchfile itself. Batch mode is recom-
mended for using pntadm in scripts.
The following sub-option is optional:
-v Display commands to standard output as they
are processed.
-C Create the DHCP network table for the network
specified by network. See OPERANDS. For details,
see dhcp_network(4) and networks(4).
-D name_IP_address
Delete the specified client entry with hostname
or client IP address, name_IP_address, in the
named DHCP network table. (See dhcp_network(4).)
The following sub-option is optional:
-y Remove associated host table entry. The -y
option requests that all hostnames associ-
ated with the IP address in the hosts table
in the resource be removed.
-L List the DHCP network tables presently config-
ured, one per line, on standard output. If none
are found, no output is printed and an exit
status of 0 is returned.
-M name_IP_address
Modify the specified client entry with hostname
or client IP address, name_IP_address, in the
named DHCP network table. See dhcp_network(4).
The default for the sub-options is what they
currently are set to.
The following sub-options are optional.
-c comment
New comment text.
-e mm/dd/yy
New absolute lease expiration date. Time
defaults to 12:00 AM of the day specified.
-f num | keyboard
New flag value, see explanation following
the description of the -A option.
-h host_name
New client hostname.
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.
-i client_ID
New client identifier [-a].
-m macro [-y]
Macro name defined in dhcptab.
-n new_client_IP_address
New IP address.
-s server
New server IP or name.
For more detailed description of the sub-options
and flag values, see dhcp_network(4).
-P Display the named DHCP network table.
The following sub-options are optional:
-v Display lease time in full verbose format
and resolve IP addresses for the clients
and server to hostnames.
-x Display lease time in raw format.
These flag codes are used with the -P sub-options:
-v -x Description
D 00 DYNAMIC
P 01 PERMANENT
M 02 MANUAL
U 04 UNUSABLE
B 08 BOOTP
See dhcp_network(4) for information on these
sub-options and associated flag codes.
-p path
Override the dhcpsvc.conf(4) configuration value
for data store resource path, path See
dhcpsvc.conf(4)
-R Remove the named DHCP network table. See
dhcp_network(4).
-r data_store_resource
Override the /etc/inet/dhcpsvc.conf configuration
value for RESOURCE= with the data_store_resource
specified. See the dhcpsvc.conf(4) man page for
more details on resource type, and the Solaris
DHCP Service Developer's Guide for more informa-
tion about adding support for other data stores.
-u uninterpreted
Data which will be ignored by pntadm, but passed
to the currently configured public module to be
interpreted by the data store. This might be used
for a database account name or other authentica-
tion or authorization parameters required by a
particular data store.
OPERANDS
The following operand is supported:
network
The network address or network name which corresponds
to the dhcp network table. See dhcp_network(4).
EXAMPLES
Example 1: Creating a Table for the 10.0.0.0 DHCP Network
The following command creates a table for the 10.0.0.0 (sub-
netted 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 nota-
tion.
example# pntadm -C 10.0.0.0
Example 2: Adding an Entry to the 10.0.0.0 Table
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 SUNWfiles -p /var/mydhcp -A 10.0.0.1 10.0.0.0
Example 3: Modifying the 10.0.0.1 Entry of the 10.0.0.0
Table
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
Example 4: Changing the 10.0.0.1 Entry to 10.0.0.2
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
Example 5: Setting the Client ID as ASCII
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
Example 6: Deleting the myclientEntry from the 10.0.0.0
Table
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
Example 7: Removing the Named DHCP Network Table
The following command removes the named DHCP network table
in the NIS+ directory specified:
example# pntadm -r SUNWnisplus -p Test.Nis.Plus. -R 10.0.0.0
Example 8: Listing the Configured DHCP Network Tables
The following command lists the configured DHCP network
tables:
example# pntadm -L
192.168.0.0
10.0.0.0
Example 9: Executing pntadm Commands in Batch Mode
The following command runs a series of pntadm commands con-
tained in a batch file:
example# pntadm -B addclients
EXIT STATUS
0 Successful completion.
1 Object already exists.
2 Object does not exist.
3 Non-critical error.
4 Critical error.
FILES
/etc/inet/dhcpsvc.conf
/etc/inet/hosts
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWdhcsu |
|_____________________________|_____________________________|
| Interface Stability | Evolving |
|_____________________________|_____________________________|
SEE ALSO
dhcpconfig(1M), dhcpmgr(1M), dhcp_network(4), ,
dhcpsvc.conf(4), dhcptab(4), hosts(4), netmasks(4),
networks(4), user_attr(4), attributes(5), dhcp(5),
dhcp_modules(5), rbac(5)
Solaris DHCP Service Developer's Guide
System Administration Guide: IP Services
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.
Man(1) output converted with
man2html