about summary refs log tree commit diff
path: root/catsit.conf.5
blob: 36fc4631885dfe563527c1052c313c27f8109157 (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
.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
>2021-02-07Use scrot for up -s if no screencaptureJune McEnroe 2021-02-07Enable mouse acceleration in XJune McEnroe 2021-02-07Set colours for Xt and cwmJune McEnroe 2021-02-07Set urgency on bell in xtermJune McEnroe 2021-02-07Add bindings for brightness controlJune McEnroe 2021-02-07Set X key repeat rateJune McEnroe 2021-02-07Bump font size to 12June McEnroe 2021-02-07Fully configure and rebind cwmJune McEnroe 2021-02-07Add BintiJune McEnroe 2021-02-07Finish configuring xtermJune McEnroe 2021-02-06Enable tapping, reverse scroll, set scaling in wsconsctlJune McEnroe 2021-02-06Set root window to black on purple snowJune McEnroe 2021-02-06Add xmodmap configurationJune McEnroe 2021-02-06Add initial OpenBSD X configurationJune McEnroe 2021-02-06Add xterm output to schemeJune McEnroe