blob: eee5ed2dc70fdfe1113fe214b1ae791530bf5e3b (
plain) (
blame)
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
|
.Dd August 16, 2020
.Dt CATSIT.CONF 5
.Os
.
.Sh NAME
.Nm catsit.conf
.Nd catsitd services list
.
.Sh DESCRIPTION
The
.Nm
file lists the services managed by the
.Xr catsitd 8
daemon.
Leading whitespace is ignored.
Each line of the file
is one of the following:
.
.Bl -tag -width Ds
.It Cm # Ar comment ...
Lines beinning with
.Ql #
and blank lines are ignored.
.
.It Cm % Ar command ...
Lines beginning with
.Ql %
add shell commands
to be executed before
each of the service commands.
These commands are executed
in the order they appear in the file,
for all services.
These lines can be used to
set shell or environment variables
to be expanded in service command lines
or used by the service processes.
.
.It Ar service Ar command ...
All other lines define services.
The service name is separated
from its command line by whitespace.
The rest of the line after the service name
is executed using the shell.
The shell variable
.Va $0
is set to the name of the service.
.
.It Ar @service Ar command ...
Service names beginning with
.Ql @
define
.Em privileged
services,
which are started with the same user and group as
.Xr catsitd 8 .
This can be used for services
which drop their own privileges
or which call
.Xr chroot 2 .
.El
.
.Sh EXAMPLES
.Bd -literal
# Basic services:
calico calico -H irc.example.org /var/run/calico
pounce/freenode pounce /usr/local/etc/pounce/freenode.conf
pounce/tilde pounce /usr/local/etc/pounce/tilde.conf
# Setting environment variables:
% export PATH=$PATH:/usr/local/bin
# Using variables to expand service command lines:
% pounce=/usr/local/bin/pounce
% conf=/usr/local/etc/pounce
pounce/freenode $pounce $conf/freenode.conf
pounce/tilde $pounce $conf/tilde.conf
.El
.
.Sh SEE ALSO
.Xr catsitd 8
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency
|