summaryrefslogtreecommitdiffabout
path: root/src/genrc.8
Side-by-side diff
Diffstat (limited to 'src/genrc.8') (more/less context) (ignore whitespace changes)
-rw-r--r--src/genrc.825
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
@@ -18,15 +18,19 @@
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]\
@@ -36,6 +40,7 @@ genrc \- generic system initialization script helper
[\fB\-\-signal\-reload=\fISIG\fR]\
[\fB\-\-signal\-stop=\fISIG\fR]\
[\fB\-\-timeout=\fISECONDS\fR]\
+ [\fB\-\-user=\fIUSER\fR]\
[\fB\-\-usage\fR]\
[\fB\-\-verbose\fR]\
{\
@@ -165,6 +170,15 @@ Name of the PID file (same as \fB\-\-pid\-from=FILE:\fINAME\fR)
\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
@@ -192,6 +206,15 @@ Time to wait for the program to start up or terminate.
\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
@@ -282,6 +305,8 @@ Influential environment variables and corresponding options:
\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

Return to:

Send suggestions and report system problems to the System administrator.