.Dd September 28, 2021
.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.
The current line
can be extended over multiple lines
using a backslash
.Pq Ql \e .
Each line of the file
is one of the following:
.
.Bl -tag -width Ds
.It Cm # Ar comment ...
Lines beinning with
.Ql #
as well as 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.
If the command line
does not contain the characters
.Ql ;&|()
it is prepended by
.Ic exec
when passed to the shell.
.
.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
# Setting environment variables:
% export LANG=en_US.UTF-8

# Expanding command lines with variables:
% socks=/var/run/calico
calico	calico -H irc.example.org $socks
pounce	pounce -U $socks pounce.conf

# Templating command lines using service names:
pounce/tilde	pounce ${0#*/}.conf
pounce/libera	pounce ${0#*/}.conf

# Privileged services:
@scooper	kfcgi -d -U $USER -p ~/.local -- \e
		/bin/scooper /share/litterbox/litterbox.sqlite
.Ed
.
.Sh SEE ALSO
.Xr catsit-timer 1 ,
.Xr catsit-watch 1 ,
.Xr catsitd 8
.
.Sh AUTHORS
.An June McEnroe Aq Mt june@causal.agency