gentoo-overlay/sys-process/daemontools-encore/files/daemontools-encore-1.11-add-missing-setuser-man-page.patch

Add missing setuser.8

Upstream-bug: https://github.com/bruceg/daemontools-encore/issues/60

--- /dev/null
+++ b/setuser.8
@@ -0,0 +1,61 @@
+.TH setuser 8
+.SH NAME
+setuser \- runs another program under a specified account's environment.
+.SH SYNOPSIS
+.B setuser
+.I account
+.I child
+.SH DESCRIPTION
+.I account
+is a single argument.
+.I child
+consists of one or more arguments. 
+
+.B setuser
+sets
+.BR $GID ,
+.BR $UID ,
+.BR $SHELL ,
+.BR $HOME ,
+and
+.BR $USER
+to
+.IR account 's
+gid number, uid number, login shell, home directory, and user name, respectively.
+It changes the working directory to
+.IR account 's
+home, and sets its uid and gid to
+.IR account 's
+uid and gid, with supplementary groups set up.
+It then runs
+.IR child .
+
+.B setuser
+cannot be run by anyone other than root.
+.SH EXIT CODES
+.B setuser
+exits 111 if it cannot find a UNIX account named
+.IB account ,
+if it cannot setup the environment, change directory, setgid, setuid, or run
+.IR child .
+Otherwise its exit code is the same as that of
+.IR child .
+.SH SEE ALSO
+envdir(8),
+envini(8),
+envuidgid(8),
+fghack(8),  
+multilog(8),
+pgrphack(8),
+readproctitle(8),
+setlock(8),
+setuidgid(8),
+softlimit(8),
+supervise(8),
+svc(8),
+svok(8),
+svscan(8),
+svscanboot(8),
+svstat(8),
+tai64n(8),
+tai64nlocal(8)