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