1KEA-LFC(8)                            Kea                           KEA-LFC(8)
2
3
4

NAME

6       kea-lfc - Lease File Cleanup process in Kea
7

SYNOPSIS

9       kea-lfc  [-4**|-6**]  [-c config-file] [-p pid-file] [-x previous-file]
10       [-i copy-file] [-o output-file] [-f finish-file] [-v]  [-V]  [-W]  [-d]
11       [-h]
12

DESCRIPTION

14       The  kea-lfc  service  process  removes  redundant information from the
15       files used to provide persistent storage for the memfile database back‐
16       end.  The  service is written to run as a stand-alone process. While it
17       can be started externally, there is usually no need to do this.  It  is
18       run periodically by the Kea DHCP servers.
19

ARGUMENTS

21       The arguments are as follows:
22
23       -4 | -6
24              Indicates  the  protocol  version  of  the  lease files; must be
25              either 4 or 6.
26
27       -c config-file
28              Specifies the  file  with  the  configuration  for  the  kea-lfc
29              process. It may also contain configuration entries for other Kea
30              services. Currently kea-lfc gets all of its arguments  from  the
31              command  line;  in the future it will be extended to obtain some
32              arguments from the configuration file.
33
34       -p pid-file
35              Specifies the PID file. When  the  kea-lfc  process  starts,  it
36              attempts  to  determine  if  another  instance of the process is
37              already running by examining the PID file.  If  one  is  already
38              running,  the  new process is terminated. If one is not running,
39              Kea writes its PID into the PID file.
40
41       -x previous-file
42              Specifies the previous or ex-lease file.  When  kea-lfc  starts,
43              this  is the result of any previous run of kea-lfc; when kea-lfc
44              finishes, it is the result of this run.  If  kea-lfc  is  inter‐
45              rupted before completing, this file may not exist.
46
47       -i copy-file
48              Specifies  the  input  or  copy  of  lease file. Before the DHCP
49              server invokes kea-lfc, it will move the current lease file here
50              and then call kea-lfc with this file.
51
52       -o output-file
53              Specifies  the  output  lease  file, which is the temporary file
54              kea-lfc should use to write the leases. Once this file  is  fin‐
55              ished writing, it is moved to the finish file (see below).
56
57       -f finish-file
58              Specifies  the finish or completion file, another temporary file
59              kea-lfc uses for bookkeeping. When kea-lfc finishes writing  the
60              output  file,  it moves it to this file name. After kea-lfc fin‐
61              ishes deleting the other files (previous and  input),  it  moves
62              this  file  to  the  previous lease file. By moving the files in
63              this fashion, the kea-lfc and  the  DHCP  server  processes  can
64              determine  the  correct file to use even if one of the processes
65              was interrupted before completing its task.
66
67       -v     Causes the version stamp to be printed.
68
69       -V     Causes a longer form of the version stamp to be printed.
70
71       -W     Displays the configuration report.
72
73       -d     Sets the logging level to debug with extra  verbosity.  This  is
74              primarily for development purposes in stand-alone mode.
75
76       -h     Causes the usage string to be printed.
77

DOCUMENTATION

79       Kea  comes  with  an  extensive Kea Administrator Reference Manual that
80       covers all aspects of running the Kea software - compilation, installa‐
81       tion,  configuration,  configuration  examples, and much more. Kea also
82       features a Kea Messages Manual, which lists all possible  messages  Kea
83       can print with a brief description for each of them. Both documents are
84       available in various formats (.txt, .html, .pdf) with the Kea distribu‐
85       tion.      The      Kea      documentation      is     available     at
86       https://kb.isc.org/docs/kea-administrator-reference-manual .
87
88       Kea source code is documented in the Kea Developer's Guide. Its  online
89       version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
90
91       The Kea project website is available at https://kea.isc.org.
92

MAILING LISTS AND SUPPORT

94       There  are  two  public  mailing  lists  available for the Kea project.
95       kea-users (kea-users at lists.isc.org) is intended for Kea users, while
96       kea-dev  (kea-dev  at  lists.isc.org)  is  intended for Kea developers,
97       prospective contributors, and other  advanced  users.  Both  lists  are
98       available  at https://lists.isc.org. The community provides best-effort
99       support on both of those lists.
100
101       ISC   provides   professional   support   for   Kea    services.    See
102       https://www.isc.org/kea/ for details.
103

HISTORY

105       The kea-lfc process was first coded in January 2015 by the ISC Kea/DHCP
106       team.
107

SEE ALSO

109       kea-dhcp4(8),   kea-dhcp6(8),   kea-dhcp-ddns(8),    kea-ctrl-agent(8),
110       kea-admin(8),  keactrl(8), perfdhcp(8), kea-netconf(8), Kea Administra‐
111       tor Reference Manual.
112

AUTHOR

114       Internet Systems Consortium
115
117       2020, Internet Systems Consortium
118
119
120
121
1221.7.9                            Jul 28, 2020                       KEA-LFC(8)
Impressum