Commit | Line | Data |
---|---|---|
2117e02e MW |
1 | .TH splogger 8 |
2 | .SH NAME | |
3 | splogger \- make entries in syslog | |
4 | .SH SYNOPSIS | |
5 | .B splogger | |
6 | [ | |
7 | .I tag | |
8 | [ | |
9 | .I fac | |
10 | ] | |
11 | ] | |
12 | .SH DESCRIPTION | |
13 | .B splogger | |
14 | reads a series of messages and feeds them to | |
15 | .BR syslog . | |
16 | At the front of each message it puts | |
17 | .I tag | |
18 | (default: | |
19 | .BR splogger ) | |
20 | and a numerical timestamp. | |
21 | ||
22 | .B splogger | |
23 | checks for | |
24 | .B alert: | |
25 | or | |
26 | .B warning: | |
27 | at the beginning of each message. | |
28 | It selects a priority of | |
29 | LOG_ALERT, LOG_WARNING, or LOG_INFO accordingly. | |
30 | ||
31 | .B splogger | |
32 | logs messages with facility | |
33 | .IR fac . | |
34 | .I fac | |
35 | (default: 2) | |
36 | must be numeric. | |
37 | ||
38 | .B splogger | |
39 | converts unprintable characters to question marks. | |
40 | ||
41 | .B splogger | |
42 | does not log blank lines. | |
43 | ||
44 | .B splogger | |
45 | folds messages after 800 characters, | |
46 | since | |
47 | .B syslog | |
48 | can't handle long messages. | |
49 | .B splogger | |
50 | uses a + after the timestamp | |
51 | to mark folded lines. | |
52 | ||
53 | Note that the | |
54 | .B syslog | |
55 | mechanism is inherently unreliable: | |
56 | it does not guarantee that messages will be logged. | |
57 | It is also very slow. | |
58 | .SH "SEE ALSO" | |
59 | syslog(3), | |
60 | logger(8) |