[1108] | 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) |
---|