From 680f6e14bfdebb226fa8420903384f70f5b98459 Mon Sep 17 00:00:00 2001 From: Sergey Poznyakoff Date: Fri, 13 Sep 2019 09:34:47 +0300 Subject: Minor fixes in the manpage --- src/genrc.8 | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) (limited to 'src/genrc.8') diff --git a/src/genrc.8 b/src/genrc.8 index ed077bf..0fdfa54 100644 --- a/src/genrc.8 +++ b/src/genrc.8 @@ -13,7 +13,7 @@ .\" .\" You should have received a copy of the GNU General Public License .\" along with genrc. If not, see . -.TH GENRC 8 "July 11, 2019" "GENRC" "Genrc User Manual" +.TH GENRC 8 "September 13, 2019" "GENRC" "Genrc User Manual" .SH NAME genrc \- generic system initialization script helper .SH SYNOPSIS @@ -86,15 +86,15 @@ will be used as the command to run. .PP The program operation modes are: .SS start -If given \fBstart\fR argument, \fBgenrc\fR runs the supplier +If given this argument, \fBgenrc\fR runs the supplied command. Before, it checks if the program is not already running and refuses to start its second copy if so. .PP It is supposed that the program to be run will detach from the -controlling terminal and continue running in the background (i.e. it +controlling terminal and will continue running in the background (i.e. it is a \fIdaemon\fR, in UNIX sense). If it is not the case, use the \fB\-\-sentinel\fR option. With this option, \fBgenrc\fR will start -the command and will become daemon itself, controlling the execution +the command and become a daemon itself, controlling the execution of the program. It will exit when the command terminates. So long as the command runs, \fBgenrc\fR will pipe its standard output and error to syslog facility \fBdaemon\fR. The standard output will be logged @@ -113,8 +113,8 @@ controlled by the \fB\-\-restart\-on\-exit\fR and \fB\-\-restart\-on\-signal\fR options. Use this feature to ensure the service provided by the program won't get terminated because of hitting a bug or encountering an unforeseen external condition. For -example, the following two options will ensure that the program will -be terminated only if it exits with status 0 or it is terminated by +example, the following two options make sure that the program will +be terminated only if it exits with status 0 or is delivered the SIGTERM or SIGQUIT signal: .EX --restart-on-exit='!0' --restart-on-signal='!TERM,QUIT' @@ -134,27 +134,27 @@ the program restarted again. In \fBstatus\fR mode \fBgenrc\fR verifies if the \fICOMMAND\fR is already running and outputs its status on the standard output. To this effect, it uses an abstraction called \fIPID source\fR, which allows -it to determine the PID of the program by its name of command line. +it to determine the PID of the program. .PP The default PID source is the Linux \fB/proc\fR filesystem (or, if it is not available, the output of \fBps -ef\fR), which is scanned for -the name of the program (given by \fB\-\-program\fR or +the name of the program (as given by \fB\-\-program\fR or \fB\-\-command\fR options). .PP The source to use can be supplied with the \fB\-\-pid\-from\fR option -(or the \fB\-\-pidfile option, which is equivalent to +(or the \fB\-\-pidfile\R option, which is equivalent to \fB\-\-pid\-from=FILE:\fR). See the section \fBPID SOURCES\fR for a detailed discussion of available sources. .SS stop In the \fBstop\fR mode \fBgenrc\fR stops the command by sending it -\fBSIGTERM\fR (or another signal as supplied with the +\fBSIGTERM\fR (or another signal, as supplied with the \fB\-\-signal\-stop\fR option). If the PID source returns multiple PIDs, by default only parent PID is selected. However, \fBgenrc\fR can be instructed to signal all PIDs instead (see the \fBa\fR flag in the description of \fBPROC\fR or \fBPS\fR PID source). .PP After sending the signal, the program will wait for all processes to -terminate. It will report error if they don't terminate within 5 +terminate. It will report an error if they don't terminate within 5 seconds. This timeout can be changed using the \fB\-\-timeout\fR option. .SS restart @@ -163,7 +163,7 @@ Restarts the program. It is equivalent to running immediately followed by .BR "genrc start" . .SS reload -Attempt to reload (or reconfigure) the program by sending it the +Attempts to reload (or reconfigure) the program by sending it the \fBSIGHUP\fR signal (or another signal, as given with the \fB\-\-signal\-reload\fR option). The \fB\-\-no\-reload\fR or \fB\-\-signal\-reload=0\fR option disables this behavior, making @@ -208,7 +208,7 @@ Run program with this \fIGROUP\fR privileges. If the argument is a list of groups, the first group becomes the principal, and the rest of them supplementary groups. Each \fIGROUP\fR is either a group name or a numeric group number prefixed with a plus sign. Whatever -notation is used, it must exist in the system group database. +notation is used, the groups must exist in the system group database. See also the \fB\-\-user\fR option. .TP @@ -322,14 +322,14 @@ Configuration specified as fully-qualified keyword-value pairs .RE .TP \fBGREP:\fIFILE\fB:s/\fIRX\fB/\fIREPL\fB/[\fIFLAGS\fR][\fB;\fR...] -Grep for the first line in \fIFILE\fR that matches \fIRX\fR. If found, process -replace the matched portion according to \fIREPL\fR and \fIFLAGS\fR. Use +Grep for the first line in \fIFILE\fR that matches \fIRX\fR. If found, +modify the matched portion according to \fIREPL\fR and \fIFLAGS\fR. Use the resulting string as PID. More sed expressions can be supplied, separated with semicolons. .TP \fBPROC\fR[\fB:\fR[\fIEXE\fR][\fB:\fIFLAGS\fR]] Look for matching program in \fB/proc/\fIPID\fB/*\fR. If \fIEXE\fR is -not supplied or empty, program name from \fB\-\-program\fR will be +not supplied or empty, the program name from \fB\-\-program\fR will be used. \fIFLAGS\fR are: .RS .TP @@ -358,7 +358,7 @@ match real executable name (instead of argv0) signal all matching PIDs .RE .TP -\fBPS:\fR[\fB:\fR[\fIEXE\fR][:\fIFLAGS\fR]] +\fBPS\fR[\fB:\fR[\fIEXE\fR][:\fIFLAGS\fR]] Look for matching program in the output of \fBps \-ef\fR. \fIEXE\fR and \fIFLAGS\fR are as described above. .SH ENVIRONMENT @@ -382,7 +382,7 @@ Sergey Poznyakoff .SH "BUG REPORTS" Report bugs to . .SH COPYRIGHT -Copyright \(co 2018 Sergey Poznyakoff +Copyright \(co 2018, 2019 Sergey Poznyakoff .br .na License GPLv3+: GNU GPL version 3 or later -- cgit v1.2.1