1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
.\" Copyright (c) 1983,1986 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" @(#)syslogd.8 6.5 (Berkeley) 5/26/86
.TH SYSLOGD 8 "May 26, 1986"
.UC 5
.SH NAME
syslogd \- log systems messages
.SH SYNOPSIS
.B /etc/syslogd
[
.BI \-f configfile
] [
.BI \-m markinterval
] [
.B \-d
]
.SH DESCRIPTION
.I Syslogd
reads and logs messages into a set of files
described by the configuration file
/etc/syslog.conf.
Each message is one line.
A message can contain a priority code,
marked by a number in angle braces
at the beginning of the line.
Priorities are defined in
.RI < sys/syslog.h >.
.I Syslogd
reads from the UNIX domain socket
.IR /dev/log ,
from an Internet domain socket specified in
.IR /etc/services ,
and from the special device
.I /dev/klog
(to read kernel messages).
.PP
.I Syslogd
configures when it starts up
and whenever it receives a hangup signal.
Lines in the configuration file have a
.I selector
to determine the message priorities to which the line applies
and an
.IR action .
The
.I action
field are separated from the selector by one or more tabs.
.PP
Selectors are semicolon separated lists of priority specifiers.
Each priority has a
.I facility
describing the part of the system that generated the message,
a dot,
and a
.I level
indicating the severity of the message.
Symbolic names may be used.
An asterisk selects all facilities.
All messages of the specified level or higher (greater severity)
are selected.
More than one facility may be selected using commas to separate them.
For example:
.PP
.ti +5
*.emerg;mail,daemon.crit
.PP
Selects all facilities at the
.I emerg
level and the
.I mail
and
.I daemon
facilities at the
.I crit
level.
.PP
Known facilities and levels
recognized by
.I syslogd
are those listed in
.IR syslog (3)
without the leading ``LOG_''.
The additional facility
``mark'' has a message at priority LOG_INFO sent to it every
20 minutes
(this may be changed with the
.B \-m
flag).
The ``mark'' facility is not enabled by a facility field containing an asterisk.
The level ``none'' may be used to disable a particular facility.
For example,
.PP
.ti +5
*.debug;mail.none
.PP
Sends all messages
.I except
mail messages to the selected file.
.PP
The second part of each line describes where the message is to be logged
if this line is selected.
There are four forms:
.IP \(bu 3n
A filename (beginning with a leading slash).
The file will be opened in append mode.
.IP \(bu 3n
A hostname preceeded by an at sign (``@'').
Selected messages are forwarded to the
.I syslogd
on the named host.
.IP \(bu 3n
A comma separated list of users.
Selected messages are written (using the Zephyr notification system)
to those users if they have subscribed to "syslog" class notices with
instance equal the hostname of the machine that syslogd in running on.
.IP \(bu 3n
An asterisk.
Selected messages are written (using Zephyr) to all users who have subscribed
to the "syslog" class notices with
instance equal the hostname of the machine that syslogd in running on.
(This is the Zephyr equivalent of a wall.)
.IP \(bu 3n
An "!" followed comma separated list of local users. The local users
will be notified by examining /etc/utmp to obtain their terminal and writing
to it.
.IP \(bu 3n
"!*" Will write to the ttys of all users found in /etc/utmp.
.PP
Blank lines and lines beginning with `#' are ignored.
.PP
For example, the configuration file:
.PP
.nf
.ta 4m +\w'*.alert,auth.warning'u+3
kern,mark.debug /dev/console
*.notice;mail.info /usr/spool/adm/syslog
*.crit /usr/adm/critical
kern.err @ucbarpa
*.emerg *
*.alert eric,kridle
*.alert;auth.warning ralph
.fi
.PP
logs all kernel messages
and 20 minute marks onto the system console,
all notice (or higher) level messages and all mail system messages
except debug messages
into the file /usr/spool/adm/syslog,
and all critical messages
into /usr/adm/critical;
kernel messages of error severity or higher are forwarded
to ucbarpa.
All users will be informed of any emergency messages,
the users ``eric'' and ``kridle''
will be informed of any alert messages,
and the user ``ralph''
will be informed of any alert message,
or any warning message (or higher)
from the authorization system.
.PP
The flags are:
.TP 0.5i
.B \-f
Specify an alternate configuration file.
.TP
.B \-m
Select the number of minutes between mark messages.
.TP
.B \-d
Turn on debugging.
.PP
.I Syslogd
creates the file /etc/syslog.pid, if possible,
containing a single line with its process id.
This can be used to kill or reconfigure
.I syslogd.
.PP
To bring
.I syslogd
down,
it should be sent a terminate signal (e.g. kill \`cat /etc/syslog.pid\`).
.SH FILES
.ta \w'/etc/syslog.conf 'u
.nf
/etc/syslog.conf the configuration file
/etc/syslog.pid the process id
/dev/log Name of the UNIX domain datagram log socket
/dev/klog The kernel log device
.fi
.SH SEE ALSO
logger(1),
syslog(3),
zephyr(1)
|
