From 90b12bd71bb9fc79a4640b9112c13ef529d0196a Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Fri, 5 Dec 2014 22:26:11 +0000 Subject: Initial commit --- doc/s6-envdir.html | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 doc/s6-envdir.html (limited to 'doc/s6-envdir.html') diff --git a/doc/s6-envdir.html b/doc/s6-envdir.html new file mode 100644 index 0000000..5ac92e2 --- /dev/null +++ b/doc/s6-envdir.html @@ -0,0 +1,66 @@ + + + + + s6: the s6-envdir program + + + + + + +

+s6
+Software
+skarnet.org +

+ +

The s6-envdir program

+ +

+s6-envdir changes its environment, then executes into another program. +

+ +

Interface

+ +

+     s6-envdir [ -I | -i ] [ -n ] [ -f ] [ -c nullis ] dir prog...
+

+ +

s6-envdir reads files in dir. For every file f in dir, +that does not begin with a dot and does not contain the '=' character:
If f is empty, remove a variable named f from the environment, if any.
Else add a variable named f to the environment (or replace f if it +already exists) with the first line of the contents of file f as value. +Spaces and tabs at the end of this line are removed; +null characters in this line are changed to newlines in the environment variable.

+ +

Options

+ +

-i : strict. If dir does not exist, exit 111 with an +error message. This is the default.
-I : loose. If dir does not exit, exec into +prog without modifying the environment first.
-f : verbatim mode. All the file is given as the value of the +environment variable, including newlines (except the last one if the -n +option is not given). Null characters are still translated.
-n : do not chomp. If the -f option is given and the +file ends with a newline, keep that last newline in the value. If the -f +option is not given, keep the trailing blanks at the end of the first line (but +not the ending newline).
-c nullis : replace null characters with the +first character of nullis instead of a newline.

+ +

Notes

+ +

+ s6-envdir without options behaves exactly like +envdir. +

+ + + -- cgit v1.2.3