diff options
Diffstat (limited to 'src/genrc.8')
-rw-r--r-- | src/genrc.8 | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/src/genrc.8 b/src/genrc.8 index f900639..00522ee 100644 --- a/src/genrc.8 +++ b/src/genrc.8 @@ -15,30 +15,35 @@ .\" along with genrc. If not, see <http://www.gnu.org/licenses/>. .TH GENRC 8 "May 17, 2018" "GENRC" "Genrc User Manual" .SH NAME genrc \- generic system initialization script helper .SH SYNOPSIS .nh +.na \fBgenrc\fR\ [\fB\-hv\fR]\ [\fB\-F\fR \fIPIDFILE\fR]\ [\fB\-P\fR \fISOURCE\fR]\ [\fB\-c\fR \fICOMMAND\fR]\ + [\fB\-g\fR \fIGROUP\fR[,\fIGROUP\fR...]]\ [\fB\-p\fR \fIPROGRAM\fR]\ [\fB\-t\fR \fISECONDS\fR]\ + [\fB\-u\fR \fIUSER\fR]\ [\fB\-\-command=\fICOMMAND\fR]\ [\fB\-\-create\-pidfile=\fIPIDFILE\fR]\ + [\fB\-\-group=\fIGROUP\fR[,\fIGROUP\fR...]]\ [\fB\-\-help\fR]\ [\fB\-\-no\-reload\fR]\ [\fB\-\-pid\-from=\fISOURCE\fR]\ [\fB\-\-pidfile=\fIPIDFILE\fR]\ [\fB\-\-program=\fIPROGRAM\fR]\ [\fB\-\-sentinel\fR]\ [\fB\-\-signal\-reload=\fISIG\fR]\ [\fB\-\-signal\-stop=\fISIG\fR]\ [\fB\-\-timeout=\fISECONDS\fR]\ + [\fB\-\-user=\fIUSER\fR]\ [\fB\-\-usage\fR]\ [\fB\-\-verbose\fR]\ {\ \fBstart\fR\ |\ \fBstop\fR\ @@ -162,12 +167,21 @@ variable is set). \fB\-F\fR, \fB\-\-pidfile=\fINAME\fR Name of the PID file (same as \fB\-\-pid\-from=FILE:\fINAME\fR) .TP \fB\-h\fR, \fB\-\-help\fR Display a short help list. .TP +\fB\-g\fR, \fB\-\-group=\fIGROUP\fR[,\fIGROUP\fR...] +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. + +See also the \fB\-\-user\fR option. +.TP \fB\-\-no\-reload\fR Makes \fBreload\fR equivalent to \fBrestart\fR. .TP \fB\-p\fR, \fB\-\-program=\fIPROGRAM\fR Name of the program to run. .TP @@ -189,12 +203,21 @@ Signal to send in order to terminate the program (default: \fB\-t\fR, \fB\-\-timeout=\fISECONDS\fR Time to wait for the program to start up or terminate. .TP \fB\-\-usage\fR Display a short usage summary. .TP +\fB\-u\fR, \fB\-\-user=\fIUSER\fR +Run with this user privileges. The argument is either a login +name or a numeric UID prefixed with the plus sign. Whatever form is +used, it must correspond to a valid user from the system user +database. + +Unless \fB\-\-group\fR option is also given, the primary and +supplementary groups of \fIUSER\fR will be used. +.TP \fB\-\-version\fR Display program version and exit. .TP \fB\-v\fR, \fB\-\-verbose\fR Print verbose messages (e.g. "Starting \fIPROGNAME\fR"). .SH PID SOURCES @@ -279,12 +302,14 @@ Influential environment variables and corresponding options: \fBGENRC_COMMAND=\fICOMMAND\fR \fB\-\-command=\fICOMMAND\fR \fBGENRC_PROGRAM=\fINAME\fR \fB\-\-program=\fINAME\fR \fBGENRC_PID_FROM=\fISOURCE\fR \fB\-\-pid\-from=\fISOURCE\fR \fBGENRC_TIMEOUT=\fISECONDS\fR \fB\-\-timeout=\fISECONDS\fR \fBGENRC_SENTINEL=1\fR \fB\-\-sentinel\fR \fBGENRC_CREATE_PIDFILE=\fINAME\fR \fB\-\-create\-pidfile=\fINAME\fR + \fBGENRC_USER=\fINAME\fR \fB\-\-user=\fINAME\fR + \fBGENRC_GROUP=\fIGROUPS\fR \fB\-\-group=\fIGROUPS\fR .fi .SH AUTHORS Sergey Poznyakoff .SH "BUG REPORTS" Report bugs to <gray@gnu.org>. .SH COPYRIGHT |