72 lines
1.5 KiB
Groff
72 lines
1.5 KiB
Groff
.Dd August 13, 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.
|
|
.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
|