dhcpdb2conf(1M) dhcpdb2conf(1M)
NAME
dhcpdb2conf - 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: hostname, IP address, and default gateway (a subset of the "initial identity
parameters" managed by and You can list the contents of the database 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 operate, 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 processing.
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]cre-
ated 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 configuration files using lan0, and set index = 1:
WARNINGS
Using the option overrides any existing values which are currently set in the system's configuration files (while the option merely revises
staging 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 ALSO
auto_parms(1M), dhcpclient(1M), geocustoms(1M), set_parms(1M).
dhcpdb2conf(1M)