/usr.bin/logger/logger.1
https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 129 lines · 128 code · 1 blank · 0 comment · 0 complexity · 108da3efbc9e1e54b1b5b6acc3e796ee MD5 · raw file
- .\" Copyright (c) 1983, 1990, 1993
- .\" The Regents of the University of California. All rights reserved.
- .\"
- .\" Redistribution and use in source and binary forms, with or without
- .\" modification, are permitted provided that the following conditions
- .\" are met:
- .\" 1. Redistributions of source code must retain the above copyright
- .\" notice, this list of conditions and the following disclaimer.
- .\" 2. Redistributions in binary form must reproduce the above copyright
- .\" notice, this list of conditions and the following disclaimer in the
- .\" documentation and/or other materials provided with the distribution.
- .\" 4. Neither the name of the University nor the names of its contributors
- .\" may be used to endorse or promote products derived from this software
- .\" without specific prior written permission.
- .\"
- .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
- .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
- .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
- .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
- .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- .\" SUCH DAMAGE.
- .\"
- .\" @(#)logger.1 8.1 (Berkeley) 6/6/93
- .\" $FreeBSD$
- .\"
- .Dd August 2, 2006
- .Dt LOGGER 1
- .Os
- .Sh NAME
- .Nm logger
- .Nd make entries in the system log
- .Sh SYNOPSIS
- .Nm
- .Op Fl 46Ais
- .Op Fl f Ar file
- .Op Fl h Ar host
- .Op Fl P Ar port
- .Op Fl p Ar pri
- .Op Fl t Ar tag
- .Op Ar message ...
- .Sh DESCRIPTION
- The
- .Nm
- utility provides a shell command interface to the
- .Xr syslog 3
- system log module.
- .Pp
- The following options are available:
- .Bl -tag -width indent
- .It Fl 4
- Force
- .Nm
- to use IPv4 addresses only.
- .It Fl 6
- Force
- .Nm
- to use IPv6 addresses only.
- .It Fl A
- By default,
- .Nm
- tries to send the message to only one address,
- even if the host has more than one A or AAAA record.
- If this option is specified,
- .Nm
- tries to send the message to all addresses.
- .It Fl i
- Log the process id of the logger process
- with each line.
- .It Fl s
- Log the message to standard error, as well as the system log.
- .It Fl f Ar file
- Log the specified file.
- .It Fl h Ar host
- Send the message to the remote system
- .Ar host
- instead of logging it locally.
- .It Fl P Ar port
- Send the message to the specified
- .Ar port
- number on a remote system,
- which can be specified as a service name
- or as a decimal number.
- The default is
- .Dq Li syslog .
- If an unknown service name is used,
- .Nm
- prints a warning and falls back to port 514.
- .It Fl p Ar 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
- .Ar info Ns rmational
- level in the
- .Ar local3
- facility.
- The default is ``user.notice.''
- .It Fl t Ar tag
- Mark every line in the log with the specified
- .Ar tag
- rather than the default of current login name.
- .It Ar message
- Write the message to log; if not specified, and the
- .Fl f
- flag is not
- provided, standard input is logged.
- .El
- .Sh EXIT STATUS
- .Ex -std
- .Sh EXAMPLES
- .Bd -literal -offset indent -compact
- logger System rebooted
- logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
- .Ed
- .Sh SEE ALSO
- .Xr syslog 3 ,
- .Xr syslogd 8
- .Sh STANDARDS
- The
- .Nm
- command is expected to be
- .St -p1003.2
- compatible.