The s6-envdir program
s6-envdir changes its environment, then executes into another program.
Interface
s6-envdir [ -I | -i ] [ -n ] [ -f ] [ -L ] [ -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, as well as any trailing newline; 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 exist, 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).
- -L : do not clamp. With this option, s6-envdir will process the whole first line of each file (if the -f option hasn't been given) or read each file entirely (if the -f option has been given), even if it means adding huge variables to the environment. Without this option, s6-envdir only reads the first 4096 bytes of each file.
- -c nullis : replace null characters with the first character of nullis instead of a newline.
Notes
s6-envdir without options behaves exactly like envdir.