Must distinguish between "ambiguous" and "unknown" commands.
[unix-history] / usr / src / usr.bin / logger / logger.1
CommitLineData
bede97d4
EA
1.\" Copyright (c) 1983 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
5.\" @(#)logger.1 6.1 (Berkeley) %G%
6.\"
7.TH LOGGER 1 ""
8.UC 6
9.SH NAME
10logger \- make entries in the system log
11.SH SYNOPSIS
12.B logger
13[
14.B \-t
15tag
16] [
17.B \-p
18pri
19] [
20.B \-i
21] [
22.B \-f
23file
24] [
25message ...
26]
27.SH ARGUMENTS
28.TP 12n
29.BI \-t \ tag
30Mark every line in the log with the specified
31.IR tag .
32.TP
33.BI \-p \ pri
34Enter the message with the specified priority.
35The priority may be specified numerically
36or as a ``facility.level''
37pair.
38For example, ``\-p local3.info''
39logs the message(s) as
40.IR info rmational
41level in the
42.I local3
43facility.
44The default is ``user.notice.''
45.TP
46.B \-i
47Log the process id of the logger process
48with each line.
49.TP
50.BI \-f \ file
51Log the specified file.
52.TP
53message
54The message to log;
55if not specified,
56the
57.B \-f
58file or standard input is logged.
59.SH DESCRIPTION
60.I Logger
61provides a program interface to the
62.IR syslog (3)
63system log module.
64.PP
65A message can be given on the command line,
66which is logged immediately,
67or a file is read and each line is logged.
68.SH EXAMPLES
69logger System rebooted
70.PP
71logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
72.SH SEE ALSO
73syslog(3),
74syslogd(8)