-rw-r--r-- | man/dudki.conf.5.in | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/man/dudki.conf.5.in b/man/dudki.conf.5.in index 7d365d3..7186eeb 100644 --- a/man/dudki.conf.5.in +++ b/man/dudki.conf.5.in | |||
@@ -1,65 +1,65 @@ | |||
1 | .TH dudki.conf 5 "July 24th, 2004" "dudki.conf(5)" "Klever Group (http://www.klever.net/)" | 1 | .TH dudki.conf 5 "November 8th, 2006" "dudki.conf(5)" "Klever Group (http://www.klever.net/)" |
2 | .hla en | 2 | .hla en |
3 | 3 | ||
4 | .SH NAME | 4 | .SH NAME |
5 | 5 | ||
6 | dudki.conf \- The configuration file for the dudki process | 6 | dudki.conf \- The configuration file for the dudki process |
7 | monitoring daemon | 7 | monitoring daemon |
8 | 8 | ||
9 | .SH SYNOPSIS | 9 | .SH SYNOPSIS |
10 | 10 | ||
11 | The dudki.conf file is a runtime configuration file for the dudki | 11 | The dudki.conf file is a runtime configuration file for the dudki |
12 | process monitoring daemon. It contains the information about the process | 12 | process monitoring daemon. It contains the information about the process |
13 | being monitored and the instruction on how to cope with the processes. | 13 | being monitored and the instruction on how to cope with the processes. |
14 | 14 | ||
15 | .SH FILE FORMAT | 15 | .SH FILE FORMAT |
16 | 16 | ||
17 | The file consist of the global configuration and per-process | 17 | The file consist of the global configuration and per-process |
18 | configuration sections. The global configuration controls general | 18 | configuration sections. The global configuration controls general |
19 | dudki behaviour and sets defaults for per-process configuration | 19 | dudki behaviour and sets defaults for per-process configuration |
20 | directives. | 20 | directives. |
21 | 21 | ||
22 | .SH GLOBAL CONFIGURATION | 22 | .SH GLOBAL CONFIGURATION |
23 | 23 | ||
24 | .TP | 24 | .TP |
25 | \fBCheckInterval\fR \fIseconds\fR | 25 | \fBCheckInterval\fR \fIseconds\fR |
26 | Specifies interval in seconds at wich dudki performs checks. | 26 | Specifies interval in seconds at wich dudki performs checks. |
27 | .TP | 27 | .TP |
28 | \fBDaemonize\fR \fIon/off\fR | 28 | \fBDaemonize\fR \fIon/off\fR |
29 | Specifies whether dudki daemon should fork itself into background. | 29 | Specifies whether dudki daemon should fork itself into background. |
30 | Normally, you don't want it to run in foreground. Unless you want to run | 30 | Normally, you don't want it to run in foreground. Unless you want to run |
31 | it from \fIinit(8)\fR process (I've nevetr tried it) via | 31 | it from \fIinit(8)\fR process (I've nevetr tried it) via |
32 | \fIinittab(5)\fR. | 32 | \fIinittab(5)\fR. |
33 | .TP | 33 | .TP |
34 | \fBPidFile\fR \fIfilename\fR | 34 | \fBPidFile\fR \fIfilename\fR |
35 | Specifies where to store dudki's process id (default is | 35 | Specifies where to store dudki's process id (default is |
36 | /var/run/dudki.pid) | 36 | /var/run/dudki.pid) |
37 | .TP | 37 | .TP |
38 | \fBMailtoHeader\fR \fIheader\fR \fIcontent\fR | 38 | \fBMailtoHeader\fR \fIheader\fR \fIcontent\fR |
39 | Sets global defaults for process section's MailtoHeader directive. See | 39 | Sets global defaults for process section's MailtoHeader directive. See |
40 | below. | 40 | below. |
41 | .TP | 41 | .TP |
42 | \fBNotify\fR \fIschema\fR:\fItarget\fR | 42 | \fBNotify\fR \fIschema\fR:\fItarget\fR |
43 | Sets global default for per process notification. See below. | 43 | Sets global default for per process notification. See below. |
44 | 44 | ||
45 | .TP | 45 | .TP |
46 | \fB<Process\fR \fIidentifier\fR\fB>\fR | 46 | \fB<Process\fR \fIidentifier\fR\fB>\fR |
47 | Starts per process configuration section. The process will be referenced | 47 | Starts per process configuration section. The process will be referenced |
48 | using the short descriptive name specified (for example in email | 48 | using the short descriptive name specified (for example in email |
49 | notifications). | 49 | notifications). |
50 | 50 | ||
51 | .SH PER-PROCESS CONFIGURATION | 51 | .SH PER-PROCESS CONFIGURATION |
52 | 52 | ||
53 | Per-process configuration sections specifies the processes to monitor. | 53 | Per-process configuration sections specifies the processes to monitor. |
54 | And parameters pertaining to the process. | 54 | And parameters pertaining to the process. |
55 | 55 | ||
56 | .TP | 56 | .TP |
57 | \fBPidFile\fR \fIfilename\fR | 57 | \fBPidFile\fR \fIfilename\fR |
58 | Specifies the file where to fetch process id of the process being | 58 | Specifies the file where to fetch process id of the process being |
59 | monitored from. The absence of file, as well as the absence of process | 59 | monitored from. The absence of file, as well as the absence of process |
60 | specified by the pid stored in the file signifies the process death and | 60 | specified by the pid stored in the file signifies the process death and |
61 | triggers restart. | 61 | triggers restart. |
62 | .TP | 62 | .TP |
63 | \fBProcessName\fR \fIprocess name\fR | 63 | \fBProcessName\fR \fIprocess name\fR |
64 | Specifies the name of the process. The alternative way to find process if it | 64 | Specifies the name of the process. The alternative way to find process if it |
65 | doesn't keep pid in the file. Similar to \fBpidof\fR(1). | 65 | doesn't keep pid in the file. Similar to \fBpidof\fR(1). |
@@ -69,90 +69,90 @@ Specifies the command to run in order to restart the process. | |||
69 | .TP | 69 | .TP |
70 | \fBUser\fR \fIuser\fR | 70 | \fBUser\fR \fIuser\fR |
71 | Specifies the unix user to change to before executing the command | 71 | Specifies the unix user to change to before executing the command |
72 | specified by \fBRestartCommand\fR. | 72 | specified by \fBRestartCommand\fR. |
73 | .TP | 73 | .TP |
74 | \fBGroup\fR \fIgroup\fR | 74 | \fBGroup\fR \fIgroup\fR |
75 | Specifies the unix group to change to before executing the command | 75 | Specifies the unix group to change to before executing the command |
76 | specified by \fBRestartCommand\fR. | 76 | specified by \fBRestartCommand\fR. |
77 | .TP | 77 | .TP |
78 | \fBChroot\fR \fIpath\fR | 78 | \fBChroot\fR \fIpath\fR |
79 | Specifies the directory to set filesystem root to before executing the | 79 | Specifies the directory to set filesystem root to before executing the |
80 | command specified by by \fBRestartCommand\fR. | 80 | command specified by by \fBRestartCommand\fR. |
81 | .TP | 81 | .TP |
82 | \fBMailtoHeader\fR \fIheader\fR \fIcontent\fR | 82 | \fBMailtoHeader\fR \fIheader\fR \fIcontent\fR |
83 | Specifies extra headers to add to mailto: notifications sent by the | 83 | Specifies extra headers to add to mailto: notifications sent by the |
84 | dudki daemon. Headers specified in per-process section override the | 84 | dudki daemon. Headers specified in per-process section override the |
85 | ones specified globally.A | 85 | ones specified globally.A |
86 | .TP | 86 | .TP |
87 | \fBNotify\fR \fIschema\fR:\fItarget\fR | 87 | \fBNotify\fR \fIschema\fR:\fItarget\fR |
88 | Specifies the contact to be notified whenever something notable happens | 88 | Specifies the contact to be notified whenever something notable happens |
89 | to the process. The only schema currently supported is 'mailto:'. | 89 | to the process. The only schema currently supported is 'mailto:'. |
90 | .TP | 90 | .TP |
91 | \fB</Process>\fR | 91 | \fB</Process>\fR |
92 | Signifies the end of process section. | 92 | Signifies the end of process section. |
93 | 93 | ||
94 | .SH EXAMPLE | 94 | .SH EXAMPLE |
95 | 95 | ||
96 | .br | 96 | .br |
97 | CheckInterval 60 | 97 | CheckInterval 60 |
98 | .br | 98 | .br |
99 | PidFile /var/run/dudki.pid | 99 | PidFile /var/run/dudki.pid |
100 | .br | 100 | .br |
101 | Daemonize on | 101 | Daemonize on |
102 | .br | 102 | .br |
103 | MailtoHeader From "Dudki <root@klever.net>" | 103 | MailtoHeader From "Dudki <root@klever.net>" |
104 | .br | 104 | .br |
105 | MailtoHeader Reply-To devnull@klever.net | 105 | MailtoHeader Reply-To devnull@klever.net |
106 | .br | 106 | .br |
107 | Notify mailto:hacker@klever.net | 107 | Notify mailto:hacker@klever.net |
108 | .br | 108 | .br |
109 | 109 | ||
110 | .br | 110 | .br |
111 | <Process apache> | 111 | <Process apache> |
112 | .br | 112 | .br |
113 | PidFile /var/run/httpd.pid | 113 | PidFile /var/run/httpd.pid |
114 | .br | 114 | .br |
115 | RestartCommand "exec /usr/sbin/apachectl start" | 115 | RestartCommand "exec /usr/sbin/apachectl start" |
116 | .br | 116 | .br |
117 | </Process> | 117 | </Process> |
118 | .br | 118 | .br |
119 | <Process named> | 119 | <Process named> |
120 | .br | 120 | .br |
121 | PidFile /var/run/named.pid | 121 | PidFile /var/run/named.pid |
122 | .br | 122 | .br |
123 | RestartCommand "exec /usr/sbin/named" | 123 | RestartCommand "exec /usr/sbin/named" |
124 | .br | 124 | .br |
125 | </Process> | 125 | </Process> |
126 | 126 | ||
127 | .SH AUTHOR | 127 | .SH AUTHOR |
128 | 128 | ||
129 | Written by Michael 'hacker' Krelin <hacker@klever.net> | 129 | Written by Michael 'hacker' Krelin <hacker@klever.net> |
130 | 130 | ||
131 | .SH COPYRIGHT | 131 | .SH COPYRIGHT |
132 | 132 | ||
133 | Copyright (c) 2004 Klever Group (http://www.klever.net/) | 133 | Copyright (c) 2004-2006 Klever Group (http://www.klever.net/) |
134 | 134 | ||
135 | Permission is hereby granted, free of charge, to any person obtaining a copy of | 135 | Permission is hereby granted, free of charge, to any person obtaining a copy of |
136 | this software and associated documentation files (the "Software"), to deal in | 136 | this software and associated documentation files (the "Software"), to deal in |
137 | the Software without restriction, including without limitation the rights to | 137 | the Software without restriction, including without limitation the rights to |
138 | use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies | 138 | use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies |
139 | of the Software, and to permit persons to whom the Software is furnished to do | 139 | of the Software, and to permit persons to whom the Software is furnished to do |
140 | so, subject to the following conditions: | 140 | so, subject to the following conditions: |
141 | 141 | ||
142 | The above copyright notice and this permission notice shall be included in all | 142 | The above copyright notice and this permission notice shall be included in all |
143 | copies or substantial portions of the Software. | 143 | copies or substantial portions of the Software. |
144 | 144 | ||
145 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | 145 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
146 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | 146 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
147 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | 147 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
148 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | 148 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
149 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | 149 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
150 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | 150 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
151 | SOFTWARE. | 151 | SOFTWARE. |
152 | 152 | ||
153 | .SH BUGS | 153 | .SH BUGS |
154 | 154 | ||
155 | You tell me. Send reports to <dudki-bugs@klever.net> | 155 | You tell me. Send reports to <dudki-bugs@klever.net> |
156 | 156 | ||
157 | .SH SEE ALSO | 157 | .SH SEE ALSO |
158 | \fBdudki\fR(8), \fBinit\fR(8), \fBinittab\fR(5) | 158 | \fBdudki\fR(8), \fBinit\fR(8), \fBinittab\fR(5) |