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

FreeBSD Manual Pages

  
 
  

home | help
LOGGER(1)		    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 ad-
	       dress, even if the host has more	than one A or AAAA record.  If
	       this option is specified, logger	tries to send the  message  to
	       all addresses.

       -i      Log  the	process	id of the logger process with each line.  This
	       flag is ignored and the process id is always logged.  See  also
	       -t.

       -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 op-
	       tion 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)  ad-
	       dress  families.	  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  sys-
	       tem,  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
	       example,	 "-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.  Use -t tag[N] to	insert
	       specific	decimal	process	id instead of id of logger.

       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") com-
       patible.

FreeBSD	13.2			 July 3, 2023			     LOGGER(1)

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

home | help