7d04a0f5e0
This allows running things like kfcgi which do their own privilege dropping and chrooting. Need to update the examples with something like that.
85 lines
1.7 KiB
Groff
85 lines
1.7 KiB
Groff
.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
|