| .\" 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. |
| .\" 3. All advertising materials mentioning features or use of this software |
| .\" must display the following acknowledgement: |
| .\" This product includes software developed by the University of |
| .\" California, Berkeley and its contributors. |
| .\" 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 |
| .\" |
| .\" Section on valid facility and level strings added by |
| .\" and1000@debian.org, 26 Oct 1997. |
| .Dd June 6, 1993 |
| .Dt LOGGER 1 |
| .Os BSD 4.3 |
| .Sh NAME |
| .Nm logger |
| .Nd a shell command interface to the syslog(3) system log module |
| .Sh SYNOPSIS |
| .Nm logger |
| .Op Fl isd |
| .Op Fl f Ar file |
| .Op Fl p Ar pri |
| .Op Fl t Ar tag |
| .Op Fl u Ar socket |
| .Op Ar message ... |
| .Sh DESCRIPTION |
| .Nm Logger |
| makes entries in the system log. |
| It provides a shell command interface to the |
| .Xr syslog 3 |
| system log module. |
| .Pp |
| Options: |
| .Pp |
| .Bl -tag -width "message" |
| .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 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 . |
| .It Fl u Ar sock |
| Write to socket as specified with |
| .Ar socket |
| instead of builtin syslog routines. |
| .It Fl d |
| Use a datagram instead of a stream connection to this socket. |
| .It -- |
| End the argument list. This is to allow the |
| .Ar message |
| to start with a hyphen (\-). |
| .It Ar message |
| Write the message to log; if not specified, and the |
| .Fl f |
| flag is not |
| provided, standard input is logged. |
| .El |
| .Pp |
| The |
| .Nm logger |
| utility exits 0 on success, and >0 if an error occurs. |
| .Pp |
| Valid facility names are: auth, authpriv (for security information of |
| a sensitive nature), cron, daemon, ftp, kern, lpr, mail, news, |
| security (deprecated synonym for auth), syslog, user, uucp, and local0 |
| to local7, inclusive. |
| .Pp |
| Valid level names are): |
| alert, crit, debug, emerg, err, error (deprecated synonym for err), |
| info, notice, panic (deprecated synonym for emerg), warning, |
| warn (deprecated synonym for warning). |
| For the priority order and intended purposes of these levels, see |
| .Xr syslog 3 . |
| .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 logger |
| command is expected to be |
| .St -p1003.2 |
| compatible. |
| .Sh AVAILABILITY |
| The logger command is part of the util-linux-ng package and is available from |
| ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/. |