Teach the spec how to build prereleases and release candidates.
[util-vserver.git] / doc / configuration.xml
index 98b04ec..18a10db 100644 (file)
@@ -37,10 +37,10 @@ the 'barrier' attribute. Else, common chroot(2) exploits are possible.
       </description>
     </boolean>
 
-    <boolean id="global-namespace-cleanup" name="namespace-cleanup">
+    <boolean id="global-nonamespace-cleanup" name="nonamespace-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
+Disable namespace cleanup globally. It can be overridden for a single vserver
+by setting the <optionref ref="namespace-cleanup">namespace-cleanup</optionref> flag
 there.
       </description>
     </boolean>
@@ -364,6 +364,13 @@ url="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/ccaps-v13.c">lib/cc
 for possible values.
       </description>
     </list>
+    <list name="ncapabilities" since="0.30.212">
+      <description>
+Contains the network capabilities. See <ulink
+url="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/ncaps-net.c">lib/ncaps-net.c</ulink>
+for possible values.
+      </description>
+    </list>
 
     <boolean id="global-namespace" name="namespace">
       <description>
@@ -381,30 +388,24 @@ the 'barrier' attribute. Else, common chroot(2) exploits are possible.
       </description>
     </boolean>
 
-    <boolean id="global-nonamespace-cleanup" name="nonamespace-cleanup">
+    <boolean id="namespace-cleanup" name="namespace-cleanup">
       <description>
-Overrides the global <optionref ref="global-namespace-cleanup">namespace-cleanup</optionref> flag and disables
+Overrides the global <optionref ref="global-nonamespace-cleanup">nonamespace-cleanup</optionref> flag and enables
 namespace cleanup for the current vserver.
       </description>
     </boolean>
 
-    <boolean name="namespace-cleanup">
-      <description>
-Enable namespace cleanup for the current vserver.
-      </description>
-    </boolean>
-
     <list name="namespace-cleanup-skip">
       <description>
-List of paths to skip during namespace cleanup. This overrides the 
-<optionref ref="global-namespace-cleanup-skip">global namespace-cleanup-skip</optionref>
+List of paths to skip during namespace cleanup. This overrides the global
+<optionref ref="global-namespace-cleanup-skip">namespace-cleanup-skip</optionref>
 file.
       </description>
     </list>
 
     <hash name="schedule">
       <description>
-[experimental; name is subject of possible change] Contains the
+[deprecated; use <optionref ref="sched">sched</optionref> instead] Contains the
 scheduler parameters, one per line.
 
 The Hard CPU limit uses a mechanism called a Token Bucket.  the
@@ -530,6 +531,13 @@ Apply the current ulimit to the whole context
       </elements>
       -->
     </list>
+    <list name="nflags" since="0.30.212">
+      <description>
+Contains a network flag per line. See <ulink
+url="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/nflags-net.c">lib/nflags-net.c</ulink>
+for possible values.
+      </description>
+    </list>
     <scalar name="context">
       <description>
 Contains the context which shall be used for the vserver.
@@ -1211,13 +1219,13 @@ in the first line. The special keyword 'inf' is recognized.
       </scalar>
       <scalar name="resource.hard" type="symbolic">
        <description>
-A file which contains the hard- of the given resource in the first
+A file which contains the hard-limit of the given resource in the first
 line. The special keyword 'inf' is recognized.
        </description>
       </scalar>
       <scalar name="resource.soft" type="symbolic">
        <description>
-A file which contains the soft- of the given resource in the first
+A file which contains the soft-limit of the given resource in the first
 line. The special keyword 'inf' is recognized.
        </description>
       </scalar>
@@ -1238,19 +1246,19 @@ in the first line. The special keyword 'inf' is recognized.
       </scalar>
       <scalar name="resource.hard" type="symbolic">
        <description>
-A file which contains the hard- of the given resource in the first
+A file which contains the hard-limit of the given resource in the first
 line. The special keyword 'inf' is recognized.
        </description>
       </scalar>
       <scalar name="resource.soft" type="symbolic">
        <description>
-A file which contains the soft- of the given resource in the first
+A file which contains the soft-limit of the given resource in the first
 line. The special keyword 'inf' is recognized.
        </description>
       </scalar>
       <scalar name="resource.min" type="symbolic">
        <description>
-A file which contains the guaranted minimum of the given resource in
+A file which contains the guaranteed minimum of the given resource in
 the first line. The special keyword 'inf' is recognized.
         </description>
       </scalar>
@@ -1322,7 +1330,7 @@ tools and can *not* be modified.
       </scalar>
     </collection>
 
-    <collection name="sched" since="0.30.212">
+    <collection id="sched" name="sched" since="0.30.212">
       <scalar id="global-tokens" name="tokens">
         <description>The initial amount of tokens to put in the bucket</description>
       </scalar>
@@ -1362,24 +1370,24 @@ tools and can *not* be modified.
           <description>The bucket's size</description>
         </scalar>
         <scalar name="fill-rate">
-          <description>Amount of tokens to add each <optionref ref="interval">interval</optionref></description>
+          <description>Amount of tokens to add each <optionref ref="local-interval">interval</optionref></description>
         </scalar>
-        <scalar name="interval">
+        <scalar id="local-interval" name="interval">
           <description>The interval between refills of the bucket</description>
         </scalar>
         <scalar name="priority-bias">
           <description>Bias added to priorities calculated within the guest (result is clamped to -20/+19)</description>
         </scalar>
         <scalar name="fill-rate2">
-          <description>Amount of tokens to add each <optionref ref="interval2">interval2</optionref> when advancing idle time</description>
+          <description>Amount of tokens to add each <optionref ref="local-interval2">interval2</optionref> when advancing idle time</description>
         </scalar>
-        <scalar name="interval2">
+        <scalar id="local-interval2" name="interval2">
           <description>The interval between refills of the bucket when advancing idle time</description>
         </scalar>
         <boolean name="idle-time">
           <description>When this file exists, advancing idle time is activated</description>
         </boolean>
-        <scalar name="cpu-id">
+        <scalar id="cpu-id" name="cpu-id">
           <description>The CPU to apply these settings to</description>
         </scalar>
         <scalar name="bucket-id">