This command is a mix of <ahref="https://skarnet.org/software/s6/s6-envdir.html"><tt>s6-envdir</tt></a> and <ahref="https://skarnet.org/software/execline/importas.html"><tt>importas</tt></a><em>program</em>.
It reads file containing variable assignments on the given directory, adds the variables to the environment, then executes a program.
It reads files containing variable assignments on the given directory, adds the variables to the environment, then executes a program.
</p>
...
...
@@ -49,10 +49,35 @@
<p><em>file</em> is a text file containing lines of the form <tt>key = value</tt>.Whitespace is permitted before and after <em>key</em>, and before or after <em>value</em>,
Quoting is also possible.
</p>
<p>Empty lines, or lines containing only whitespace, are ignored. Lines beginning with <tt>#</tt> (possibly after some whitespace) are ignored (and typically used for comments). Comments are not possible at the end of lines:
<p>Empty lines, or lines containing only whitespace, are ignored. Lines beginning with <tt>#</tt> (possibly after some whitespace) are ignored (and typically used for comments). Comments are <strong>not</strong> possible at the end of lines:
<tt>key = value # comment</tt> is not a valid comment.
</p>
<p>Empty <em>value</em> is <strong>not</strong> permitted.</p>
<p>If <tt>key</tt>begin by a <tt>'!'</tt> character: <tt>!key=value</tt> the <tt>key</tt> will be removed from the environment after the substitution.</p>
<p>If <tt>key</tt> begin by a <tt>'!'</tt> character: <tt>!key=value</tt> the <tt>key</tt> will be removed from the environment after the substitution.</p>
<h2> Example of use </h2>
<pre>
#!/usr/bin/execlineb -P
fdmove -c 2 1
66-envfile -f ntpd /etc/66/conf/
foreground { mkdir -p -m 0755 ${RUNDIR} }
execl-cmdline -s { ntpd ${CMD_ARGS} }
</pre>
<tt>/etc/66/conf/ntpd</tt> file contain :
<pre>
!RUNDIR=/run/openntpd
!CMD_ARGS=-d -s
</pre>
<p>66-envfile reads <tt>/etc/66/conf/ntpd</tt> file, parses the file, import the variable <tt>RUNDIR</tt> and <tt>CMD_ARGS</tt>, replaces the <tt>${RUNDIR}</tt> and <tt>${CMD_ARGS}</tt> by the corresponding values, unexport the variable then execs the ntpd commandline.</p>
<p>The strict equivalent with s6-envdir and importas command will be:</p>
<pre>
#!/usr/bin/execlineb -P
fdmove -c 2 1
s6-envdir /etc/66/conf
importas -u RUNDIR RUNDIR
importas -u CMD_ARGS CMD_ARGS
foreground { mkdir -p -m 0755 ${RUNDIR} }
execl-cmdline -s { ntpd ${CMD_ARGS} }
</pre>
<p>where <tt>/etc/66/conf</tt> directory contains two named files <tt>RUNDIR</tt> and <tt>CMD_ARGS</tt> written with <tt>/run/openntpd</tt> and <tt>-d -s</tt> respectively.</p>
