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

FreeBSD Manual Pages

  
 
  

home | help
KEA-SHELL - TEXT...HCP-DDNS SERVERS()	 KEA-SHELL - TEXT...HCP-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.	It takes commands  as  a  com-
       mand-line parameter that	is sent	to the Kea server with proper JSON en-
       capsulation. Optional arguments may be specified	on the standard	input.
       The  request is sent via	HTTP and a response is retrieved, displayed on
       the standard output. Basic HTTP	authentication	and  HTTPS,  i.e.  TLS
       transport, are supported.

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 listen-
	      ing 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 Au-
	      thority.	If not specified, HTTPS	is not used.

       --cert Specifies	the file name of the user end-entity public  key  cer-
	      tificate.	 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.   En-
	      crypted key files	are not	supported.

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

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

       --auth-password-file
	      Specifies	a text file whose first	line contains the password  to
	      be  used	for  basic HTTP	authentication.	This flag takes	prece-
	      dence 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	depre-
	      cated  Control  Agent daemon.  If	used with Kea version <	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	speci-
	      fied, list-commands is used.

DOCUMENTATION
       Kea  comes  with	 an  extensive Kea Administrator Reference Manual that
       covers all aspects of running the Kea software -	compilation, installa-
       tion, 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 distribu-
       tion. 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-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-ctrl-agent(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 139)
	      Unknown interpreted text role "manpage".

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

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

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

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

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

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

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

					 KEA-SHELL - TEXT...HCP-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.0>

home | help