kea-lfc - Lease File Cleanup process in Kea
Synopsis
kea-lfc [-4**|-6**] [-c config-file] [-p pid-file] [-x previous-file] [-i copy-file] [-o output-file] [-f finish-file] [-v] [-V] [-W] [-d] [-h]
Description
The kea-lfc service process removes redundant information from the
files used to provide persistent storage for the memfile database
backend. The service is written to run as a stand-alone process. While
it can be started externally, there is usually no need to do this. It
is run periodically by the Kea DHCP servers.
Arguments
The arguments are as follows:
-4 | -6Indicates the protocol version of the lease files; must be either 4 or 6.
-c config-fileSpecifies the file with the configuration for the
kea-lfcprocess. It may also contain configuration entries for other Kea services. Currentlykea-lfcgets all of its arguments from the command line.-p pid-fileSpecifies the PID file. When the
kea-lfcprocess starts, it attempts to determine if another instance of the process is already running, by examining the PID file. If one is already running, the new process is terminated. If one is not running, Kea writes its PID into the PID file.-x previous-fileSpecifies the previous or ex-lease file. When
kea-lfcstarts, this is the result of any previous run ofkea-lfc; whenkea-lfcfinishes, it is the result of the current run. Ifkea-lfcis interrupted before completing, this file may not exist.-i copy-fileSpecifies the input or copy of lease file. Before the DHCP server invokes
kea-lfc, it moves the current lease file here and then callskea-lfcwith this file.-o output-fileSpecifies the output lease file, which is the temporary file
kea-lfcshould use to write the leases. Once this file is finished writing, it is moved to the finish file (see below).-f finish-fileSpecifies the finish or completion file, another temporary file
kea-lfcuses for bookkeeping. Whenkea-lfcfinishes writing the output file, it moves it to this file name. Afterkea-lfcfinishes deleting the other files (previous and input), it moves this file to the previous lease file. By moving the files in this fashion, thekea-lfcand the DHCP server processes can determine the correct file to use even if one of the processes was interrupted before completing its task.-vDisplays the Kea version.
-VDisplays the extended Kea version.
-WDisplays the configuration report.
-dSets the logging level to debug with extra verbosity. This is primarily for development purposes in stand-alone mode.
-hCauses the usage string to be printed.
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 kea-lfc process was first coded in January 2015 by the ISC
Kea/DHCP team.
See Also
kea-dhcp4(8), kea-dhcp6(8), kea-dhcp-ddns(8), kea-ctrl-agent(8), kea-admin(8), keactrl(8), perfdhcp(8), kea-netconf(8), Kea Administrator Reference Manual.