From 99db04283debeb283fda1ae3dbb5d1c57218a2e9 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 14 Mar 2016 22:37:44 +0000 Subject: Document the -s option to s6-linux-init-maker --- doc/s6-linux-init-maker.html | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/doc/s6-linux-init-maker.html b/doc/s6-linux-init-maker.html index 95c0101..e2e0b2b 100644 --- a/doc/s6-linux-init-maker.html +++ b/doc/s6-linux-init-maker.html @@ -56,6 +56,7 @@ machine - else the scripts will crash. [ -m initial_umask ] \ [ -t timestamp_style ] \ [ -d dev_style ] \ + [ -s env_store ] \ [ -e initial_envvar ] ... \ dir > stage1 @@ -103,7 +104,7 @@ program launcher. filesystem on tmpfsdir.
  • stage1 copies basedir/run-image verbatim to tmpfsdir.
    • -
  • stage1 reads a global set of environment variables from the +
  • stage1 empties its environment, then reads a global set of environment variables from the basedir/env environment directory.
  • stage1 forks a child that will block until @@ -313,6 +314,20 @@ devtmpfs but not automounted by the kernel at boot time, and 2 means devtmpfs automounted by the kernel at boot time. Default is 2.

    • +

  • -s env_store : stage1 init sometimes +inherits a few environment variables from the kernel. It empties its +environment before spawning stage2 and executing into s6-svscan, in +order to prevent those "kernel" environment variables from leaking +into the whole process tree. However, sometimes those variables are +needed at a later time; in that case, giving the -s option +to s6-linux-init-maker makes stage1 init dump the "kernel" environment +variables into the env_store directory, via the +s6-dumpenv +program, before erasing them. env_store should obviously be +a writable directory, so it should be located under tmpfsdir! +If this option is not given (which is the default), the environment +inherited from the kernel isn't saved anywhere.
    • +
  • -e initial_envvar : this option can be repeated. For every initial_envvar, s6-linux-init-maker will adjust the global environment directory in dir/env. -- cgit v1.2.3