DHCP server file syntax for general server operation
The DHCP file syntax for general server operation and the valid values for each field are defined here.
Note: Time Units (time_units)
shown in the following table are optional and represent a modifier
to the actual time. The default time unit is minutes. Valid values
are seconds (1), minutes (60), hours (3600), days (86400), weeks (604800),
months (2392000), and years (31536000). The number shown in parentheses
is a multiplier applied to the specified value n to
express the value in seconds.
| Keyword | Form | Subcontainers | Default Value | Meaning |
|---|---|---|---|---|
| database | database db_type | Yes | None | The primary container that holds the definitions for the address pools, options, and client access statements. db_type is the name of a module that is loaded to process this part of the file. The only value currently available is db_file. |
| logging_info | logging_info | Yes | None | The primary logging container that defines the logging parameters. |
| logitem | logitem NONE | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem SYSERR | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem OBJERR | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem PROTOCOL | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem PROTERR | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem WARN | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem WARNING | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem CONFIG | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem EVENT | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem PARSEERR | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem ACTION | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem ACNTING | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem STAT | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem TRACE | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem RTRACE | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| logitem | logitem START | No | All default to not enabled. | Enables the logging level. Multiple lines are allowed. |
| numLogFiles | numLogFiles n | No | 0 | Specifies the number of log files to create. The log rotates when the first one fills. n is the number of files to create. |
| logFileSize | logFileSize n | No | 0 | Specifies the size of each log file in 1024-byte units. |
| logFileName | logFileName path | No | None | Specifies the path to the first log file. The original log
file is named filename or filename.extension.
When a file is rotated, it is renamed beginning with the base filename,
then either appending a number or replacing the extension with a number.
For example, if the original file name is file, the
rotated file name becomes file01. If the original
file name is file.log, it becomes file.01. |
| CharFlag | charflag yes | No | true | Not applicable to this operating system's DHCP server, but the OS/2 DHCP server uses it to produce debug windows. |
| CharFlag | charflag true | No | true | Not applicable to this operating system's DHCP server, but the OS/2 DHCP server uses it to produce debug windows. |
| CharFlag | charflag false | No | true | Not applicable to this operating system's DHCP server, but the OS/2 DHCP server uses it to produce debug windows. |
| CharFlag | charflag no | No | true | Not applicable to this operating system's DHCP server, but the OS/2 DHCP server uses it to produce debug windows. |
| StatisticSnapShot | StatisticSnapShot n | No | -1, never | Specifies how often statistics are written to the log file in seconds. |
| UsedIpAddressExpireInterval | UsedIpAddressExpireInterval n time_units | No | -1, never | Specifies how often addresses placed in the BAD state are recouped and retested for validity. |
| leaseExpireInterval | leaseExpireInterval n time_units | No | 900 seconds | Specifies how often addresses in the BOUND state are checked to see if they have expired. If the address has expired, the state is moved to EXPIRED. |
| reservedTime | reservedTime n time_units | No | -1, never | Specifies how long addresses should sit in RESERVED state before being recouped into the FREE state. |
| reservedTimeInterval | reservedTimeInterval n time_units | No | 900 seconds | Specifies how often addresses in the RESERVE state are checked to see if they should be recouped into the FREE state. |
| saveInterval | saveInterval n time_units | No | 3600 seconds | Specifies how often the DHCP server should force a save of the open databases. For heavily loaded servers, this should be 60 or 120 seconds. |
| clientpruneintv | clientpruneintv n time_units | No | 3600 seconds | Specifies how often the DHCP server has the databases remove clients are not associated with any address (in the UNKNOWN state). This reduces the memory use of the DHCP server. |
| numprocessors | numprocessors n | No | 10 | Specifies the number of packet processors to create. Minimum of one. |
| userObject | userObject obj_name | Yes | None | Indicates that the server should load a user-defined shared
object and call routines within this object through each interaction
with DHCP clients. The object to be loaded is located in the /usr/sbin directory
by the name obj_name.dhcpo. See the DHCP
Server User-Defined Extension API for more information. |
| pxeservertype | pxeservertype server_type | No | dhcp_only | Indicates the type of dhcpd server that
it is. server_type can be one of the following:
The default is |
| supportsubnetselection | supportsubnetselection global supportsubnetselection subnetlevel supportsubnetselection no |
No | None | Indicates whether the dhcp server will support the option 118 (subnet selection option) in the clients DISCOVER or REQUEST packet. global: all subnets in the configuration file will support option 118. subnetlevel: subnets that have been configured to support this option by keyword supportoption118 will support this option. no: does not support option 118. |