From cda54df4b3c851917be16ea87f23835cc0f38b4f Mon Sep 17 00:00:00 2001 From: June McEnroe Date: Sat, 7 Oct 2023 17:59:11 -0400 Subject: Add prospective manual page --- kitd.8 | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 kitd.8 diff --git a/kitd.8 b/kitd.8 new file mode 100644 index 0000000..6bc1cfa --- /dev/null +++ b/kitd.8 @@ -0,0 +1,85 @@ +.Dd October 7, 2023 +.Dt KITD 8 +.Os +. +.Sh NAME +.Nm kitd +.Nd process supervisor +. +.Sh SYNOPSIS +.Nm +.Op Fl d +.Op Fl c Ar cooloff +.Op Fl n Ar name +.Op Fl p Ar pidfile +.Op Fl t Ar restart +.Ar command ... +. +.Sh DESCRIPTION +The +.Nm +daemon supervises +a child process, +redirecting its standard output +and standard error to +.Xr syslog 3 . +When the child process exits, +it is automatically restarted +using exponential backoff. +. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl c Ar cooloff +The interval in milliseconds +for which the child process must live +before the restart interval +is reset to its initial value. +The default interval is 15 minutes. +.It Fl d +Do not daemonize. +Log to standard error +as well as +.Xr syslog 3 . +.It Fl n Ar name +Set the name of the process +and the logging prefix. +The default is +.Ar command . +.It Fl p Ar pidfile +Write the PID of +.Nm +to +.Ar pidfile . +.It Fl t Ar restart +The initial interval in milliseconds +between automatic restarts. +This interval is doubled +each time the child process +is restarted. +The default interval is 1 second. +.El +. +.Pp +.Nm +responds to the following signals: +.Bl -tag -width Ds +.It Dv SIGHUP +The child process is sent +.Dv SIGTERM +and restarted. +.It Dv SIGTERM +The child process is sent +.Dv SIGTERM . +.Nm +exits. +.It Dv SIGINFO +The status of the child process +is logged. +.It Dv SIGUSR1 , Dv SIGUSR2 +The signal is forwarded to +the child process. +.El +. +.Sh AUTHORS +.An June McEnroe Aq Mt june@causal.agency -- cgit 1.4.1 a3d4f77b2247aa1c57b4aa518a5211&follow=1'>root/txt/music.txt (unfollow)
Commit message (Expand)Author
2020-02-17Add Four Tet — HandsJune McEnroe
2020-02-12Simplify macOS notify-sendJune McEnroe
2020-02-12Add imbox and notemap to pageJune McEnroe
2020-02-12Collapse simple linksJune McEnroe
2020-02-12Move catgirl up the pageJune McEnroe
2020-02-12Update catgirl pty grabJune McEnroe
2020-02-12Link to cgit /about pages where appropriateJune McEnroe
2020-02-11Separate LINKS from BINS for html to workJune McEnroe
2020-02-11Add margin to Bl-bullet itemsJune McEnroe
2020-02-10Match URLs inside parens or with paired parens insideJune McEnroe
2020-02-10Duplicate effective URL before passing it back to curlJune McEnroe
2020-02-09Add To Be Taught, If FortunateJune McEnroe
2020-02-04Add The Future of Another TimelineJune McEnroe
2020-01-31Reorganize the Makefile for the umpteenth timeJune McEnroe
2020-01-28Change scout sensitivity to 1.4June McEnroe
2020-01-28Import shows.txtJune McEnroe