dhtadm(1M)

NAME

dhtadm − DHCP configuration table management utility

SYNOPSIS

dhtadm −C [ −r resource ] [ −p path ]
dhtadm −A −s symbol_name −d definition [ −r resource ] [ −p path ]
dhtadm −A −m macro_name −d definition [ −r resource ] [ −p path ]
dhtadm −M −s symbol_name −d definition [ −r resource ] [ −p path ]
dhtadm −M −m macro_name −n new_name [ −r resource ] [ −p path ]
dhtadm −M −s symbol_name −d definition [ −r resource ] [ −p path ]
dhtadm −M −m macro_name −d definition [ −r resource ] [ −p path ]
dhtadm −M −m macro_name −e symbol=value [ −r resource ] [ −p path ]
dhtadm −D −s symbol_name [ −r resource ] [ −p path ]
dhtadm −D −m macro_name [ −r resource ] [ −p path ]
dhtadm −P [ −r resource ] [ −p path ]
dhtadm −R [ −r resource ] [ −p path ]

DESCRIPTION

The dhtadm command manages the DHCP service configuration table, dhcptab. (For a description of the table format, see dhcptab(4).) One of the following option flags must be specified: −C, −A, −M, −D, or −R.

Depending on the resource type (−r option), the user must have the proper file permissions or NIS+ credentials.

OPTIONS

−A Add a symbol or macro definition to the dhcptab table. Required sub-options are:

Option	Argument	Description
−d	definition	Macro or symbol definition
−m	macro_name	Name of macro to be added
−s	symbol_name	Name of symbol to be added

−C Create the DHCP service configuration table, dhcptab.

−D Delete a symbol or macro definition. Required sub-options are:

Options	Argument	Description
−m	macro_name	Macro to delete
−s	symbol_name	Symbol to delete

−M Modify an existing symbol or macro definition. Required sub-options are:

Option	Argument	Description
−d	definition	Macro (−m) or symbol (−s) definition
−e	symbol=value	Edit symbol/value pair within a macro. To add a symbol which does not have an associated value, enter: "symbol=_NULL_VALUE_" To delete a symbol definition from a macro, enter: "symbol="
−m	macro_name	Macro; legal companions: one of −n, −d, or −e
−n	new_name	New macro name
−s	symbol_name	Symbol; legal companions: −d

−p path
Override the
/etc/default/dhcp
configuration value for resource 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.

−P
Display the
dhcptab
table.

−r resource
Override the
/etc/default/dhcp
configuration value for resource type.
Currently supported resource types are
files
or
nisplus.
See
dhcp(4).

−R
Remove the
dhcptab
table.

EXAMPLES

1) The following command creates the DHCP service configuration table, dhcptab:

# dhtadm −C

2) The following command adds a Vendor option symbol definition for a new symbol called MySym to the dhcptab table in the files resource in the /var/mydhcp directory:

# dhtadm −A −s MySym −d ’Vendor=SUNW.PCW.LAN,20,IP,1,0’ \ −r files −p /var/mydhcp

3) The following command adds the aruba macro definition to the dhcptab table. Note that symbol/value pairs are bracketed with colons (:).

# dhtadm −A −m aruba −d ’:Timeserv=10.0.0.10 10.0.0.11:DNSserv=10.0.0.1:’

4) The following command modifies the Locale macro definition, setting the value of the UTCOffst symbol to 18000 seconds. Note that any macro definition which includes the definition of the Locale macro will inherit this change.

# dhtadm −M −m Locale −e ’UTCOffst=18000’

5) The following command deletes the Timeserv symbol from the aruba macro. Note that any macro definition which includes the definition of the aruba macro will inherit this change.

# dhtadm −M −m aruba −e ’Timeserv=’

6) The following command adds the Hostname symbol to the aruba macro. Note that the Hostname symbol takes no value, and thus requires the special value _NULL_VALUE_. Note also that any macro definition which includes the definition of the aruba macro will inherit this change.

# dhtadm −M −m aruba −e ’Hostname=_NULL_VALUE_’

7) The following command renames the Locale macro to MyLocale. Note that any Include statements in macro definitions which include the Locale macro will also need to be changed.

# dhtadm −M −m Locale −n MyLocale

8) The following command deletes the MySym symbol definition. Note that any macro definitions which use MySym will need to be modified.

# dhtadm −D −s MySym

9) The following command removes the dhcptab table in the nisplus directory specified.

# dhtadm −R −r nisplus −p Test.Nis.Plus.

EXIT STATUS

0 Successful completion.

1 Object already exists.

2 Object does not exist.

3 Non-critical error.

4 Critical error.

FILES

/var/dhcp/dhcptab file or NIS+ table

/etc/default/dhcp DHCP service configuration file

/etc/inet/hosts file or NIS+ table

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdhcsu

Museum

Related Articles