Fixed last patch: use '[[' instead of '[' (found by Hans Ulrich Niedermann)
[util-vserver.git] / util-vserver / doc / configuration.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!-- $Id$ -->
3
4 <database xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
5           xsi:noNamespaceSchemaLocation="file:configuration.xsd">
6
7  <!-- Global configuration -->
8  <collection name=".default" use="optional">
9   <collection name="init" type="fixed">
10    <data name="mtab">
11     <description>Default mtab file</description>
12    </data>
13   </collection>
14
15   <link name="vdirbase">
16    <default>/vservers</default>
17   </link>
18   
19   <collection name="apps">
20    <collection name="pkgmgmt">
21     <link name="base">
22      <default>/vservers/.pkg</default>
23     </link> 
24     <data name="apt.conf">
25      <description>
26       The default apt.conf which is going to be used. It is overridden by
27       distribution specific configuration file.
28      </description>
29     </data>
30    </collection>
31    
32    <collection name="debootstrap">
33     <scalar name="mirror">
34      <description>
35       The Debian mirror to use with the 'debootstrap' program
36      </description>
37     </scalar>
38     <scalar name="uri">
39      <description>
40       When the 'debootstrap' package is not installed; fetch it from this uri and
41       install it at a temporary place.
42      </description>
43     </scalar>
44    </collection>
45    
46    <collection name="vprocunhide">
47     <list name="files">
48      <description>
49       A list of files which will be made visibly by vprocunhide. Wildcards are
50       allowed and anything ending in '/' will be processed recursively. When this file exists,
51       it overrides the defaults in SYSDEFAULTDIR/vprocunhide-files. The entries there must be
52       absolute filenames inclusive the leading '/proc'.
53      </description>
54     </list>
55    </collection>
56    
57    <collection name="init">
58     <link name="tty">
59      <description>
60       A symlink to the TTY device where input/output will be redirected from/to
61       at startup via initscript.
62      </description>
63     </link>
64    </collection>
65    
66    <collection name="vunify">
67     <list name="exclude">
68      <description>
69       Static list of excluded files.
70      </description>
71     </list>
72    </collection>
73   </collection>
74    
75   <collection name=".distributions" use="optional">
76    <collection name="dist" type="symbolic">
77     <scalar name="dev">
78      <description>
79      </description>
80     </scalar>
81     <data name="apt.conf">
82      <description>
83       The default apt.conf which is going to be used. It overrides the apt.conf
84       from CONFDIR/.defaults/apps/pkgmgmt.
85      </description>
86     </data>
87     <program name="initpre">
88      <description>
89       Script which will be executed before packages will be installed.
90      </description>
91      <parameterList>
92       <parameter name="confdir">
93        <description>
94         The configuration directory of the vserver which is going to be set up.
95        </description>
96       </parameter>
97       <parameter name="vserver">
98        <description>
99         The pathname of the vserver binary.
100        </description>
101       </parameter>
102      </parameterList>
103     </program>
104     <program name="initpost">
105      <description>
106       Script which will be executed after packages are installed.
107      </description>
108      <parameterList>
109       <parameter name="confdir">
110        <description>
111         The configuration directory of the vserver which is going to be set up.
112        </description>
113       </parameter>
114       <parameter name="vserver">
115        <description>
116         The pathname of the vserver binary.
117        </description>
118       </parameter>
119      </parameterList>
120     </program>
121     
122     <collection name="pkgs">
123      <description>
124       Contains files with packages.
125      </description>
126      <list name="list">
127       <description>
128        File which contains the name of packages. On top of file the special
129        keywords '--reinstall' and '--can-fail' are possible.
130       </description>
131      </list>
132     </collection>
133     
134     <collection name="pubkeys">
135      <description>
136       Directory with GPG pubkeys which are used to sign the packages of this
137       distribution.
138      </description>
139     </collection>
140     
141     <collection name="apt">
142      <description>
143       Default content of the /etc/apt/ directory.
144      </description>
145     </collection>
146     
147     <collection name="rpm">
148      <description>
149       Default content of the /etc/rpm directory.
150      </description>
151     </collection>
152     
153     <link name="rpmlib">
154      <description>
155       Directory which overrides /usr/lib/rpm.
156      </description>
157     </link>
158     <link name="execdir">
159      <description>
160       Directory with all executables and libraries which are required for this
161       distribution.
162      </description>
163     </link>
164    </collection>
165   </collection>
166  </collection>
167  
168  <!-- Vserver configuration -->
169  <collection name="vserver-name" type="symbolic">
170   <description>
171    The configuration directory for the vserver vserver-name.
172   </description>
173   
174   <link name="vdir">
175    <description>
176     Path of the vserver root directory
177    </description>
178   </link>
179
180   <link name="run">
181    <description>
182     Path of the vserver run directory
183    </description>
184   </link>
185
186   <link name="run.rev">
187    <description>
188     Path of the vserver run reverse directory
189    </description>
190   </link>
191   
192   <list name="bcapabilities">
193    <description>
194     [experimental; name is subject of possible change] Contains the system capabilities. See
195     <ulink url="http://savannah.nongnu.org/cgi-bin/viewcvs/util-vserver/util-vserver/lib/bcaps-v13.c?rev=HEAD">lib/bcaps-v13.c</ulink>
196     for possible values.
197    </description>
198   </list>
199   <list name="ccapabilities">
200    <description>
201     [experimental; name is subject of possible change] Contains the context capabilities. See
202     <ulink url="http://savannah.nongnu.org/cgi-bin/viewcvs/util-vserver/util-vserver/lib/ccaps-v13.c?rev=HEAD">lib/ccaps-v13.c</ulink>
203     for possible values.
204    </description>
205   </list>
206   <hash name="schedule">
207    <description>
208     [experimental; name is subject of possible change] Contains the scheduler parameters, 
209     one per line.
210     
211     The Hard CPU limit uses a mechanism called a Token Bucket.
212     the concept is simple: you have a bucket of a certain size
213     which is filled with a specified amount R of tokens each
214     interval T until the maximum is reached (excess tokens
215     are spilled). At each timer tick, a running process consumes
216     one token from the bucket, unless the bucket is empty. If the
217     bucket is empty the process is put in the hold queue. When the
218     bucket has been refilled to at least M tokens, all on hold 
219     processes are rescheduled.
220    </description>
221    <keys>
222     <key name="fill-rate">
223      <description>
224       Amount of tokens append to the bucket each interval.
225      </description>
226     </key>
227     <key name="interval">
228      <description>
229       The intervall between refills of amount 'fill_rate'. This value is express in ticks.
230      </description>
231     </key>
232     <key name="tokens">
233      <description>
234       Initial bucket contents.
235      </description>
236     </key>
237      <key name="tokens-min">
238      <description>
239       The minimum amount of tokens required to unhold processes
240      </description>
241     </key>
242     <key name="tokens-max">
243      <description>
244       The bucket size.
245      </description>
246     </key>
247     <key name="priority-bias">
248      <description>
249       ???
250      </description>
251     </key>
252    </keys>
253   </hash>
254   <scalar name="name">
255    <description>
256     Contains the name of the vserver. When not given, the basename of the directory
257     will be assumed as this name.
258    </description>
259   </scalar>
260   <scalar name="nice">
261    <description>
262     The nice-level on which the vserver will be started.
263    </description>
264   </scalar>
265   <list name="capabilities">
266    <description>
267     Contains per line a capability. This file is used for the 2.4
268     kernel only; for 2.6 use 'bcapabilities'.
269    </description>
270   </list>
271   <scalar name="shell">
272    <description>
273     Contains the pathname of the shell which will be used by the "vserver ... enter"
274     command.
275    </description>
276   </scalar>
277   <list name="flags">
278    <description>
279     Contains per line a flag. See
280     <ulink url="http://savannah.nongnu.org/cgi-bin/viewcvs/util-vserver/util-vserver/lib/cflags-v13.c?rev=HEAD">lib/cflags-v13.c</ulink>
281     for possible values.
282    </description>
283    <elements>
284     <element name="fakeinit">
285      <description>
286       The new process will believe it is process number 1. Useful to
287       run a real /sbin/init in a vserver. Warning: this flag should
288       not be used unless you know what you are doing. Often, it is
289       better to use the 'plain' initstyle.
290      </description>
291     </element>
292     <element name="lock">
293      <description>
294       The new process is trapped and can't use chcontext anymore.
295      </description>
296     </element>
297     <element name="sched">
298      <description>
299       The new process and its children will share a common
300      </description>
301     </element>
302     <element name="nproc">
303      <description>
304       Limit the number of process in the vserver according to
305       ulimit setting. Normally, ulimit is a per user thing.
306       With this flag, it becomes a per vserver thing.  
307      </description>
308     </element>
309     <element name="private">
310      <description>
311       No one can join this security context once created.
312      </description>
313     </element>
314     <element name="ulimit">
315      <description>
316       Apply the current ulimit to the whole context
317      </description>
318     </element>
319    </elements>
320   </list>
321   <scalar name="context">
322    <description>
323     Contains the context which shall be used for the vserver.
324    </description>
325   </scalar>
326   <data name="fstab">
327    <description>
328     The fstab file for the vserver. Entries in this file will be mounted within the
329     network context of the vserver; this means that mount will be called as 'chbind &lt;options&gt;
330     mount ...'. Use the 'fstab.local' file when you do not want this behavior, but in most cases
331     the 'fstab' file should be used.
332    </description>
333   </data>
334   <data name="fstab.local">
335    <description>
336     The fstab file for the vserver. In opposite to the normal 'fstab' file, the
337     mounting happens in the local network context. Currently there is no way to mix entries of
338     both files; 'fstab' will be always processed before 'fstab.local'.
339    </description>
340   </data>
341   
342   <collection name="apps">
343    <collection name="init">
344     <data name="mtab">
345      <description>
346       The initial-mtab which will be used for the vserver.
347      </description>
348     </data>
349     
350     <scalar name="style">
351      <description>
352       Contains the init-style.
353      </description>
354      <restriction>
355       <enumeration value="sysv"/>
356       <enumeration value="plain"/>
357       <enumeration value="minit"/>
358       <enumeration value="gento"/>
359      </restriction>
360     </scalar>
361                                                                                                                                   
362     <scalar name="runlevel">
363      <description>The start runlevel.</description>
364     </scalar>
365                                                                                                                                   
366     <scalar name="runlevel.start">
367      <description>The start runlevel.</description>
368     </scalar>
369                                                                                                                                   
370     <scalar name="runlevel.stop">
371      <description>The stop runlevel.</description>
372     </scalar>
373                                                                                                                                   
374                   <scalar name="killseq">
375                    <description>
376                     Contains the 'signal [wait signal]*' sequence which is used to stop the
377                     vserver.
378                    </description>
379                   </scalar>
380                                                                                                                                           
381                   <list name="cmd.start">
382                    <description>
383                     The command which is used to start the vserver. Each option must be on a
384                     separate line.
385                    </description>
386                   </list>
387                                                                                                                                           
388                   <list name="cmd.start-sync">
389                    <description>
390                     The command which is used to wait on the vserver after it has been
391                     started. Each option must be on a separate line. This file will be ignored when the
392                     'sync' does not exist and the '--sync' option was not used.
393                    </description>
394                   </list>
395                                                                                                                                           
396                   <list name="cmd.stop">
397                    <description>
398                     The command which is used to stop the vserver. Each option must be on a
399                     separate line.
400                    </description>
401                   </list>
402                                                                                                                                           
403     <list name="cmd.stop-sync">
404      <description>
405       The command which is used to wait on the vserver after it has been
406       stopped. Each option must be on a separate line. This file will be ignored when the
407       'sync' does not exist and the '--sync' option was not used.
408      </description>
409     </list>
410                                                                                                                                   
411                   <list name="cmd.prepare">
412                    <description>
413                     The command which is used to setup the init-system (e.g. to set the runlevel
414                     in the utmp-file). Each option must be on a separate line.
415                    </description>
416                   </list>
417                                                                                                                                           
418                   <boolean name="sync">
419                    <description>
420                     If this file is not present, all 'cmd.*-sync files will be ignored.
421                    </description>
422                   </boolean>
423                                                                                                                                           
424                   <link name="tty">
425                    <description>
426                     A symlink to the TTY device where input/output will be redirected from/to
427                     at startup via initscript.
428                    </description>
429                   </link>
430                 
431                   <scalar name="mark">
432                     <description>
433                      This file is used to mark group of vservers which shall be started/stopped
434                      together by the initscript. Content is a simple string like 'default'.
435                     </description>
436                   </scalar>
437                                                                                                                                           
438                   <list name="depends">
439                     <description>
440                      This file is used to configure vservers which must be running before the
441                      current vserver can be started. At shutdown, the current vserver will be stopped before
442                      its dependencies. Content of this file are vserver ids (one name per line).
443                     </description>
444                   </list>
445    </collection>
446    
447    <collection name="vshelper">
448                   <scalar name="sync-timeout">
449                    <description>
450                     The timeout in seconds which is used when synchronising vserver startup/shutdown
451                     with the vshelper. When no set, 30 seconds will be assumed.
452                    </description>
453                    <default>30</default>
454                   </scalar>
455                                                                                                                                           
456                   <scalar name="action">
457                    <description>
458                     The action which is going to be executed when a vshelper event occurs. The
459                     default value is 'restart', but there can be defined own methods by placing scripts into
460                     the 'vshelper-methods' directories. These scripts are fed with the same arguments as the
461                     'vshelper' script.
462                    </description>
463                    <default>restart</default>
464                   </scalar>
465                                                                                                                                   
466                   <program name="event" type="symbolic">
467                    <description>
468                     When existing. these scripts will be executed *instead* of the default
469                     handler defined in 'action'. Their name must match the event which caused the execution
470                     of 'vshelper'; e.g. 'restart' or 'poweroff'. See the vs_reboot() function in the kernel
471                     for more details.
472                    </description>
473                    <parameterList>
474                     <parameter name="xid">
475                      <description>The xid of the context calling the vshelper</description>
476                     </parameter>
477                     <parameter name="event">
478                      <description>The reboot-event</description>
479                     </parameter>
480                    </parameterList>
481                   </program>
482                                                                                                                                           
483                   <boolean name="disabled">
484                    <description>
485                     When existing, the vshelper functionality will be disabled for this
486                     vserver.
487                    </description>
488                   </boolean>
489                                                                                                                                           
490                   <boolean name="warning-disabled">
491                     <description>
492                      When existing, sanity checks for the vshelper functionality will be
493                      skipped.
494                     </description>
495                   </boolean>
496                                                                                                                                           
497     <link name="logfile">
498       <description>
499        The file where output will be logged to when 'vshelper' is invoked from the
500        kernel. This should point somewhere e.g. into /var/log.
501       </description>
502     </link>
503    </collection>
504    
505    <collection name="vshelper-methods">
506     <program name="handler" type="symbolic">
507      <description>
508       See vshelper/action.
509      </description>
510     </program>
511    </collection>
512    
513    <collection name="vunify">
514                   <description>
515                    This directory contains configuration data required for vserver
516                    unification.
517                   </description>
518                                                                                                                                           
519                   <list name="exclude">
520                     <description>
521                      Static list of excluded files. This list supports an rsync syntax: when a
522                      file is prefixed by '+', it is a candidate for unification; when there is no prefix or a
523                      '-' it will be excluded. Shell-wildcards are allowed for the filenames.
524                     </description>
525                   </list>
526                                                                                                                                           
527                   <link name="refserver.X" type="symbolic">
528                    <description>
529                     These are symlinks to the configuration directory
530                     (e.g. CONFDIR/vservers/&lt;id&gt;) of a refserver. There may be multiple such symlinks
531                     but they must be prefixed by 'refserver.' and will be processed in alphanumerical
532                     order.
533                    </description>
534                   </link>
535    </collection>
536   </collection>
537   
538   <collection name="scripts">
539    <description>
540     A directory for scripts. By default, when one of these scripts will be executed,
541     the execution of defaultscripts (within .../.defaults/scripts) will be skipped. To execute
542     them nevertheless, the $DONT_SKIP_DEFAULTS environment variable must be set by one of the
543     in-shellcontext scripts (the non-executable ones).
544    </description>
545    
546    <program name="prepre-start">
547     <description>
548      The scriptlet which will be executed before the network-interfaces are enabled
549      and the directories are mounted."
550     </description>
551     <parameterList>
552      <parameter name="vserver-dir">
553       <description>The configuration directory of the current vserver.</description>
554      </parameter>
555      <parameter name="vserver-name">
556       <description>The name of the current vserver.</description>
557      </parameter>
558      <parameter name="action">
559       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
560      </parameter>
561     </parameterList>
562    </program>
563    <collection name="prepre-start.d">
564     <description>
565      Repository of prepre-start like scripts
566     </description>                                                                                                                 
567     <program name="script" type="symbolic">
568       <description>See prepre-start.</description>
569       <parameterList>
570                      <parameter name="vserver-dir">
571                       <description>The configuration directory of the current vserver.</description>
572                      </parameter>
573                      <parameter name="vserver-name">
574                       <description>The name of the current vserver.</description>
575                      </parameter>
576                      <parameter name="action">
577                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
578                      </parameter>
579                     </parameterList>
580     </program>
581    </collection>
582                                                                                                                               
583    <program name="pre-start">
584     <description>
585      The scriptlet which will be executed after network-interfaces were enabled and
586      the directories mounted, but before the vserver itself has been started.
587     </description>
588     <parameterList>
589      <parameter name="vserver-dir">
590       <description>The configuration directory of the current vserver.</description>
591      </parameter>
592      <parameter name="vserver-name">
593       <description>The name of the current vserver.</description>
594      </parameter>
595      <parameter name="action">
596       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
597      </parameter>
598     </parameterList>
599    </program>
600    <collection name="pre-start.d">
601     <description>
602      Repository of pre-start like scripts
603     </description>                                                                                                                 
604     <program name="script" type="symbolic">
605       <description>See pre-start.</description>
606       <parameterList>
607                      <parameter name="vserver-dir">
608                       <description>The configuration directory of the current vserver.</description>
609                      </parameter>
610                      <parameter name="vserver-name">
611                       <description>The name of the current vserver.</description>
612                      </parameter>
613                      <parameter name="action">
614                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
615                      </parameter>
616                     </parameterList>
617     </program>
618    </collection>
619                                                                                                                 
620
621    <program name="post-start">
622     <description>
623      The scriptlet which will be executed after the vserver has been started.
624     </description>
625     <parameterList>
626      <parameter name="vserver-dir">
627       <description>The configuration directory of the current vserver.</description>
628      </parameter>
629      <parameter name="vserver-name">
630       <description>The name of the current vserver.</description>
631      </parameter>
632      <parameter name="action">
633       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
634      </parameter>
635     </parameterList>
636    </program>
637    <collection name="post-start.d">
638     <description>
639      Repository of post-start like scripts
640     </description>                                                                                                                 
641     <program name="script" type="symbolic">
642       <description>See post-start.</description>
643       <parameterList>
644                      <parameter name="vserver-dir">
645                       <description>The configuration directory of the current vserver.</description>
646                      </parameter>
647                      <parameter name="vserver-name">
648                       <description>The name of the current vserver.</description>
649                      </parameter>
650                      <parameter name="action">
651                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
652                      </parameter>
653                     </parameterList>
654     </program>
655    </collection>
656
657
658    <program name="pre-stop">
659     <description>
660      The scriptlet which will be executed before the vserver will be stopped.
661     </description>
662     <parameterList>
663      <parameter name="vserver-dir">
664       <description>The configuration directory of the current vserver.</description>
665      </parameter>
666      <parameter name="vserver-name">
667       <description>The name of the current vserver.</description>
668      </parameter>
669      <parameter name="action">
670       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
671      </parameter>
672     </parameterList>
673    </program>
674    <collection name="pre-stop.d">
675     <description>
676      Repository of pre-stop like scripts
677     </description>                                                                                                                 
678     <program name="script" type="symbolic">
679       <description>See pre-stop.</description>
680       <parameterList>
681                      <parameter name="vserver-dir">
682                       <description>The configuration directory of the current vserver.</description>
683                      </parameter>
684                      <parameter name="vserver-name">
685                       <description>The name of the current vserver.</description>
686                      </parameter>
687                      <parameter name="action">
688                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
689                      </parameter>
690                     </parameterList>
691     </program>
692    </collection>
693
694    <program name="post-stop">
695     <description>
696      The scriptlet which will be executed after the vserver has been stopped, but
697      before the directories will be umounted and the the interfaces
698      disabled.
699     </description>
700     <parameterList>
701      <parameter name="vserver-dir">
702       <description>The configuration directory of the current vserver.</description>
703      </parameter>
704      <parameter name="vserver-name">
705       <description>The name of the current vserver.</description>
706      </parameter>
707      <parameter name="action">
708       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
709      </parameter>
710     </parameterList>
711    </program>
712    <collection name="post-stop.d">
713     <description>
714      Repository of post-stop like scripts
715     </description>                                                                                                                 
716     <program name="script" type="symbolic">
717       <description>See post-stop.</description>
718       <parameterList>
719                      <parameter name="vserver-dir">
720                       <description>The configuration directory of the current vserver.</description>
721                      </parameter>
722                      <parameter name="vserver-name">
723                       <description>The name of the current vserver.</description>
724                      </parameter>
725                      <parameter name="action">
726                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
727                      </parameter>
728                     </parameterList>
729     </program>
730    </collection>
731                                                                                                                               
732    <program name="postpost-stop">
733     <description>
734      The scriptlet which will be executed after the vserver has been stopped
735      completely.
736     </description>
737     <parameterList>
738      <parameter name="vserver-dir">
739       <description>The configuration directory of the current vserver.</description>
740      </parameter>
741      <parameter name="vserver-name">
742       <description>The name of the current vserver.</description>
743      </parameter>
744      <parameter name="action">
745       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
746      </parameter>
747     </parameterList>
748    </program>
749    <collection name="postpost-stop.d">
750     <description>
751      Repository of postpost-stop like scripts
752     </description>                                                                                                                 
753     <program name="script" type="symbolic">
754       <description>See postpost-stop.</description>
755       <parameterList>
756                      <parameter name="vserver-dir">
757                       <description>The configuration directory of the current vserver.</description>
758                      </parameter>
759                      <parameter name="vserver-name">
760                       <description>The name of the current vserver.</description>
761                      </parameter>
762                      <parameter name="action">
763                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
764                      </parameter>
765                     </parameterList>
766     </program>
767    </collection>
768   </collection>
769   
770   <collection name="interfaces">
771                         <scalar name="bcast">
772                          <description>The default broadcast address.</description>
773                         </scalar>
774                         <scalar name="dev">
775                          <description>The default network device.</description>
776                         </scalar>
777                         <scalar name="prefix">
778                           <description>The default network prefix-length.</description>
779                         </scalar>
780                         <scalar name="mask">
781                           <description>The default network mask.</description>
782                         </scalar>
783                         <scalar name="scope">
784                           <description>The default scope of the network interfaces.</description>
785                         </scalar>
786                                                                                                                                                   
787                         <collection name="iface" type="symbolic">
788                   <description>
789                    'iface' is an arbitrary name for the interface; the value itself is not important
790                    but may be interesting regarding interface-creation and usage with 'chbind'. Both happens in
791                    alphabetical order and numbers like '00' are good names for these directories.
792                   </description>
793                                                                                                                                           
794                   <boolean name="disabled">
795                     <description>When this file exists, this interface will be ignored.</description>
796                   </boolean>
797                                                                                                                                           
798                   <scalar name="ip">
799                    <description>The ip which will be assigned to this interface.</description>
800                   </scalar>
801                   <scalar name="bcast">
802                    <description>The broadcast address.</description>
803                   </scalar>
804                   <scalar name="dev">
805                    <description>The network device.</description>
806                   </scalar>
807                   <scalar name="prefix">
808                    <description>The network prefix-length.</description>
809                   </scalar>
810                   <scalar name="mask">
811                    <description>The network mask.</description>
812                   </scalar>
813                   <scalar name="scope">
814                    <description>The scope of the network interface.</description>
815                   </scalar>
816                   <scalar name="name">
817                    <description>
818                     When this file exists, the interface will be named
819                     with the text in this file. Without such an entry,
820                     the IP will not be shown by 'ifconfig' but by 'ip
821                     addr ls' only.  Such a labeled interface is known
822                     as an "alias" also (e.g. 'eth0:foo').
823                    </description>
824                   </scalar>
825                   <boolean name="nodev">
826                    <description>
827                     When this file exists, the interface will be
828                     assumed to exist already. This can be used to
829                     assign primary interfaces which are created by
830                     the host or another vserver.
831                    </description>
832                   </boolean>
833    </collection>
834   </collection>
835   
836   <collection name="ulimits">
837                         <description>
838                          A directory with ulimits. Possible resources are cpu, data, fsize, locks,
839                          memlock, nofile, nproc, rss and/or stack. This configuration will be honored
840                          for kernel 2.4 only.
841                         </description>                                                                                                                 
842                         <scalar name="resource" type="symbolic">
843                           <description>
844                            A file which contains the hard- and soft-limit of the given resource in the
845                            first line. The special keyword 'inf' is recognized.
846                           </description>
847                         </scalar>                                                                            
848                         <scalar name="resource.hard" type="symbolic">
849                           <description>
850                            A file which contains the hard- of the given resource in the first line. The
851                            special keyword 'inf' is recognized.
852                           </description>
853                         </scalar>                                                                                             
854                         <scalar name="resource.soft" type="symbolic">
855                           <description>
856                            A file which contains the soft- of the given resource in the first line. The
857                            special keyword 'inf' is recognized.
858                           </description>
859                         </scalar>
860   </collection>
861  
862   <collection name="rlimits">
863    <description>
864                          A directory with resource limits. Possible resources are cpu, fsize, data, stack,
865                          core, rss, nproc, nofile, memlock, as and locks. This configuration will be honored
866                          for kernel 2.6 only.
867                         </description>                                                                                                                 
868                         <scalar name="resource" type="symbolic">
869                           <description>
870                            A file which contains the hard- and soft-limit of the given resource in the
871                            first line. The special keyword 'inf' is recognized.
872                           </description>
873                         </scalar>                                                                            
874                         <scalar name="resource.hard" type="symbolic">
875                           <description>
876                            A file which contains the hard- of the given resource in the first line. The
877                            special keyword 'inf' is recognized.
878                           </description>
879                         </scalar>                                                                                             
880                         <scalar name="resource.soft" type="symbolic">
881                           <description>
882                            A file which contains the soft- of the given resource in the first line. The
883                            special keyword 'inf' is recognized.
884                           </description>
885                         </scalar>
886                         <scalar name="resource.min" type="symbolic">
887                           <description>
888                            A file which contains the guaranted minimum of the given resource in the first line. The
889                            special keyword 'inf' is recognized.
890                           </description>
891                         </scalar>
892   </collection>
893   
894   <collection name="uts">
895                         <scalar name="context">
896                           <description>
897                            The context-name of the vserver. This file is listed for completeness only;
898                            the 'context' name is used and set internally by the util-vserver tools and can *not* be
899                            modified.
900                           </description>
901                         </scalar>
902                         <scalar name="sysname">
903                          <description>The sysname of the vserver</description>
904                         </scalar>
905                         <scalar name="nodename">
906                          <description>The node-/hostname of the vserver</description>
907                         </scalar>
908                         <scalar name="release">
909                          <description>The OS-release of the vserver</description>
910                         </scalar>
911                         <scalar name="version">
912                          <description>The OS-version of the vserver</description>
913                         </scalar>
914                         <scalar name="machine">
915                          <description>The machine-type of the vserver</description>
916                         </scalar>
917                         <scalar name="domainname">
918                          <description>The NIS domainname of the vserver</description>
919                         </scalar>
920   </collection>
921  </collection>
922 </database>