1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
.\" $Id: watchcatd.conf.5 1654 2006-05-29 18:18:02Z andre $
.TH WATCHCATD.CONF 5 "January 2004" WATCHCATD.CONF "System Administration"
.SH NAME
watchcatd.conf \- configuration file for
.BR watchcatd (8)
.SH DESCRIPTION
This file holds all configuartion information for the
.BR watchcat (8)
daemon. Each option must be written on a line by itself. Comments
start with a '#' and go up to the end of the line. Blank spaces and
empty lines are ignored.
.SH OPTIONS
The following options are available:
.SS Global options
This section affects
.BR watchcatd (8)
as a whole.
.TP
.BR realtime " = <" true "|" false ">"
Turns real-time mode on or off. On real-time mode,
.BR watchcatd (8)
will lock itself into memory so it is never swapped out.
.TP
.BR priority " = <" "schedule priority" ">"
Set the schedule priority for realtime mode. This option has no
effect if
.BR realtime " is set to"
.IR false .
.TP
.BR user " = <" username ">"
Defines the name of the unprivileged user
.BR watchcatd (8)
will run as.
This users's home directory will be used for chroot and all groups will
be applied.
.SS Master section
This section defines options that affect the master process of
.BR watchcatd "(8) ."
.TP
.BR master_debug_level " = <" "debug level" ">"
Sets the debug level for the master process. This can be the sum of zero
or more of the values below, resulting in a number between 0 and 63.
.P
.RS
.IR "1" " Security logs (low volume)"
.RE
.RS
.IR "2" " Sent signal logs (moderate to high volume)"
.RE
.RS
.IR "4" " Failure to send signal logs (low volume)"
.RE
.RS
.IR "8" " Failure on socket read logs (low volume)"
.RE
.RS
.IR "16" " Child death logs (low volume)"
.RE
.RS
.IR "32" " Child finishing logs (low volume)"
.RE
.TP
.BR master_pid_file " = <" "file name" ">"
The file where the server writes its process ID in, or the directory
where it will be crested.
.SS Slave section
This section defines options that affect the slave process of
.BR watchcatd "(8) ."
.TP
.BR slave_debug_level " = <" "debug level" ">"
Sets the debug level for the slave process. This can be the sum of zero
or more of the values below, resulting in a number between 0 and 2015.
.P
.RS
.IR "1" " Creation/termination of a cat process logs (high"
volume)
.RE
.RS
.IR "2" " Header parsing error logs (high volume)"
.RE
.RS
.IR "4" " Communication failure with an existing cat. Basically"
this means socket errors (high volume)
.RE
.RS
.IR "8" " Communication timeout logs (low volume)"
.RE
.RS
.IR "16" " Security logs (low volume)"
.RE
.RS
.IR "64" " Critical failure logs (low volume)"
.RE
.RS
.IR "128" " Warning logs (low to moderate volume)"
.RE
.RS
.IR "256" " Connection attempt logs (low to moderate volume)"
.RE
.RS
.IR "512" " Successful connection logs (high volume)"
.RE
.RS
.IR "1024" " Successful fetching of Process ID logs (high volume)"
.RE
.P
.RS
.RI "Note that the value " 32 " currently has no use."
.RE
.TP
.BR slave_device " = <" device ">"
Defines the absolute path for the watchcat device.
.TP
.BR slave_max_connections " = <" "max. connections" ">"
Defines the maximum number of client connections that the slave will
handle.
.TP
.BR slave_max_connections_per_pid " = <" "max. per pid" ">"
Defines the maximum number of connections per client that the slave
will handle. Use zero for unlimited.
.SH EXAMPLE
There's a complete example configuration file in /etc/watchcatd.conf.
It is included with this package.
.SH FILES
.I /etc/watchcatd.conf
.RS
The
.BR watchcatd (8)
configuration file
.fi
.SH "SEE ALSO"
.BR watchcatd "(8)
|
