summaryrefslogtreecommitdiffhomepage
path: root/catsit.8
blob: 10cfbc780a823c9127f46b08b9a02397d5d67797 (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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
.Dd September 28, 2021
.Dt CATSIT 8
.Os
.
.Sh NAME
.Nm catsit
.Nd catsitd control
.
.Sh SYNOPSIS
.Nm
.Op Fl q
.Op Fl c Ar control
.Cm start|stop|restart|status|drop Ns | Ns Ar signal
.Ar service ...
.
.Sh DESCRIPTION
The
.Nm
utility controls
the services managed by the
.Xr catsitd 8
daemon.
It does so by writing
the remainder of its command line
to a named pipe.
.
.Pp
Communication with
.Xr catsitd 8
is unidirectional.
The daemon logs any feedback
with syslog.
The
.Nm
utility waits
a tenth of a second
after sending the command
then shows recent messages from
.Xr catsitd 8
in
.Pa /var/log/messages .
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl c Ar control
Set the path of the named pipe.
.
.It Fl q
Do not show
.Pa /var/log/messages .
.
.It Cm start
Start any matching services
which are not already started.
Services scheduled for automatic restart
are started immediately
but their restart intervals are not reset.
.
.It Cm stop
Stop any matching services
which are not already stopped.
Processes are stopped using the
.Dv TERM
signal.
.
.It Cm restart
Restart any matching services.
Started services will be stopped
and started again.
Stopped services will be started.
Services scheduled for automatic restart
will be started immediately
and their restart intervals will be reset.
.
.It Cm status
Log the current status of any matching services.
.
.It Cm drop
Drop any matching stopped services
from the services list.
.
.It Ar signal
Send the named signal
to the processes of any matching started services.
Signal names are case-insensitive.
.
.It Ar service ...
The list of services to operate on,
using shell-style pattern matching as in
.Xr glob 7 .
Patterns must be quoted
to be interpreted by
.Xr catsitd 8
rather than the shell.
Each service name pattern
is operated on in order,
but services matched by each pattern
are in unspecified order.
.El
.
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev CATSITD_PIPE
The path of the named pipe.
The
.Fl c
flag overrides this variable.
.El
.
.Sh FILES
.Bl -tag -width Ds
.It Pa /var/run/catsitd.pipe
The default path of the named pipe.
.El
.
.Sh EXAMPLES
.Bd -literal
catsit restart pounce/tilde
catsit INFO 'pounce/*'
.Ed
.
.Sh SEE ALSO
.Xr catsitd 8
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency