System Administration Commands pntadm(1M)
NAME
pntadm - DHCP network table management utility
SYNOPSIS
pntadm -C [-r resource] [-p path] [-u uninterpreted] network
pntadm -A nameIPaddress [-c comment] [-e mm/dd/yyyy]
[-f num keywords] [-h clienthostname]
[-i [-a] clientID] [-m [-y] macro] [-s server]
[-r resource] [-p path] [-u uninterpreted] network
pntadm -M nameIPaddress [-c comment] [-e mm/dd/yyyy]
[-f num keywords] [-h clienthostname]
[-i [-a] client ID] [-m [-y] macro]
[-n newclientIPaddress] [-s server] [-r resource]
[-p path] [-u uninterpreted] network
pntadm -D nameIPaddress [-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 dhcpnetwork(4).
pntadm can be run as root or by other users assigned to the
DHCP Management profile. See rbac(5) and userattr(4).
If the networks you want to add are subnetted, you need to
update the netmasks(4) table.
SunOS 5.11 Last change: 9 Jan 2004 1
System Administration Commands pntadm(1M)
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 nameIPaddress Add a client entry with hostname
or client IP address,
nameIPaddress, to the named DHCP
network table.
The following sub-options are
optional:
-c comment Comment
text. The
default is
NUL.
-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 follow-
ing key-
words, com-
bined using
the plus (])
symbol:
DYNAMIC or
00
SunOS 5.11 Last change: 9 Jan 2004 2
System Administration Commands pntadm(1M)
Server
manager's
assign-
ment.
PERMANENT or Lease
01 on
entry
is
per-
manent.
MANUAL or 02 Adminis-
tra-
tor
managed
assign-
ment.
UNUSABLE or Entry
04 is
not
valid.
BOTP or 08 Entry
reserved
for
BOTP
clients.
For a more
detailed
description
of the flag
values, see
dhcpnetwork(4).
-h clienthostname Client host-
name. The
default is
NUL.
When the -h
option is
used in this
mode, the
clienthostname
SunOS 5.11 Last change: 9 Jan 2004 3
System Administration Commands pntadm(1M)
is added to
the hosts
table within
the resource
used for
storing host
names
(files, NIS]
or DNS). The
command will
fail if this
clienthostname
is already
present in
the hosts
table.
-i clientID [-a] Client iden-
tifier [-a].
The default
is 00.
The -i
option modi-
fied with -a
specifies
that the
client iden-
tifier is in
ASCI for-
mat, and
thus needs
to be con-
verted to
hexadecimal
format
before
insertion
into the
table.
-m macro [-y] Macro name.
Default is
UNKNOWN.
The -m
option modi-
fied with -y
verifies the
existence of
SunOS 5.11 Last change: 9 Jan 2004 4
System Administration Commands pntadm(1M)
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. Process-
ing many pntadm commands using
this method is much faster than
running an executable batchfile
itself. Batch mode is recommended
for using pntadm in scripts.
The following sub-option is
optional:
-v Display commands to standard
output as they are pro-
cessed.
-C Create the DHCP network table for
the network specified by network.
See . For details, see
dhcpnetwork(4) and networks(4).
-D nameIPaddress Delete the specified client entry
with hostname or client IP
address, nameIPaddress, in the
named DHCP network table. (See
dhcpnetwork(4).)
The following sub-option is
optional:
SunOS 5.11 Last change: 9 Jan 2004 5
System Administration Commands pntadm(1M)
-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.
-L List the DHCP network tables
presently configured, one per
line, on standard output. If none
are found, no output is printed
and an exit status of 0 is
returned.
-M nameIPaddress Modify the specified client entry
with hostname or client IP
address, nameIPaddress, in the
named DHCP network table. See
dhcpnetwork(4). The default for
the sub-options is what they
currently are set to.
The following sub-options are
optional.
-c comment New
com-
ment
text.
-e mm/dd/yy New
abso-
lute
lease
expira-
tion
date.
Time
defaults
to
12:00
AM of
the
day
speci-
fied.
SunOS 5.11 Last change: 9 Jan 2004 6
System Administration Commands pntadm(1M)
-f num keyboard New
flag
value,
see
expla-
na-
tion
fol-
low-
ing
the
descrip-
tion
of
the
-A
option.
-h hostname New
client
host-
name.
The
-h
option
allows
you
to
change
the
current
host-
name
asso-
ci-
ated
with
the
IP
address
or to
add a
new
host-
name
to
the
hosts
table
if an
SunOS 5.11 Last change: 9 Jan 2004 7
System Administration Commands pntadm(1M)
entry
asso-
ci-
ated
with
this
IP
address
does
not
exist.
-i clientID New
client
iden-
tif-
ier
[-a].
-m macro [-y] Macro
name
defined
in
dhcptab.
-n newclientIPaddress New
IP
address.
-s server New
server
IP or
name.
For more detailed description of
the sub-options and flag values,
see dhcpnetwork(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
SunOS 5.11 Last change: 9 Jan 2004 8
System Administration Commands pntadm(1M)
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 BOTP
See dhcpnetwork(4) for informa-
tion on these sub-options and
associated flag codes.
-p path Override the dhcpsvc.conf(4) con-
figuration value for data store
resource path, path See
dhcpsvc.conf(4)
-R Remove the named DHCP network
table. See dhcpnetwork(4).
-r datastoreresource Override the
/etc/inet/dhcpsvc.conf configura-
tion value for RESOURCE= with the
datastoreresource specified. See
the dhcpsvc.conf(4) man page for
more details on resource type, and
the for more information 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
authentication or authorization
parameters required by a
SunOS 5.11 Last change: 9 Jan 2004 9
System Administration Commands pntadm(1M)
particular data store.
OPERANDS
The following operand is supported:
network The network address or network name which
corresponds to the dhcp network table. See
dhcpnetwork(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
SunOS 5.11 Last change: 9 Jan 2004 10
System Administration Commands pntadm(1M)
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 ASCI
The following command sets the client ID as ASCI
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
SunOS 5.11 Last change: 9 Jan 2004 11
System Administration Commands pntadm(1M)
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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWdhcsu
Interface Stability Evolving
SEE ALSO
dhcpconfig(1M), dhcpmgr(1M), dhcpnetwork(4), ,
dhcpsvc.conf(4), dhcptab(4), hosts(4), netmasks(4),
SunOS 5.11 Last change: 9 Jan 2004 12
System Administration Commands pntadm(1M)
networks(4), userattr(4), attributes(5), dhcp(5),
dhcpmodules(5), rbac(5)
Alexander, S., and R. Droms, DHCP Options and BOTP Vendor
Extensions, RFC 1533, Lachman Technology, Inc., Bucknell
University, October 1993.
Droms, R., Interoperation Between DHCP and BOTP, 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.
SunOS 5.11 Last change: 9 Jan 2004 13
|
