catsit/catsit.8

115 lines
2.0 KiB
Groff
Raw Normal View History

2020-08-17 05:01:25 +02:00
.Dd August 16, 2020
2020-08-15 22:40:15 +02:00
.Dt CATSIT 8
2020-08-14 02:35:14 +02:00
.Os
.
.Sh NAME
2020-08-15 22:40:15 +02:00
.Nm catsit
.Nd catsitd control
2020-08-14 02:35:14 +02:00
.
.Sh SYNOPSIS
.Nm
.Op Fl c Ar control
2020-08-17 05:01:25 +02:00
.Cm start|stop|restart|status|drop Ns | Ns Ar signal
2020-08-14 02:35:14 +02:00
.Ar service ...
.
.Sh DESCRIPTION
The
.Nm
utility controls
the services managed by the
2020-08-15 22:40:15 +02:00
.Xr catsitd 8
2020-08-14 02:35:14 +02:00
daemon.
It does so by writing
the remainder of its command line
to a named pipe.
.
.Pp
Communication with
2020-08-15 22:40:15 +02:00
.Xr catsitd 8
2020-08-14 02:35:14 +02:00
is unidirectional.
The daemon logs any feedback
with syslog.
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl c Ar control
Set the path of the named pipe.
.
.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.
2020-08-14 02:35:14 +02:00
.
.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.
2020-08-14 02:35:14 +02:00
.
.It Cm status
Log the current status of any matching services.
.
2020-08-17 05:01:25 +02:00
.It Cm drop
Drop any matching stopped services
from the services list.
.
2020-08-14 02:35:14 +02:00
.It Ar signal
Send the named signal
to the processes of any matching started services.
Signal names are case-insensitive.
2020-08-14 02:35:14 +02:00
.
.It Ar service ...
The list of services to operate on.
Service names can include
.Sy *?[]
shell-style pattern operators.
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.
2020-08-14 02:35:14 +02:00
.El
.
.Sh ENVIRONMENT
.Bl -tag -width Ds
2020-08-15 22:40:15 +02:00
.It Ev CATSITD_PIPE
2020-08-14 02:35:14 +02:00
The path of the named pipe.
The
.Fl c
flag overrides this variable.
.El
.
.Sh FILES
.Bl -tag -width Ds
2020-08-15 22:40:15 +02:00
.It Pa /var/run/catsitd.pipe
2020-08-14 02:35:14 +02:00
The default path of the named pipe.
.El
.
.Sh EXAMPLES
.Bd -literal
catsit restart pounce/freenode
catsit INFO 'pounce/*'
2020-08-14 02:35:14 +02:00
.Ed
.
.Sh SEE ALSO
2020-08-15 22:40:15 +02:00
.Xr catsitd 8
2020-08-14 02:35:14 +02:00
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency