dhcpdb2conf(1M)dhcpdb2conf(1M)NAMEdhcpdb2conf - convert DHCP client database to config file parameters
SYNOPSIS
index] [lan-interfaces]
DESCRIPTION
The command translates a client system's DHCP database parameters (from
into a set of standard configuration file parameters. This is an
essential step for configuring a DHCP client system, and is invoked by
upon every reboot when DHCP is active.
A DHCP client database can contain settings for such items as: host‐
name, IP address, and default gateway (a subset of the "initial iden‐
tity parameters" managed by and You can list the contents of the data‐
base to the screen, create a set of configuration staging files, or
execute direct edits on existing configuration files using the values
contained in the client database.
Arguments: You can provide a list of lan-interfaces on which to oper‐
ate, such as "lan0 lan1". If you specify no LAN interfaces, processes
all entries referenced in the client's DHCP database. The entries are
each defined as a unique LAN interface and a corresponding list of
attributes.
Options
The following options determine the results of DHCP parameter process‐
ing.
Print results to the screen (standard output).
This is the default action if neither nor is specified.
Apply directly: Using the results of the specified filters (see
below),
directly apply the parameter definitions to the existing
configuration files, for example, to (This is how is called
from
Create copies: Create a set of staging files using the results of the
selected filters (see below). Each parameter processed is
applied to its corresponding copy of one configuration file
[re]created by
For example, is copied to (If the file already exists and
can be written, it is overwritten; otherwise the command
fails.) Once this staging file is created, the parameter
being processed is applied to the newly created staging
file rather than the real configuration file.
The following "filter" options control which parameters are processed.
The options can be combined in any manner. The default with no options
is to process all attributes for each LAN interface.
Hostname: Process the
parameter.
DNS: Process the
parameter set (in
Interface: Process the
parameter set:
Route: Process the
parameter set:
NIS: Process the
parameter set:
Time: Process the
parameter.
DHCP_SERVER: Prints the hostname of
which has the given IP address for the interface. Options
or have no effect. Option will print results only to the
screen (standard output).
Hostname: Do not update the
parameter in configuration files. If the option is used
with or then the option has no effect.
Set array index for the set of related parameters for one LAN interface
in the configuration files. For example, with (the
default) the output would include
The command can be run only by users with appropriate privileges.
Configuration Files and Parameter Names
The following files, and parameters in each file, can be processed by
EXAMPLES
List the entire contents of the DHCP client
database:
List only the parameter set for lan0:
List the and parameter sets for lan0 and lan1:
Apply the and parameter sets for lan0 to the
existing configuration files:
Apply all parameter sets to the existing configu‐
ration files using lan0, and set index = 1:
WARNINGS
Using the option overrides any existing values
which are currently set in the system's configura‐
tion files (while the option merely revises stag‐
ing files, if any).
FILES
The command itself.
Current DHCP parameters received from a DHCP
server by
System configuration files
that can be modified by
SEE ALSOauto_parms(1M), dhcp‐
client(1M), geocustoms(1M),
set_parms(1M).
dhcpdb2conf(1M)