1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
..
Copyright (C) 2019-2023 Internet Systems Consortium, Inc. ("ISC")
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/.
See the COPYRIGHT file distributed with this work for additional
information regarding copyright ownership.
.. iscman:: kea-dhcp4
``kea-dhcp4`` - DHCPv4 server in Kea
------------------------------------
Synopsis
~~~~~~~~
:program:`kea-dhcp4` [**-v**] [**-V**] [**-W**] [**-d**] [**-c** config-file] [**-t** config-file] [**-p** server-port-number] [**-P** client-port-number]
Description
~~~~~~~~~~~
The ``kea-dhcp4`` daemon provides the DHCPv4 server implementation.
Arguments
~~~~~~~~~
The arguments are as follows:
``-v``
Displays the version.
``-V``
Displays the extended version.
``-W``
Displays the configuration report.
``-d``
Enables the debug mode with extra verbosity.
``-c config-file``
Specifies the configuration file with the configuration for the DHCPv4 server. It
may also contain configuration entries for other Kea services.
``-t config-file``
Checks the configuration file and reports the first error, if any. Note
that not all parameters are completely checked; in particular,
service and control channel sockets are not opened, and hook
libraries are not loaded.
``-T config-file``
Checks the configuration file and reports the first error, if any.
It performs extra checks beyond what -t offers, such as establishing
database connections (for the lease backend, host reservations backend,
configuration backend, and forensic logging backend), loading hook libraries,
parsing hook-library configurations, etc. It does not open UNIX or TCP/UDP sockets,
nor does it open or rotate files, as any of these actions could interfere
with a running process on the same machine.
``-p server-port-number``
Specifies the server port number (1-65535) on which the server listens. This is
useful for testing purposes only.
``-P client-port-number``
Specifies the client port number (1-65535) to which the server responds. This is
useful for testing purposes only.
Documentation
~~~~~~~~~~~~~
Kea comes with an extensive Kea Administrator Reference Manual that covers
all aspects of running the Kea software - compilation, installation,
configuration, configuration examples, and much more. Kea also features a
Kea Messages Manual, which lists all possible messages Kea can print
with a brief description for each of them. Both documents are
available in various formats (.txt, .html, .pdf) with the Kea
distribution. The Kea documentation is available at
https://kea.readthedocs.io.
Kea source code is documented in the Kea Developer's Guide,
available at https://reports.kea.isc.org/dev_guide/.
The Kea project website is available at https://kea.isc.org.
Mailing Lists and Support
~~~~~~~~~~~~~~~~~~~~~~~~~
There are two public mailing lists available for the Kea project. **kea-users**
(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
(kea-dev at lists.isc.org) is intended for Kea developers, prospective
contributors, and other advanced users. Both lists are available at
https://lists.isc.org. The community provides best-effort support
on both of those lists.
ISC provides professional support for Kea services. See
https://www.isc.org/kea/ for details.
History
~~~~~~~
The ``b10-dhcp4`` daemon was first coded in November 2011 by Tomek
Mrugalski.
In mid-2014, Kea was decoupled from the BIND 10 framework and became a
standalone DHCP server. The DHCPv4 server binary was renamed to
``kea-dhcp4``. Kea 1.0.0 was released in December 2015.
See Also
~~~~~~~~
:manpage:`kea-dhcp6(8)`, :manpage:`kea-dhcp-ddns(8)`,
:manpage:`kea-ctrl-agent(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
:manpage:`perfdhcp(8)`, :manpage:`kea-netconf(8)`, :manpage:`kea-lfc(8)`,
Kea Administrator Reference Manual.
|