xref: /freebsd/usr.bin/logger/logger.1 (revision 3e32fa38602f6b2399a14d286537a5c83bf81914)
19b50d902SRodney W. Grimes.\" Copyright (c) 1983, 1990, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"	@(#)logger.1	8.1 (Berkeley) 6/6/93
33c3aac50fSPeter Wemm.\" $FreeBSD$
349b50d902SRodney W. Grimes.\"
359b50d902SRodney W. Grimes.Dd June 6, 1993
369b50d902SRodney W. Grimes.Dt LOGGER 1
3762500372SRuslan Ermilov.Os
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm logger
409b50d902SRodney W. Grimes.Nd make entries in the system log
419b50d902SRodney W. Grimes.Sh SYNOPSIS
42df071556SPhilippe Charnier.Nm
43c4646e2dSRuslan Ermilov.Op Fl 46Ais
449b50d902SRodney W. Grimes.Op Fl f Ar file
45b0fe2da8SDavid Malone.Op Fl h Ar host
469b50d902SRodney W. Grimes.Op Fl p Ar pri
479b50d902SRodney W. Grimes.Op Fl t Ar tag
489b50d902SRodney W. Grimes.Op Ar message ...
499b50d902SRodney W. Grimes.Sh DESCRIPTION
50e8937ba0SPhilippe CharnierThe
51e8937ba0SPhilippe Charnier.Nm
52e8937ba0SPhilippe Charnierutility provides a shell command interface to the
539b50d902SRodney W. Grimes.Xr syslog  3
549b50d902SRodney W. Grimessystem log module.
559b50d902SRodney W. Grimes.Pp
5683edb87bSPhilippe CharnierThe following options are available:
5783edb87bSPhilippe Charnier.Bl -tag -width indent
580b5f90afSHajimu UMEMOTO.It Fl 4
598cd319f7SPhilippe CharnierForce
600b5f90afSHajimu UMEMOTO.Nm
610b5f90afSHajimu UMEMOTOto use IPv4 addresses only.
620b5f90afSHajimu UMEMOTO.It Fl 6
638cd319f7SPhilippe CharnierForce
640b5f90afSHajimu UMEMOTO.Nm
650b5f90afSHajimu UMEMOTOto use IPv6 addresses only.
660b5f90afSHajimu UMEMOTO.It Fl A
673e32fa38SChristian BruefferBy default,
683e32fa38SChristian Brueffer.Nm
693e32fa38SChristian Brueffertries to send the message to only one address,
700b5f90afSHajimu UMEMOTOeven if the host has more than one A or AAAA record.
710b5f90afSHajimu UMEMOTOIf this option is specified,
720b5f90afSHajimu UMEMOTO.Nm
730b5f90afSHajimu UMEMOTOtries to send the message to all addresses.
749b50d902SRodney W. Grimes.It Fl i
759b50d902SRodney W. GrimesLog the process id of the logger process
769b50d902SRodney W. Grimeswith each line.
779b50d902SRodney W. Grimes.It Fl s
789b50d902SRodney W. GrimesLog the message to standard error, as well as the system log.
799b50d902SRodney W. Grimes.It Fl f Ar file
809b50d902SRodney W. GrimesLog the specified file.
81b0fe2da8SDavid Malone.It Fl h Ar host
82b0fe2da8SDavid MaloneSend the message to the remote system
83b0fe2da8SDavid Malone.Ar host
84b0fe2da8SDavid Maloneinstead of logging it locally.
859b50d902SRodney W. Grimes.It Fl p Ar pri
869b50d902SRodney W. GrimesEnter the message with the specified priority.
879b50d902SRodney W. GrimesThe priority may be specified numerically or as a ``facility.level''
889b50d902SRodney W. Grimespair.
899b50d902SRodney W. GrimesFor example, ``\-p local3.info'' logs the message(s) as
909b50d902SRodney W. Grimes.Ar info Ns rmational
919b50d902SRodney W. Grimeslevel in the
929b50d902SRodney W. Grimes.Ar local3
939b50d902SRodney W. Grimesfacility.
949b50d902SRodney W. GrimesThe default is ``user.notice.''
959b50d902SRodney W. Grimes.It Fl t Ar tag
969b50d902SRodney W. GrimesMark every line in the log with the specified
979b50d902SRodney W. Grimes.Ar tag  .
989b50d902SRodney W. Grimes.It Ar message
999b50d902SRodney W. GrimesWrite the message to log; if not specified, and the
1009b50d902SRodney W. Grimes.Fl f
1019b50d902SRodney W. Grimesflag is not
1029b50d902SRodney W. Grimesprovided, standard input is logged.
1039b50d902SRodney W. Grimes.El
10483edb87bSPhilippe Charnier.Sh DIAGNOSTICS
105d628d776SRuslan Ermilov.Ex -std
1069b50d902SRodney W. Grimes.Sh EXAMPLES
1079b50d902SRodney W. Grimes.Bd -literal -offset indent -compact
1089b50d902SRodney W. Grimeslogger System rebooted
1099b50d902SRodney W. Grimes
1109b50d902SRodney W. Grimeslogger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
1119b50d902SRodney W. Grimes.Ed
1129b50d902SRodney W. Grimes.Sh SEE ALSO
1139b50d902SRodney W. Grimes.Xr syslog 3 ,
1149b50d902SRodney W. Grimes.Xr syslogd 8
1159b50d902SRodney W. Grimes.Sh STANDARDS
1169b50d902SRodney W. GrimesThe
117df071556SPhilippe Charnier.Nm
1189b50d902SRodney W. Grimescommand is expected to be
1199b50d902SRodney W. Grimes.St -p1003.2
1209b50d902SRodney W. Grimescompatible.
121