1 | .TH initlog 8 "Sun Jan 24 1999" |
---|
2 | .SH NAME |
---|
3 | initlog \- log messages and events to the system logger |
---|
4 | .SH SYNOPSIS |
---|
5 | .B initlog |
---|
6 | [\-cefnpqrs] [\-\-cmd=ARG] [\-\-event=ARG] [\-\-facility=ARG] |
---|
7 | [\-\-name=ARG] [\-\-priority=ARG] [\-\-run=ARG] [\-\-string=ARG] |
---|
8 | .SH DESCRIPTION |
---|
9 | \fBinitlog\fR logs messages and events to the system logger. |
---|
10 | It is mainly designed for use in init scripts. initlog |
---|
11 | reads a configuration file |
---|
12 | .I /etc/initlog.conf |
---|
13 | by default, to determine its settings. Any line preceded with a |
---|
14 | .I # |
---|
15 | is a comment, and the following configuration directives |
---|
16 | are recognized: |
---|
17 | .TP |
---|
18 | .I facility <logging facility> |
---|
19 | Sets the default logging facility |
---|
20 | .TP |
---|
21 | .I priority <logging priority> |
---|
22 | Sets the default logging priority |
---|
23 | .TP |
---|
24 | .I ignore <regexp> |
---|
25 | Messages that match the regular expression will not be logged. |
---|
26 | .TP |
---|
27 | initlog behavior can also be configured by command-line options. |
---|
28 | |
---|
29 | \fBNote that initlog is deprecated and will be removed in a future |
---|
30 | release.\fR |
---|
31 | |
---|
32 | .SS OPTIONS |
---|
33 | .TP |
---|
34 | .I "\-c, \-\-cmd=[program]" |
---|
35 | Execute the specified program, logging anything output to |
---|
36 | stdout or stderr. |
---|
37 | .TP |
---|
38 | .I "\-e, \-\-event=[number]" |
---|
39 | Logs that the specified event happened. Used in conjuction |
---|
40 | with \fB\-\-name\fR. Currently specified events are: |
---|
41 | .PD 0 |
---|
42 | .RS 8n |
---|
43 | .TP 3n |
---|
44 | .B 1 |
---|
45 | the action completed successfully |
---|
46 | .TP |
---|
47 | .B 2 |
---|
48 | the action failed |
---|
49 | .TP |
---|
50 | .B 3 |
---|
51 | the action was cancelled at user request |
---|
52 | .TP |
---|
53 | .B 4 |
---|
54 | the action failed due to the failure of a dependent action |
---|
55 | .RE |
---|
56 | .PD |
---|
57 | .TP |
---|
58 | .I "\-f, \-\-facility=[facility]" |
---|
59 | Log at the specified syslog facility. The default |
---|
60 | is \fBdaemon\fR (see syslog(3)). |
---|
61 | .TP |
---|
62 | .I "\-n, \-\-name=[string]" |
---|
63 | Log the event under the specified string, such as |
---|
64 | "inetd". |
---|
65 | .TP |
---|
66 | .I "\-p, \-\-priority=[priority]" |
---|
67 | Log at the specified syslog priority. The default |
---|
68 | is \fBnotice\fR (see syslog(3)). |
---|
69 | .TP |
---|
70 | .I "\-q" |
---|
71 | Do not print the program's output, unless it exits |
---|
72 | with a non-zero exit code. |
---|
73 | .TP |
---|
74 | .I "\-r, \-\-run=[program]" |
---|
75 | Execute the specified program, with an open file |
---|
76 | descriptor so that the program can pass back |
---|
77 | commands to initlog. |
---|
78 | .TP |
---|
79 | .I "\-s, \-\-string=[string]" |
---|
80 | Log the specified string to the logger. |
---|
81 | .TP |
---|
82 | .I "\-\-conf=[file]" |
---|
83 | Specifies an alternate configuration file. |
---|
84 | .SH FILES |
---|
85 | .I /etc/initlog.conf |
---|
86 | .SH "SEE ALSO" |
---|
87 | syslog(3), logger(1) |
---|