Add initial environment support. Lets users work around their broken
[util-vserver.git] / doc / configuration.xml
index 3b728b6..35d34aa 100644 (file)
@@ -37,6 +37,14 @@ the 'barrier' attribute. Else, common chroot(2) exploits are possible.
       </description>
     </boolean>
 
+    <boolean id="global-namespace-cleanup" name="namespace-cleanup">
+      <description>
+Enable namespace cleanup globally. It can be overridden for a single vserver
+by setting the <optionref ref="global-nonamespace-cleanup">nonamespace-cleanup</optionref> flag
+there.
+      </description>
+    </boolean>
+
     <link name="run.rev">
       <description>
 Path of the vserver run reverse directory. This directory contains
@@ -132,6 +140,13 @@ A symlink to the TTY device where input/output will be redirected from/to
 at startup via initscript.
           </description>
        </link>
+
+       <list id="global-environment" name="environment">
+         <description>
+The environment to set when starting guests. Contains one VAR=VAL
+pair per line.
+         </description>
+       </list>
       </collection>
       
       <collection name="vunify">
@@ -344,6 +359,19 @@ the 'barrier' attribute. Else, common chroot(2) exploits are possible.
       </description>
     </boolean>
 
+    <boolean id="global-nonamespace-cleanup" name="nonamespace-cleanup">
+      <description>
+Overrides the global <optionref ref="global-namespace-cleanup">namespace-cleanup</optionref> flag and disables
+namespace cleanup for the current vserver.
+      </description>
+    </boolean>
+
+    <boolean name="namespace-cleanup">
+      <description>
+Enable namespace cleanup for the current vserver.
+      </description>
+    </boolean>
+
     <hash name="schedule">
       <description>
 [experimental; name is subject of possible change] Contains the
@@ -601,6 +629,13 @@ will be stopped before its dependencies. Content of this file are
 vserver ids (one name per line).
           </description>
        </list>
+
+       <list name="environment">
+         <description>
+The environment to set when starting the guest. Contains one VAR=VAL
+pair per line.
+         </description>
+       </list>
       </collection>
       
       <collection name="vshelper">
@@ -749,6 +784,57 @@ environment variable must be set by one of the in-shellcontext scripts
 (the non-executable ones).
       </description>
       
+      <program name="initialize">
+       <description>
+The scriptlet which will be executed before the root filesystem is mounted and
+the configuration has been loaded. Before executing the script, the
+configuration directory will be made the working directory.
+        </description>
+       <parameterList>
+         <parameter name="vserver-dir">
+           <description>
+The configuration directory of the current vserver.
+            </description>
+         </parameter>
+         <parameter name="vserver-name">
+           <description>
+The name of the current vserver.
+            </description>
+         </parameter>
+         <parameter name="action">
+           <description>
+The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
+            </description>
+         </parameter>
+       </parameterList>
+      </program>
+      <collection name="initialize.d">
+       <description>
+Repository of initialize like scripts.  Before executing the script,
+the configuration directory will be made the working directory.
+        </description>                                                                                                                 
+       <program name="script" type="symbolic">
+         <description>See initialize.</description>
+         <parameterList>
+           <parameter name="vserver-dir">
+             <description>
+The configuration directory of the current vserver.
+              </description>
+           </parameter>
+           <parameter name="vserver-name">
+             <description>
+The name of the current vserver.
+              </description>
+           </parameter>
+           <parameter name="action">
+             <description>
+The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
+              </description>
+           </parameter>
+         </parameterList>
+       </program>
+      </collection>
+      
       <program name="prepre-start">
        <description>
 The scriptlet which will be executed before the network-interfaces are