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

FreeBSD Manual Pages

  
 
  

home | help
send_nsca.cfg(5)	      The NSCA-ng Manual	      send_nsca.cfg(5)

NAME
       send_nsca.cfg - NSCA-ng client configuration file

SYNOPSIS
       /usr/local/etc/send_nsca.cfg

DESCRIPTION
       The  send_nsca(8) process reads configuration data from the file	speci-
       fied with -c on the command line	or from	/usr/local/etc/send_nsca.cfg.

   File	Format
       Configuration settings are defined by specifying	a variable  name  fol-
       lowed  by an equals sign	("=") and a value, one setting per line.  Val-
       ues can be strings or integers.	Strings	have to	be enclosed in	single
       or double quotes	if they	contain	whitespace characters, hash mark char-
       acters,	or  literal  quotation marks.  Otherwise, quoting is optional.
       To specify a literal single or double quote in a	string,	either	escape
       it by preceding it with a backslash ("\") or quote the string using the
       other  quote  character.	  A  literal backslash must be preceded	with a
       second backslash.

       Any whitespace surrounding tokens is ignored.  Empty lines and comments
       are also	ignored.  Comments are introduced with a hash  mark  character
       ("#") and span to the end of the	line.  If the last character of	a line
       is  a backslash ("\"), the subsequent line is treated as	a continuation
       of the current line (and	the backslash is otherwise ignored).

   Settings
       The send_nsca(8)	client recognizes the following	variables.   They  may
       appear  in arbitrary order.  The	type of	each value is denoted after an
       equals sign in angle brackets.

       delay = <integer>
	      Wait for a random	number of seconds between 0 and	the  specified
	      delay before contacting the server.  This	might be useful	to re-
	      duce  the	 server	 load if many send_nsca(8) clients are invoked
	      simultaneously.	The  default  setting  is   0,	 which	 tells
	      send_nsca(8)  to	connect	to the server immediately.  The	speci-
	      fied value will be ignored if send_nsca(8) is called with	the -D
	      option.

       encryption_method = <string>
	      This setting is ignored.	It is accepted for compatibility  with
	      NSCA 2.x.

       identity	= <string>
	      Send  the	 specified  client identity to the server.  The	client
	      identity is used for authentication and authorization.  The same
	      identity may be provided by multiple clients.  By	 default,  the
	      local host name will be used.

       password	= <string>
	      Use  the specified passphrase for	authentication and encryption.
	      The default password is "change-me".  Change it!

       port = <string>
	      Connect to the specified service name  or	 port  number  on  the
	      server  instead of using the default port	(5668).	 The specified
	      value will be ignored if send_nsca(8) is called with the -p  op-
	      tion.

       server =	<string>
	      Connect  and  talk to the	specified server address or host name.
	      The default server is "localhost".  The specified	value will  be
	      ignored if send_nsca(8) is called	with the -H option.

       timeout = <integer>
	      Close the	connection if the server didn't	respond	for the	speci-
	      fied   number   of  seconds.   If	 the  timeout  is  set	to  0,
	      send_nsca(8) won't enforce  connection  timeouts.	  The  default
	      timeout  is  15 seconds.	The specified value will be ignored if
	      send_nsca(8) is called with the -o option.

       tls_ciphers = <string>
	      Limit the	cipher suites offered during the  TLS  negotiation  to
	      the  specified list of ciphers.  The format of the string	is de-
	      scribed in the ciphers(1)	manual.	 By default,  the  ciphers  in
	      the list PSK-AES256-CBC-SHA:PSK-AES128-CBC-SHA:PSK-3DES-EDE-CBC-
	      SHA:PSK-RC4-SHA will be offered.

EXAMPLES
       The /usr/local/etc/send_nsca.cfg	file might look	similar	to the follow-
       ing example.

	      identity = "web-checker"
	      password = "djMKCIcurJJLSQGT5qIhCfqCHQLTcvp9"
	      server = "monitoring.example.com"
	      tls_ciphers = "PSK-AES256-CBC-SHA"
	      delay = 2
	      port = 5668
	      timeout =	10

CAVEATS
       Please  set the permissions appropriately to make sure that only	autho-
       rized users can access the /usr/local/etc/send_nsca.cfg file.

SEE ALSO
       send_nsca(8), nsca-ng(8), nsca-ng.cfg(5),

       http://www.nagios.org/developerinfo/externalcommands/

AUTHOR
       Holger Weiss <holger@weiss.in-berlin.de>

Version	1.6			March 19, 2019		      send_nsca.cfg(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=send_nsca.cfg&sektion=5&manpath=FreeBSD+Ports+15.0>

home | help