dhcpsconf Command

Purpose

Simplifies DHCP (Dynamic Host Configuration Protocol) server configuration through a graphical user interface (GUI).

Syntax

dhcpsconf

Description

The dhcpsconf command opens an X Window System GUI that lets the network administrator read, save, and modify configuration files. It also lets you start, stop, and retrieve statistics from a running server.

The dhcpsconf command displays a set of lists. The lists on the left show the available options and keys. The dhcpsconf command reads the /etc/options file to determine its basic options and keys and starts with these as generic resource types. The GUI lets the network administrator define a set of named resources by selecting the resource menu button.

The resource definition dialog box lets the network administrator generate all the options and specifics that are on the networks. The network administrator can define and name the network, printers, name servers, DHCP servers, and other valid resource objects. Once it is done, these new resources are added to the key and option display on the main panel. These resources can be used to generate a server configuration file or set of server configuration files.

The GUI starts with an empty master file. A master file might contain either a single server or the definition of many servers and one actual server readable file. The master file is readable by one DHCP server, but multiple server information can be stored in it. It lets the network administrator configure a single server image of the network, create a set of servers to handle the same set of data, and view and maintain it all in one file.

Options and keys are added to the server window by selecting the key or option, selecting where in the edit window the option or key must go, and selecting the add button corresponding to the key or option section. The option is added to the edit window at the position specified. If the item is a named resource, then it is added as is. If the item is one of the standard defaults, then a window that is requesting a value for the item appears.

DHCP servers are added just like other keys, except that they specify systems in the network that are responsible for the items within their scope. The keys have scoping and syntactic ordering. Comments are not really keys, but they are allowed anywhere.

A server might have a network, class, client, or options that are specified within it. A network might have a subnet, class, client, or option. A subnet might have a class, client, or options. A class and client might have only options.

The servers have a set of configuration parameters that apply only to them. These are specified by the DHCP server key in the key list, or by using the default server options under the Server menu bar. The default server options apply to the master file. A DHCP Server specified within the master file receives the default options, but may be modified.

Any item that is placed in the Edit window might be edited, renamed, viewed, or deleted. It lets you place an item, see whether it looks appropriate and change as necessary.

Upon completion of the configuration file, a single master file might be saved and a set of server files might be generated. The File menu button and Server menu button both have save options. The File save button is for saving the master file. The Server save button is for saving a particular server to a file.

The File menu button also contains a quit option, an open option to retrieve a file, and a new option to erase everything that is created so far.

The Operations menu button contains a status button, a start button, a stop button, a refresh, and a send configuration file button. From these buttons, a remote server can report status, refresh itself with a new configuration file, might be stopped, and a configuration file can be sent and restarted.

The Help button contains a set of help statements that describe each of the windows items.

Exit Status

This command returns the following exit values:

Item Description
0 Successful completion.
>0 An error occurred.

Security

Access Control: Any user

Files

Item Description
/usr/sbin/dhcpsconf Contains the dhcpsconf command.
/etc/dhcpcd.cnf Contains the default client configuration file.