summaryrefslogtreecommitdiff
path: root/splogger.8
blob: 15096b40ff1c55edc70e75c51cd2d278bedce72d (plain)
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
.TH splogger 8
.SH NAME
splogger \- make entries in syslog
.SH SYNOPSIS
.B splogger
[
.I tag
[
.I fac
]
]
.SH DESCRIPTION
.B splogger
reads a series of messages and feeds them to
.BR syslog .
At the front of each message it puts
.I tag
(default:
.BR splogger )
and a numerical timestamp.

.B splogger
checks for
.B alert:
or
.B warning:
at the beginning of each message.
It selects a priority of
LOG_ALERT, LOG_WARNING, or LOG_INFO accordingly.

.B splogger
logs messages with facility
.IR fac .
.I fac
(default: 2)
must be numeric.

.B splogger
converts unprintable characters to question marks.

.B splogger
does not log blank lines.

.B splogger
folds messages after 800 characters,
since
.B syslog
can't handle long messages.
.B splogger
uses a + after the timestamp
to mark folded lines.

Note that the
.B syslog
mechanism is inherently unreliable:
it does not guarantee that messages will be logged.
It is also very slow.
.SH "SEE ALSO"
syslog(3),
logger(8)