Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 78f0ae0359
Fetching contributors…

Cannot retrieve contributors at this time

89 lines (84 sloc) 1.993 kb
.TH syslogxlate 1
.SH NAME
syslogxlate \- Select and translate syslog messages
.SH SYNOPSIS
.B syslogxlate
[
.B \-f
] [
.B \-p
] [
.B \-x
]
.I selector ...
.SH DESCRIPTION
.B syslogxlate
reads syslog formatted messages on standard input, drops all but the
ones selected by the criteria named on the command line, optionally
translates the facility and priority number into names, and writes the
messages to standard output.
If the message does not appear to be a syslog formatted message, it is
written to standard output with no modifications.
.RS
.SS SELECTOR SYNTAX
A
.I selector
follows the format
.IR FACILITY.PRIORITY .
Any number of selectors may be listed on the command line.
Each one is processed in the order they appear; latter selectors
override prior ones.
.P
.I FACILITY
is one of kern, user, mail, daemon, auth, syslog, lpr, news, uucp, cron,
authpriv, ftp, or local0 to local7.
The facility name
.I *
matches all facilities.
.P
.I PRIORITY
is one of emerg, alert, crit, err, warning, notice, info, or debug
(listed in decreasing order of severity).
Prefixing a priority name with
.I =
means to match only that priority level; with the prefix, all priority
levels of the given severity or higher are matched.
The priority name
.I *
matches all priorities (equivalent to debug).
Prefixing the priority name with
.I !
deselects matching message types.
.SS SELECTOR EXAMPLES
Select only debug messages from all sources:
.EX
*.=debug
.EE
Select all mail messages except those with the info priority:
.EX
mail.* mail.!=info
.EE
.RE
.SH OPTIONS
.TP
.B \-f
Do not show the facility name or number
.TP
.B \-p
Do not show the priority name or number
.TP
.B \-x
Do not translate priority or facility numbers into names
.SH SEE ALSO
sysloglread(1),
sysloguread(1)
.SH CAVEATS
Most command shells interpret
.I *
and
.I !
before executing programs, so take special care to quote these
symbols.
.SH RESTRICTIONS
.B syslogxlate
always strips off the timestamp from the incoming messages.
Jump to Line
Something went wrong with that request. Please try again.