added yum-2.6.0-chroot.patch
[util-vserver.git] / util-vserver / doc / configuration.xml
index 9e45e47..8866b7a 100644 (file)
       <description>A link to the default vserver rootdirectory.</description>
     </link>
 
+    <link name="cachebase">
+      <default>/var/cache/vservers</default>
+      <description>
+A link to the directory which will hold cached information about
+vservers.
+      </description>
+    </link>
 
     <boolean id="global-nonamespace" name="nonamespace">
       <description>
@@ -283,8 +290,16 @@ this distribution.
     <description>
 The configuration directory for the vserver vserver-name.
     </description>
+
+    <link name="cache">
+      <default>../.defaults/cachebase/VSERVERNAME</default>
+      <description>
+Path of the storage area for cached information about this vserver.
+      </description>
+    </link>
     
     <link name="vdir">
+      <default>../.defaults/vdirbase/VSERVERNAME</default>
       <description>
 Path of the vserver root directory
       </description>
@@ -342,6 +357,9 @@ a running process consumes one token from the bucket, unless the
 bucket is empty. If the bucket is empty the process is put in the
 hold queue. When the bucket has been refilled to at least M tokens,
 all on hold processes are rescheduled.
+
+See the <ulink url="http://linux-vserver.org/Scheduler+Parameters">Linux
+VServer Wiki</ulink> for more information about this file.
       </description>
       <keys>
        <key id="fill_rate" name="fill-rate">
@@ -414,6 +432,7 @@ Contains per line a flag. See <ulink
 url="http://savannah.nongnu.org/cgi-bin/viewcvs/util-vserver/util-vserver/lib/cflags-v13.c?rev=HEAD">lib/cflags-v13.c</ulink>
 for possible values.
       </description>
+      <!--
       <elements>
        <element name="fakeinit">
          <description>
@@ -451,6 +470,7 @@ Apply the current ulimit to the whole context
           </description>
        </element>
       </elements>
+      -->
     </list>
     <scalar name="context">
       <description>
@@ -732,7 +752,8 @@ environment variable must be set by one of the in-shellcontext scripts
       <program name="prepre-start">
        <description>
 The scriptlet which will be executed before the network-interfaces are
-enabled and the directories are mounted."
+enabled and the directories are mounted. Before executing the script,
+the configuration directory will be made the working directory.
         </description>
        <parameterList>
          <parameter name="vserver-dir">
@@ -754,7 +775,8 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
       </program>
       <collection name="prepre-start.d">
        <description>
-Repository of prepre-start like scripts
+Repository of prepre-start like scripts.  Before executing the script,
+the configuration directory will be made the working directory.
         </description>                                                                                                                 
        <program name="script" type="symbolic">
          <description>See prepre-start.</description>
@@ -782,7 +804,8 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
        <description>
 The scriptlet which will be executed after network-interfaces were
 enabled and the directories mounted, but before the vserver itself has
-been started.
+been started.  Before executing the script, the vserver root directory
+will be made the working directory.
         </description>
        <parameterList>
          <parameter name="vserver-dir">
@@ -804,7 +827,8 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
       </program>
       <collection name="pre-start.d">
        <description>
-Repository of pre-start like scripts
+Repository of pre-start like scripts. Before executing these scripts,
+the vserver root directory will be made the working directory.
         </description>                                                                                                                 
        <program name="script" type="symbolic">
          <description>See pre-start.</description>
@@ -829,7 +853,9 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
 
       <program name="post-start">
        <description>
-The scriptlet which will be executed after the vserver has been started.
+The scriptlet which will be executed after the vserver has been
+started. Before executing the script, the vserver root directory
+will be made the working directory.
         </description>
        <parameterList>
          <parameter name="vserver-dir">
@@ -846,7 +872,10 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
        </parameterList>
       </program>
       <collection name="post-start.d">
-       <description>Repository of post-start like scripts</description>
+       <description>
+Repository of post-start like scripts. Before executing these scripts,
+the vserver root directory will be made the working directory.
+        </description>
        <program name="script" type="symbolic">
          <description>See post-start.</description>
          <parameterList>
@@ -868,7 +897,9 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
 
       <program name="pre-stop">
        <description>
-The scriptlet which will be executed before the vserver will be stopped.
+The scriptlet which will be executed before the vserver will be
+stopped. Before executing the script, the vserver root directory
+will be made the working directory.
         </description>
        <parameterList>
          <parameter name="vserver-dir">
@@ -886,7 +917,8 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
       </program>
       <collection name="pre-stop.d">
        <description>
-Repository of pre-stop like scripts
+Repository of pre-stop like scripts. Before executing the script, the
+vserver root directory will be made the working directory.
         </description>                                                                                                                 
        <program name="script" type="symbolic">
          <description>See pre-stop.</description>
@@ -910,7 +942,8 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
        <description>
 The scriptlet which will be executed after the vserver has been
 stopped, but before the directories will be umounted and the the
-interfaces disabled.
+interfaces disabled. Before executing the script, the vserver root
+directory will be made the working directory.
         </description>
        <parameterList>
          <parameter name="vserver-dir">
@@ -927,7 +960,10 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
        </parameterList>
       </program>
       <collection name="post-stop.d">
-       <description>Repository of post-stop like scripts</description>
+       <description>
+Repository of post-stop like scripts. Before executing the script, the
+vserver root directory will be made the working directory.
+        </description>
        <program name="script" type="symbolic">
          <description>See post-stop.</description>
          <parameterList>
@@ -949,7 +985,8 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
       <program name="postpost-stop">
        <description>
 The scriptlet which will be executed after the vserver has been stopped
-completely.
+completely. Before executing the script, the vserver root directory
+will be made the working directory.
         </description>
        <parameterList>
          <parameter name="vserver-dir">
@@ -966,7 +1003,10 @@ The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).
        </parameterList>
       </program>
       <collection name="postpost-stop.d">
-       <description>Repository of postpost-stop like scripts</description>
+       <description>
+Repository of postpost-stop like scripts. Before executing the script,
+the vserver root directory will be made the working directory.
+        </description>
        <program name="script" type="symbolic">
          <description>See postpost-stop.</description>
          <parameterList>
@@ -1048,6 +1088,13 @@ already. This can be used to assign primary interfaces which are
 created by the host or another vserver.
          </description>
        </boolean>
+       <boolean name="novlandev">
+         <description>
+When this file exists, the steps which setup and destroy a VLAN
+interface will be skipped. This flag should be set when a VLAN
+interface is used by multiple vservers or by the host.
+         </description>
+       </boolean>
       </collection>
     </collection>
     
@@ -1136,5 +1183,22 @@ tools and can *not* be modified.
        <description>The NIS domainname of the vserver</description>
       </scalar>
     </collection>
+
+    <collection name="dlimits">
+      <collection name="dlimit" type="symbolic">
+        <scalar name="directory">
+          <description>The directory to which the limit should be applied</description>
+        </scalar>
+        <scalar name="inodes_total">
+          <description>The amount of inodes this vserver should be limited to</description>
+        </scalar>
+        <scalar name="space_total">
+          <description>The amount of space this vserver should be limited to (measured in blocks of 1024 bytes)</description>
+        </scalar>
+        <scalar name="reserved">
+          <description>How much space (percentage-wise) should be reserved for the root user</description>
+        </scalar>
+      </collection>
+    </collection>
   </collection>
   </database>