Add prospective manual page for spawn

1 files changed, 97 insertions, 0 deletions

diff --git a/spawn.8 b/spawn.8
new file mode 100644
index 0000000..f5ecc6c
--- /dev/null
+++ b/spawn.8
@@ -0,0 +1,97 @@
+.Dd August 13, 2020
+.Dt SPAWN 8
+.Os
+.
+.Sh NAME
+.Nm spawn
+.Nd spawnd control
+.
+.Sh SYNOPSIS
+.Nm
+.Op Fl c Ar control
+.Cm start|stop|restart|status Ns | Ns Ar signal
+.Ar service ...
+.
+.Sh DESCRIPTION
+The
+.Nm
+utility controls
+the services managed by the
+.Xr spawnd 8
+daemon.
+It does so by writing
+the remainder of its command line
+to a named pipe.
+.
+.Pp
+Communication with
+.Xr spawnd 8
+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.
+.
+.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 first be stopped,
+then stopped services will be started.
+.
+.It Cm status
+Log the current status of any matching services.
+.
+.It Ar signal
+Send the named signal
+to the processes of any matching started services.
+.
+.It Ar service ...
+The list of services to operate on.
+Service names can include
+the shell-style pattern operators
+.Sy *?[] .
+Be sure to quote service name patterns
+so they are not interpreted by the shell.
+.El
+.
+.Sh ENVIRONMENT
+.Bl -tag -width Ds
+.It Ev SPAWND_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/spawnd.pipe
+The default path of the named pipe.
+.El
+.
+.Sh EXAMPLES
+.Bd -literal
+spawn start pounce/freenode
+spawn status '*'
+spawn USR1 'pounce/*'
+.Ed
+.
+.Sh SEE ALSO
+.Xr spawnd 8
+.
+.Sh AUTHORS
+.An June Bug Aq Mt june@causal.agency