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

FreeBSD Manual Pages

  
 
  

home | help
LOGGER(1)		  BSD General Commands Manual		     LOGGER(1)

NAME
     logger -- make entries in the system log

SYNOPSIS
     logger [-46Ais] [-f file] [-H hostname] [-h host] [-P port] [-p pri]
	    [-S	addr:port] [-t tag] [message ...]

DESCRIPTION
     The logger	utility	provides a shell command interface to the syslog(3)
     system log	module.

     The following options are available:

     -4	     Force logger to use IPv4 addresses	only.

     -6	     Force logger to use IPv6 addresses	only.

     -A	     By	default, logger	tries to send the message to only one address,
	     even if the host has more than one	A or AAAA record.  If this op-
	     tion is specified,	logger tries to	send the message to all	ad-
	     dresses.

     -i	     Log the process id	of the logger process with each	line.

     -s	     Log the message to	standard error,	as well	as the system log.

     -f	file
	     Read the contents of the specified	file into syslog.  This	option
	     is	ignored	when a message is also specified.

     -H	hostname
	     Set the hostname in the header of the message to specified	value.
	     If	not specified, host part of gethostname(3) will	be used.

     -h	host
	     Send the message to the remote system host	instead	of logging it
	     locally.  Note that logger	currently supports AF_INET (IPv4),
	     AF_INET6 (IPv6), and AF_LOCAL (Unix-domain	socket)	address	fami-
	     lies.  The	following address formats are valid in host:

	     AF_INET   192.168.2.1
	     AF_INET6  2001:db8::1
	     AF_LOCAL  /var/run/log

     -P	port
	     Send the message to the specified port number on a	remote system,
	     which can be specified as a service name or as a decimal number.
	     The default is "syslog".  If an unknown service name is used,
	     logger prints a warning and falls back to port 514.

     -p	pri  Enter the message with the	specified priority.  The priority may
	     be	specified numerically or as a facility.level pair.  For	exam-
	     ple, "-p local3.info" logs	the message(s) as informational	level
	     in	the local3 facility.  The default is "user.notice".

     -S	addr:port
	     Specify source address and/or source port when using -h option.
	     The same address will be used for all of the remote addresses
	     when -A flag is enabled.  Note that a numeric IPv6	address	in
	     addr must be enclosed with	"[" and	"]".

     -t	tag  Mark every	line in	the log	with the specified tag rather than the
	     default of	current	login name.

     message
	     Write the message to log; if not specified, and the -f flag is
	     not provided, standard input is logged.

EXIT STATUS
     The logger	utility	exits 0	on success, and	>0 if an error occurs.

EXAMPLES
	   logger System rebooted

	   logger -p local0.notice -t HOSTIDM -f /dev/idmc

SEE ALSO
     syslog(3),	syslogd(8)

STANDARDS
     The logger	command	is expected to be IEEE Std 1003.2 ("POSIX.2") compati-
     ble.

BSD			       December	5, 2017				   BSD

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | SEE ALSO | STANDARDS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=logger&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help