.\"	$NetBSD: keama.8,v 1.3 2022/04/03 01:10:59 christos Exp $
.\"
.\"	keama.8
.\"
.\" Copyright (C) 2017-2022 Internet Systems Consortium, Inc. ("ISC")
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\"   Internet Systems Consortium, Inc.
.\"   PO Box 360
.\"   Newmarket, NH 03857 USA
.\"   <info@isc.org>
.\"   https://www.isc.org/
.\"
.\" This software has been written for Internet Systems Consortium
.\" by Ted Lemon in cooperation with Vixie Enterprises.
.\"
.\" Support and other services are available for ISC products - see
.\" https://www.isc.org for more information or to learn more about ISC.
.\"
.TH keama 8
.SH NAME
keama - Kea Migration Assistant
.SH SYNOPSIS
.B keama
[
.B -4
|
.B -6]
[
.B -D
]
[
.B -N
]
[
.B -r
.I {perform|fatal|pass}
]
[
.B -l
.I hook-library-path
]
[
.B -i
.I input-file
]
[
.B -o
.I output-file
]
.SH DESCRIPTION
The Kea Migration Assistant converts an ISC DHCP configuration file into
the corresponding Kea configuration file.
.SH COMMAND LINE
.PP
\fIProtocol selection options:\fR
.TP
-4
The input configuration is for DHCPv4.  Incompatible with the \fB-6\fR
option.
.TP
-6
The input configuration is for DHCPv6.  Incompatible with the \fB-4\fR
option.
.TP
-D
Define ISC DHCP minimum, default and maximum builtin lifetimes.
.TP
-N
Instead of using global host reservations, put them in the matching subnet.
.TP
-r \fIaction\fR
Specify what to do with hostnames: resolve them into their first address,
raise a fatal error or pass them silently.
.TP
-p hook-library-path
Specify the path where hook libraries (e.g. flex-id) can be found
.TP
-i input-file
Specify the ISC DHCP configuration file to read. When it is not
given the standard input is used.
.TP
-o output-file
Specify the Kea configuration file to write. When it is not given
the standard output is used.
.PP
The number of conversion failures is returned. Note that any parsing warning
or error is fatal so please check and fix the ISC DHCP configuration file
before using this tool.
.SH SEE ALSO
dhcpd(8), kea-dhcp4(8), kea-dhcp6(8).
.SH AUTHOR
.B keama(8)
To learn more about Internet Systems Consortium, see
.B https://www.isc.org