keama/keama.8

   1 .\"     keama.8
   2 .\"
   3 .\" Copyright (c) 2017-2019 by Internet Systems Consortium, Inc. ("ISC")
   4 .\"
   5 .\" Permission to use, copy, modify, and distribute this software for any
   6 .\" purpose with or without fee is hereby granted, provided that the above
   7 .\" copyright notice and this permission notice appear in all copies.
   8 .\"
   9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
  10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 .\" MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
  12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  15 .\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 .\"
  17 .\"   Internet Systems Consortium, Inc.
  18 .\"   PO Box 360
  19 .\"   Newmarket, NH 03857 USA
  20 .\"   <info@isc.org>
  21 .\"   https://www.isc.org/
  22 .\"
  23 .\" This software has been written for Internet Systems Consortium
  24 .\" by Ted Lemon in cooperation with Vixie Enterprises.
  25 .\"
  26 .\" Support and other services are available for ISC products - see
  27 .\" https://www.isc.org for more information or to learn more about ISC.
  28 .\"
  29 .TH keama 8
  30 .SH NAME
  31 keama - Kea Migration Assistant
  32 .SH SYNOPSIS
  33 .B keama
  34 [
  35 .B -4
  36 |
  37 .B -6]
  38 [
  39 .B -D
  40 ]
  41 [
  42 .B -N
  43 ]
  44 [
  45 .B -r
  46 .I {perform|fatal|pass}
  47 ]
  48 [
  49 .B -l
  50 .I hook-library-path
  51 ]
  52 [
  53 .B -i
  54 .I input-file
  55 ]
  56 [
  57 .B -o
  58 .I output-file
  59 ]
  60 .SH DESCRIPTION
  61 The Kea Migration Assistant converts an ISC DHCP configuration file into
  62 the corresponding Kea configuration file.
  63 .SH COMMAND LINE
  64 .PP
  65 \fIProtocol selection options:\fR
  66 .TP
  67 -4
  68 The input configuration is for DHCPv4.  Incompatible with the \fB-6\fR
  69 option.
  70 .TP
  71 -6
  72 The input configuration is for DHCPv6.  Incompatible with the \fB-4\fR
  73 option.
  74 .TP
  75 -D
  76 Define ISC DHCP minimum, default and maximum builtin lifetimes.
  77 .TP
  78 -N
  79 Instead of using global host reservations, put them in the matching subnet.
  80 .TP
  81 -r \fIaction\fR
  82 Specify what to do with hostnames: resolve them into their first address,
  83 raise a fatal error or pass them silently.
  84 .TP
  85 -p hook-library-path
  86 Specify the path where hook libraries (e.g. flex-id) can be found
  87 .TP
  88 -i input-file
  89 Specify the ISC DHCP configuration file to read. When it is not
  90 given the standard input is used.
  91 .TP
  92 -o output-file
  93 Specify the Kea configuration file to write. When it is not given
  94 the standard output is used.
  95 .PP
  96 The number of conversion failures is returned. Note that any parsing warning
  97 or error is fatal so please check and fix the ISC DHCP configuration file
  98 before using this tool.
  99 .SH SEE ALSO
 100 dhcpd(8), kea-dhcp4(8), kea-dhcp6(8).
 101 .SH AUTHOR
 102 .B keama(8)
 103 To learn more about Internet Systems Consortium, see
 104 .B https://www.isc.org