Match example code with example comment; multiple selectors should be

separated by semicolons (in BUGS section); from jmc@openbsd.
While here, use more macros.
This commit is contained in:
wiz 2003-07-02 08:33:22 +00:00
parent 19008f6e3a
commit 422ac6bdd7
1 changed files with 35 additions and 12 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: syslog.conf.5,v 1.9 2002/02/02 01:58:52 wiz Exp $
.\" $NetBSD: syslog.conf.5,v 1.10 2003/07/02 08:33:22 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -66,7 +66,9 @@ The
function
are encoded as a
.Em facility ,
a period (``.''), and a
a period
.Pq Sq \&. ,
and a
.Em level ,
with no intervening white-space.
Both the
@ -122,7 +124,9 @@ Multiple
.Em selectors
may be specified for a single
.Em action
by separating them with semicolon (``;'') characters.
by separating them with semicolon
.Pq Sq \&;
characters.
It is important to note, however, that each
.Em selector
can modify the ones preceding it.
@ -131,16 +135,23 @@ Multiple
.Em facilities
may be specified for a single
.Em level
by separating them with comma (``,'') characters.
by separating them with comma
.Pq Sq \&,
characters.
.Pp
An asterisk (``*'') can be used to specify all
An asterisk
.Pq Sq \&*
can be used to specify all
.Em facilities
or all
.Em levels .
.Pp
The special
.Em facility
``mark'' receives a message at priority ``info'' every 20 minutes
.Dq mark
receives a message at priority
.Dq info
every 20 minutes
(see
.Xr syslogd 8 ) .
This is not enabled by a
@ -149,7 +160,8 @@ field containing an asterisk.
.Pp
The special
.Em level
``none'' disables a particular
.Dq none
disables a particular
.Em facility .
.Pp
The
@ -163,7 +175,9 @@ There are four forms:
A pathname (beginning with a leading slash).
Selected messages are appended to the file.
.It
A hostname (preceded by an at (``@'') sign).
A hostname (preceded by an at
.Pq Sq @
sign).
Selected messages are forwarded to the
.Xr syslogd 8
program on the named host.
@ -176,7 +190,8 @@ An asterisk.
Selected messages are written to all logged-in users.
.El
.Pp
Blank lines and lines whose first non-blank character is a hash (``#'')
Blank lines and lines whose first non-blank character is a hash
.Pq Sq #
character are ignored.
.Sh FILES
.Bl -tag -width /etc/syslog.conf -compact
@ -214,7 +229,7 @@ mail.* /var/log/maillog
# Save mail and news errors of level err and higher in a
# special file.
uucp,news.crit /var/log/spoolerr
mail,news.err /var/log/spoolerr
.Ed
.Sh SEE ALSO
.Xr syslog 3 ,
@ -228,5 +243,13 @@ along with
.Xr syslogd 8 .
.Sh BUGS
The effects of multiple selectors are sometimes not intuitive.
For example ``mail.crit,*.err'' will select ``mail'' facility messages at
the level of ``err'' or higher, not at the level of ``crit'' or higher.
For example
.Dq mail.crit;*.err
will select
.Dq mail
facility messages at
the level of
.Dq err
or higher, not at the level of
.Dq crit
or higher.