diff options
| author | Laurent Bercot <ska-skaware@skarnet.org> | 2015-03-13 21:53:58 +0000 |
|---|---|---|
| committer | Laurent Bercot <ska-skaware@skarnet.org> | 2015-03-13 21:53:58 +0000 |
| commit | e1b328e6da656b241e706600a50a699cddc1703c (patch) | |
| tree | f23d1a269dbcf2f2ddc60563b6a990031defaab0 | |
| parent | 5894692c6a462c8d3ca79bc09d21d6ea3be0e652 (diff) | |
| download | s6-e1b328e6da656b241e706600a50a699cddc1703c.tar.xz | |
doc for new s6-envuidgid options
| -rw-r--r-- | doc/s6-envuidgid.html | 30 |
1 files changed, 16 insertions, 14 deletions
diff --git a/doc/s6-envuidgid.html b/doc/s6-envuidgid.html index 680e841..888a2aa 100644 --- a/doc/s6-envuidgid.html +++ b/doc/s6-envuidgid.html @@ -25,12 +25,11 @@ then executes into another program. <h2> Interface </h2> <pre> - s6-envuidgid <em>account</em> <em>prog...</em> + s6-envuidgid [ -i | -D <em>uid</em>:<em>gid</em> ] <em>account</em> <em>prog...</em> </pre> <ul> <li> s6-envuidgid looks <em>account</em> up by name in the account database. </li> - <li> If <em>account</em> is unknown, it exits 1. </li> <li> It sets the UID environment variable to <em>account</em>'s uid, and the GID environment variable to <em>account</em>'s gid. </li> <li> It also sets the GIDLIST environment variable to a comma-separated list of @@ -40,25 +39,28 @@ primary group, GIDLIST is still set, but empty.) </li> <li> Then it executes into <em>prog...</em>. </li> </ul> -<h2> Notes </h2> - -<p> - s6-envuidgid behaves like -<a href="http://cr.yp.to/daemontools/envuidgid.html">envuidgid</a>, except that: -</p> +<h2> Options </h2> <ul> - <li> it also handles supplementary groups </li> - <li> It exits 1 if <em>account</em> does not exist. </li> + <li> <tt>-i</tt> : insist. If <em>account</em> is unknown, exit 1 with +an error message. This is the default. </li> + <li> <tt>-D <em>uid</em>:<em>gid</em></tt> : if <em>account</em> +is unknown, use <em>uid</em>, <em>gid</em>, and the empty list as the values +for UID, GID and GIDLIST. </li> </ul> -<p> - s6-envuidgid is useful when running a program that must start as root but can +<h2> Notes </h2> + +<ul> + <li> s6-envuidgid without options behaves like +<a href="http://cr.yp.to/daemontools/envuidgid.html">envuidgid</a>, except that +the exit code is 1 if <em>account</em> doesn't exist. </li> + <li> s6-envuidgid is useful when running a program that must start as root but can drop its privileges later. Such a program can read its new uid/gid/groups info from the UID, GID and GIDLIST environment variables. Superservers such as <a href="http://skarnet.org/software/s6-networking/s6-tcpserver4.html">s6-tcpserver4</a> -make use of this. -</p> +make use of this. </li> +</ul> </body> </html> |