Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
KEA-SHELL - TEXT ...DHCP-DDNS SERVERS()  KEA-SHELL - TEXT ...DHCP-DDNS SERVERS()

NAME
     kea-shell	- Text client for kea-dhcp4, kea-dhcp6 and kea-dhcp-ddns servers
     -

     System Message: ERROR/3 (kea-shell.8.rst:, line 11)
	    Unknown directive type "iscman".

	.. iscman:: kea-shell

SYNOPSIS
     :program:`kea-shell`
      [-h] [-v] [--host] [--port] [--path] [--ca] [--cert] [--key] [--auth-user]
     [--auth-password] [--auth-password-file] [--timeout] [--service] [command]

     System Message: ERROR/3 (kea-shell.8.rst:, line 19)
	    Unknown interpreted text role "program".

DESCRIPTION
     The kea-shell provides a REST client for the Kea kea-dhcp4,  kea-dhcp6  and
     kea-dhcp-ddns  servers.  Previously it was meant for the Control Agent (CA)
     daemon, which is deprecated (removed).  It takes commands as a command-line
     parameter that is sent to the Kea server with  proper  JSON  encapsulation.
     Optional  arguments  may be specified on the standard input. The request is
     sent via HTTP and a response is retrieved, displayed on the  standard  out-
     put.  Basic  HTTP	authentication	and  HTTPS, i.e. TLS transport, are sup-
     ported.

ARGUMENTS
     The arguments are as follows:

     -h     Displays help regarding command-line parameters.

     -v     Displays the Kea version.

     --host
	    Specifies the host to connect to. The Kea server must be running  at
	    the specified host. If not specified, 127.0.0.1 is used.

     --port
	    Specifies  the  TCP port to connect to. The server must be listening
	    at the specified port. If not specified, 8000 is used.

     --path
	    Specifies the path in the URL to connect to. If  not  specified,  an
	    empty  path  is  used. As Kea servers listen at the empty path, this
	    parameter is useful only with a reverse proxy.

     --ca   Specifies the file or directory name of the Certification Authority.
	    If not specified, HTTPS is not used.

     --cert
	    Specifies the file name of the user end-entity public  key	certifi-
	    cate.   If	specified,  the  file  name of the user key must also be
	    specified.

     --key  Specifies the file name of the user key file. If specified, the file
	    name of the user certificate must also be specified.  Encrypted  key
	    files are not supported.

     --auth-user
	    Specifies  the  user ID for basic HTTP authentication. If not speci-
	    fied, or specified as the empty string, authentication is not used.

     --auth-password
	    Specifies the password for basic HTTP authentication. If not  speci-
	    fied  but  the  user ID is specified, an empty password is used.  If
	    used together with --auth-password-file, it is disregarded.

     --auth-password-file
	    Specifies a text file whose first line contains the password  to  be
	    used  for basic HTTP authentication. This flag takes precedence over
	    --auth-password flag.

     --timeout
	    Specifies the connection timeout, in seconds. The default is 10.

     --service
	    (Obsolete) Kea kea-dhcp4, kea-dhcp6 and kea-dhcp-ddns servers ignore
	    this argument. It was meant for communication with	deprecated  (re-
	    moved)  Control  Agent  daemon.   If  used with Kea version prior to
	    2.7.2: specifies the service that is the target of a command. If not
	    specified, the Control Agent itself is targeted.  May be  used  more
	    than once to specify multiple targets.

     command
	    Specifies  the  command  to be sent to the server. If not specified,
	    list-commands is used.

DOCUMENTATION
     Kea comes with an extensive Kea Administrator Reference Manual that  covers
     all  aspects  of running the Kea software - compilation, installation, con-
     figuration, 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  documenta-
     tion 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 con-
     tributors, 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-shell was first coded in March 2017 by Tomek Mrugalski.

SEE ALSO
     :manpage:`kea-dhcp4(8)`
     ,
     :manpage:`kea-dhcp6(8)`
     ,
     :manpage:`kea-dhcp-ddns(8)`
     ,

     :manpage:`kea-admin(8)`
     ,
     :manpage:`keactrl(8)`
     ,

     :manpage:`perfdhcp(8)`
     ,
     :manpage:`kea-lfc(8)`
     , Kea Administrator Reference Manual.

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

     System Message: ERROR/3 (kea-shell.8.rst:, line 138)
	    Unknown interpreted text role "manpage".

					 KEA-SHELL - TEXT ...DHCP-DDNS SERVERS()

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=kea-shell&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help