1 .TH initlog 8 "Sun Jan 24 1999"
3 initlog \- log messages and events to the system logger
6 [\-cefnpqrs] [\-\-cmd=ARG] [\-\-event=ARG] [\-\-facility=ARG]
7 [\-\-name=ARG] [\-\-priority=ARG] [\-\-run=ARG] [\-\-string=ARG]
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
13 by default, to determine its settings. Any line preceded with a
15 is a comment, and the following configuration directives
18 .I facility <logging facility>
19 Sets the default logging facility
21 .I priority <logging priority>
22 Sets the default logging priority
25 Messages that match the regular expression will not be logged.
27 initlog behavior can also be configured by command-line options.
31 .I "\-c, \-\-cmd=[program]"
32 Execute the specified program, logging anything output to
35 .I "\-e, \-\-event=[number]"
36 Logs that the specified event happened. Used in conjuction
37 with \fB\-\-name\fR. Currently specified events are:
42 the action completed successfully
48 the action was cancelled at user request
51 the action failed due to the failure of a dependent action
55 .I "\-f, \-\-facility=[facility]"
56 Log at the specified syslog facility. The default
57 is \fBdaemon\fR (see syslog(3)).
59 .I "\-n, \-\-name=[string]"
60 Log the event under the specified string, such as
63 .I "\-p, \-\-priority=[priority]"
64 Log at the specified syslog priority. The default
65 is \fBnotice\fR (see syslog(3)).
68 Do not print the program's output, unless it exits
69 with a non-zero exit code.
71 .I "\-r, \-\-run=[program]"
72 Execute the specified program, with an open file
73 descriptor so that the program can pass back
76 .I "\-s, \-\-string=[string]"
77 Log the specified string to the logger.
80 Specifies an alternate configuration file.