removed a __THROW which is not needed and causes errors with newer gcc
[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="cpu-mask">
248      <description>
249       Unused at the moment.
250      </description>
251     </key>
252    </keys>
253   </hash>
254   <scalar name="hostname">
255    <description>
256     Contains the hostname of the vserver. Same as uts/nodename.
257    </description>
258   </scalar>
259   <scalar name="name">
260    <description>
261     Contains the name of the vserver. When not given, the basename of the directory
262     will be assumed as this name.
263    </description>
264   </scalar>
265   <scalar name="domainname">
266    <description>
267     The domainname of the vserver. Same as uts/domainname.
268    </description>
269   </scalar>
270   <scalar name="nice">
271    <description>
272     The nice-level on which the vserver will be started.
273    </description>
274   </scalar>
275   <list name="capabilities">
276    <description>
277     Contains per line a capability. This file is used for the 2.4
278     kernel only; for 2.6 use 'bcapabilities'.
279    </description>
280   </list>
281   <scalar name="shell">
282    <description>
283     Contains the pathname of the shell which will be used by the "vserver ... enter"
284     command.
285    </description>
286   </scalar>
287   <list name="flags">
288    <description>
289     Contains per line a flag. See
290     <ulink url="http://savannah.nongnu.org/cgi-bin/viewcvs/util-vserver/util-vserver/lib/cflags-v13.c?rev=HEAD">lib/cflags-v13.c</ulink>
291     for possible values.
292    </description>
293    <elements>
294     <element name="fakeinit">
295      <description>
296       The new process will believe it is process number 1. Useful to
297       run a real /sbin/init in a vserver. Warning: this flag should
298       not be used unless you know what you are doing. Often, it is
299       better to use the 'plain' initstyle.
300      </description>
301     </element>
302     <element name="lock">
303      <description>
304       The new process is trapped and can't use chcontext anymore.
305      </description>
306     </element>
307     <element name="sched">
308      <description>
309       The new process and its children will share a common
310      </description>
311     </element>
312     <element name="nproc">
313      <description>
314       Limit the number of process in the vserver according to
315       ulimit setting. Normally, ulimit is a per user thing.
316       With this flag, it becomes a per vserver thing.  
317      </description>
318     </element>
319     <element name="private">
320      <description>
321       No one can join this security context once created.
322      </description>
323     </element>
324     <element name="ulimit">
325      <description>
326       Apply the current ulimit to the whole context
327      </description>
328     </element>
329    </elements>
330   </list>
331   <scalar name="context">
332    <description>
333     Contains the context which shall be used for the vserver.
334    </description>
335   </scalar>
336   <data name="fstab">
337    <description>
338     The fstab file for the vserver. Entries in this file will be mounted within the
339     network context of the vserver; this means that mount will be called as 'chbind &lt;options&gt;
340     mount ...'. Use the 'fstab.local' file when you do not want this behavior, but in most cases
341     the 'fstab' file should be used.
342    </description>
343   </data>
344   <data name="fstab.local">
345    <description>
346     The fstab file for the vserver. In opposite to the normal 'fstab' file, the
347     mounting happens in the local network context. Currently there is no way to mix entries of
348     both files; 'fstab' will be always processed before 'fstab.local'.
349    </description>
350   </data>
351   
352   <collection name="apps">
353    <collection name="init">
354     <data name="mtab">
355      <description>
356       The initial-mtab which will be used for the vserver.
357      </description>
358     </data>
359     
360     <scalar name="style">
361      <description>
362       Contains the init-style.
363      </description>
364      <restriction>
365       <enumeration value="sysv"/>
366       <enumeration value="plain"/>
367       <enumeration value="minit"/>
368       <enumeration value="gento"/>
369      </restriction>
370     </scalar>
371                                                                                                                                   
372     <scalar name="runlevel">
373      <description>The start runlevel.</description>
374     </scalar>
375                                                                                                                                   
376     <scalar name="runlevel.start">
377      <description>The start runlevel.</description>
378     </scalar>
379                                                                                                                                   
380     <scalar name="runlevel.stop">
381      <description>The stop runlevel.</description>
382     </scalar>
383                                                                                                                                   
384                   <scalar name="killseq">
385                    <description>
386                     Contains the 'signal [wait signal]*' sequence which is used to stop the
387                     vserver.
388                    </description>
389                   </scalar>
390                                                                                                                                           
391                   <list name="cmd.start">
392                    <description>
393                     The command which is used to start the vserver. Each option must be on a
394                     separate line.
395                    </description>
396                   </list>
397                                                                                                                                           
398                   <list name="cmd.start-sync">
399                    <description>
400                     The command which is used to wait on the vserver after it has been
401                     started. Each option must be on a separate line. This file will be ignored when the
402                     'sync' does not exist and the '--sync' option was not used.
403                    </description>
404                   </list>
405                                                                                                                                           
406                   <list name="cmd.stop">
407                    <description>
408                     The command which is used to stop the vserver. Each option must be on a
409                     separate line.
410                    </description>
411                   </list>
412                                                                                                                                           
413     <list name="cmd.stop-sync">
414      <description>
415       The command which is used to wait on the vserver after it has been
416       stopped. Each option must be on a separate line. This file will be ignored when the
417       'sync' does not exist and the '--sync' option was not used.
418      </description>
419     </list>
420                                                                                                                                   
421                   <list name="cmd.prepare">
422                    <description>
423                     The command which is used to setup the init-system (e.g. to set the runlevel
424                     in the utmp-file). Each option must be on a separate line.
425                    </description>
426                   </list>
427                                                                                                                                           
428                   <boolean name="sync">
429                    <description>
430                     If this file is not present, all 'cmd.*-sync files will be ignored.
431                    </description>
432                   </boolean>
433                                                                                                                                           
434                   <link name="tty">
435                    <description>
436                     A symlink to the TTY device where input/output will be redirected from/to
437                     at startup via initscript.
438                    </description>
439                   </link>
440                 
441                   <scalar name="mark">
442                     <description>
443                      This file is used to mark group of vservers which shall be started/stopped
444                      together by the initscript. Content is a simple string like 'default'.
445                     </description>
446                   </scalar>
447                                                                                                                                           
448                   <list name="depends">
449                     <description>
450                      This file is used to configure vservers which must be running before the
451                      current vserver can be started. At shutdown, the current vserver will be stopped before
452                      its dependencies. Content of this file are vserver ids (one name per line).
453                     </description>
454                   </list>
455    </collection>
456    
457    <collection name="vshelper">
458                   <scalar name="sync-timeout">
459                    <description>
460                     The timeout in seconds which is used when synchronising vserver startup/shutdown
461                     with the vshelper. When no set, 30 seconds will be assumed.
462                    </description>
463                    <default>30</default>
464                   </scalar>
465                                                                                                                                           
466                   <scalar name="action">
467                    <description>
468                     The action which is going to be executed when a vshelper event occurs. The
469                     default value is 'restart', but there can be defined own methods by placing scripts into
470                     the 'vshelper-methods' directories. These scripts are fed with the same arguments as the
471                     'vshelper' script.
472                    </description>
473                    <default>restart</default>
474                   </scalar>
475                                                                                                                                   
476                   <program name="event" type="symbolic">
477                    <description>
478                     When existing. these scripts will be executed *instead* of the default
479                     handler defined in 'action'. Their name must match the event which caused the execution
480                     of 'vshelper'; e.g. 'restart' or 'poweroff'. See the vs_reboot() function in the kernel
481                     for more details.
482                    </description>
483                    <parameterList>
484                     <parameter name="xid">
485                      <description>The xid of the context calling the vshelper</description>
486                     </parameter>
487                     <parameter name="event">
488                      <description>The reboot-event</description>
489                     </parameter>
490                    </parameterList>
491                   </program>
492                                                                                                                                           
493                   <boolean name="disabled">
494                    <description>
495                     When existing, the vshelper functionality will be disabled for this
496                     vserver.
497                    </description>
498                   </boolean>
499                                                                                                                                           
500                   <boolean name="warning-disabled">
501                     <description>
502                      When existing, sanity checks for the vshelper functionality will be
503                      skipped.
504                     </description>
505                   </boolean>
506                                                                                                                                           
507     <link name="logfile">
508       <description>
509        The file where output will be logged to when 'vshelper' is invoked from the
510        kernel. This should point somewhere e.g. into /var/log.
511       </description>
512     </link>
513    </collection>
514    
515    <collection name="vshelper-methods">
516     <program name="handler" type="symbolic">
517      <description>
518       See vshelper/action.
519      </description>
520     </program>
521    </collection>
522    
523    <collection name="vunify">
524                   <description>
525                    This directory contains configuration data required for vserver
526                    unification.
527                   </description>
528                                                                                                                                           
529                   <list name="exclude">
530                     <description>
531                      Static list of excluded files. This list supports an rsync syntax: when a
532                      file is prefixed by '+', it is a candidate for unification; when there is no prefix or a
533                      '-' it will be excluded. Shell-wildcards are allowed for the filenames.
534                     </description>
535                   </list>
536                                                                                                                                           
537                   <link name="refserver.X" type="symbolic">
538                    <description>
539                     These are symlinks to the configuration directory
540                     (e.g. CONFDIR/vservers/&lt;id&gt;) of a refserver. There may be multiple such symlinks
541                     but they must be prefixed by 'refserver.' and will be processed in alphanumerical
542                     order.
543                    </description>
544                   </link>
545    </collection>
546   </collection>
547   
548   <collection name="scripts">
549    <description>
550     A directory for scripts. By default, when one of these scripts will be executed,
551     the execution of defaultscripts (within .../.defaults/scripts) will be skipped. To execute
552     them nevertheless, the $DONT_SKIP_DEFAULTS environment variable must be set by one of the
553     in-shellcontext scripts (the non-executable ones).
554    </description>
555    
556    <program name="prepre-start">
557     <description>
558      The scriptlet which will be executed before the network-interfaces are enabled
559      and the directories are mounted."
560     </description>
561     <parameterList>
562      <parameter name="vserver-dir">
563       <description>The configuration directory of the current vserver.</description>
564      </parameter>
565      <parameter name="vserver-name">
566       <description>The name of the current vserver.</description>
567      </parameter>
568      <parameter name="action">
569       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
570      </parameter>
571     </parameterList>
572    </program>
573    <collection name="prepre-start.d">
574     <description>
575      Repository of prepre-start like scripts
576     </description>                                                                                                                 
577     <program name="script" type="symbolic">
578       <description>See prepre-start.</description>
579       <parameterList>
580                      <parameter name="vserver-dir">
581                       <description>The configuration directory of the current vserver.</description>
582                      </parameter>
583                      <parameter name="vserver-name">
584                       <description>The name of the current vserver.</description>
585                      </parameter>
586                      <parameter name="action">
587                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
588                      </parameter>
589                     </parameterList>
590     </program>
591    </collection>
592                                                                                                                               
593    <program name="pre-start">
594     <description>
595      The scriptlet which will be executed after network-interfaces were enabled and
596      the directories mounted, but before the vserver itself has been started.
597     </description>
598     <parameterList>
599      <parameter name="vserver-dir">
600       <description>The configuration directory of the current vserver.</description>
601      </parameter>
602      <parameter name="vserver-name">
603       <description>The name of the current vserver.</description>
604      </parameter>
605      <parameter name="action">
606       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
607      </parameter>
608     </parameterList>
609    </program>
610    <collection name="pre-start.d">
611     <description>
612      Repository of pre-start like scripts
613     </description>                                                                                                                 
614     <program name="script" type="symbolic">
615       <description>See pre-start.</description>
616       <parameterList>
617                      <parameter name="vserver-dir">
618                       <description>The configuration directory of the current vserver.</description>
619                      </parameter>
620                      <parameter name="vserver-name">
621                       <description>The name of the current vserver.</description>
622                      </parameter>
623                      <parameter name="action">
624                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
625                      </parameter>
626                     </parameterList>
627     </program>
628    </collection>
629                                                                                                                 
630
631    <program name="post-start">
632     <description>
633      The scriptlet which will be executed after the vserver has been started.
634     </description>
635     <parameterList>
636      <parameter name="vserver-dir">
637       <description>The configuration directory of the current vserver.</description>
638      </parameter>
639      <parameter name="vserver-name">
640       <description>The name of the current vserver.</description>
641      </parameter>
642      <parameter name="action">
643       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
644      </parameter>
645     </parameterList>
646    </program>
647    <collection name="post-start.d">
648     <description>
649      Repository of post-start like scripts
650     </description>                                                                                                                 
651     <program name="script" type="symbolic">
652       <description>See post-start.</description>
653       <parameterList>
654                      <parameter name="vserver-dir">
655                       <description>The configuration directory of the current vserver.</description>
656                      </parameter>
657                      <parameter name="vserver-name">
658                       <description>The name of the current vserver.</description>
659                      </parameter>
660                      <parameter name="action">
661                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
662                      </parameter>
663                     </parameterList>
664     </program>
665    </collection>
666
667
668    <program name="pre-stop">
669     <description>
670      The scriptlet which will be executed before the vserver will be stopped.
671     </description>
672     <parameterList>
673      <parameter name="vserver-dir">
674       <description>The configuration directory of the current vserver.</description>
675      </parameter>
676      <parameter name="vserver-name">
677       <description>The name of the current vserver.</description>
678      </parameter>
679      <parameter name="action">
680       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
681      </parameter>
682     </parameterList>
683    </program>
684    <collection name="pre-stop.d">
685     <description>
686      Repository of pre-stop like scripts
687     </description>                                                                                                                 
688     <program name="script" type="symbolic">
689       <description>See pre-stop.</description>
690       <parameterList>
691                      <parameter name="vserver-dir">
692                       <description>The configuration directory of the current vserver.</description>
693                      </parameter>
694                      <parameter name="vserver-name">
695                       <description>The name of the current vserver.</description>
696                      </parameter>
697                      <parameter name="action">
698                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
699                      </parameter>
700                     </parameterList>
701     </program>
702    </collection>
703
704    <program name="post-stop">
705     <description>
706      The scriptlet which will be executed after the vserver has been stopped, but
707      before the directories will be umounted and the the interfaces
708      disabled.
709     </description>
710     <parameterList>
711      <parameter name="vserver-dir">
712       <description>The configuration directory of the current vserver.</description>
713      </parameter>
714      <parameter name="vserver-name">
715       <description>The name of the current vserver.</description>
716      </parameter>
717      <parameter name="action">
718       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
719      </parameter>
720     </parameterList>
721    </program>
722    <collection name="post-stop.d">
723     <description>
724      Repository of post-stop like scripts
725     </description>                                                                                                                 
726     <program name="script" type="symbolic">
727       <description>See post-stop.</description>
728       <parameterList>
729                      <parameter name="vserver-dir">
730                       <description>The configuration directory of the current vserver.</description>
731                      </parameter>
732                      <parameter name="vserver-name">
733                       <description>The name of the current vserver.</description>
734                      </parameter>
735                      <parameter name="action">
736                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
737                      </parameter>
738                     </parameterList>
739     </program>
740    </collection>
741                                                                                                                               
742    <program name="postpost-stop">
743     <description>
744      The scriptlet which will be executed after the vserver has been stopped
745      completely.
746     </description>
747     <parameterList>
748      <parameter name="vserver-dir">
749       <description>The configuration directory of the current vserver.</description>
750      </parameter>
751      <parameter name="vserver-name">
752       <description>The name of the current vserver.</description>
753      </parameter>
754      <parameter name="action">
755       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
756      </parameter>
757     </parameterList>
758    </program>
759    <collection name="postpost-stop.d">
760     <description>
761      Repository of postpost-stop like scripts
762     </description>                                                                                                                 
763     <program name="script" type="symbolic">
764       <description>See postpost-stop.</description>
765       <parameterList>
766                      <parameter name="vserver-dir">
767                       <description>The configuration directory of the current vserver.</description>
768                      </parameter>
769                      <parameter name="vserver-name">
770                       <description>The name of the current vserver.</description>
771                      </parameter>
772                      <parameter name="action">
773                       <description>The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...).</description>
774                      </parameter>
775                     </parameterList>
776     </program>
777    </collection>
778   </collection>
779   
780   <collection name="interfaces">
781                         <scalar name="bcast">
782                          <description>The default broadcast address.</description>
783                         </scalar>
784                         <scalar name="dev">
785                          <description>The default network device.</description>
786                         </scalar>
787                         <scalar name="prefix">
788                           <description>The default network prefix.</description>
789                         </scalar>
790                         <scalar name="mask">
791                           <description>The default network mask.</description>
792                         </scalar>
793                         <scalar name="scope">
794                           <description>The default scope of the network interfaces.</description>
795                         </scalar>
796                                                                                                                                                   
797                         <collection name="iface" type="symbolic">
798                   <description>
799                    'iface' is an arbitrary name for the interface; the value itself is not important
800                    but may be interesting regarding interface-creation and usage with 'chbind'. Both happens in
801                    alphabetical order and numbers like '00' are good names for these directories.
802                   </description>
803                                                                                                                                           
804                   <boolean name="disabled">
805                     <description>When this file exists, this interface will be ignored.</description>
806                   </boolean>
807                                                                                                                                           
808                   <scalar name="ip">
809                    <description>The ip which will be assigned to this interface.</description>
810                   </scalar>
811                   <scalar name="bcast">
812                    <description>The broadcast address.</description>
813                   </scalar>
814                   <scalar name="dev">
815                    <description>The network device.</description>
816                   </scalar>
817                   <scalar name="prefix">
818                    <description>The network prefix.</description>
819                   </scalar>
820                   <scalar name="mask">
821                    <description>The network mask.</description>
822                   </scalar>
823                   <scalar name="scope">
824                    <description>The scope of the network interface.</description>
825                   </scalar>
826                   <scalar name="name">
827                    <description>
828                     When this file exists, the interface will be named
829                     with the text in this file. Without such an entry,
830                     the IP will not be shown by 'ifconfig' but by 'ip
831                     addr ls' only.  Such a labeled interface is known
832                     as an "alias" also (e.g. 'eth0:foo').
833                    </description>
834                   </scalar>
835                   <boolean name="nodev">
836                    <description>
837                     When this file exists, the interface will be
838                     assumed to exist already. This can be used to
839                     assign primary interfaces which are created by
840                     the host or another vserver.
841                    </description>
842                   </boolean>
843    </collection>
844   </collection>
845   
846   <collection name="ulimits">
847                         <description>
848                          A directory with ulimits. Possible resources are cpu, data, fsize, locks,
849                          memlock, nofile, nproc, rss and/or stack. This configuration will be honored
850                          for kernel 2.4 only.
851                         </description>                                                                                                                 
852                         <scalar name="resource" type="symbolic">
853                           <description>
854                            A file which contains the hard- and soft-limit of the given resource in the
855                            first line. The special keyword 'inf' is recognized.
856                           </description>
857                         </scalar>                                                                            
858                         <scalar name="resource.hard" type="symbolic">
859                           <description>
860                            A file which contains the hard- of the given resource in the first line. The
861                            special keyword 'inf' is recognized.
862                           </description>
863                         </scalar>                                                                                             
864                         <scalar name="resource.soft" type="symbolic">
865                           <description>
866                            A file which contains the soft- of the given resource in the first line. The
867                            special keyword 'inf' is recognized.
868                           </description>
869                         </scalar>
870   </collection>
871  
872   <collection name="rlimits">
873    <description>
874                          A directory with resource limits. Possible resources are cpu, fsize, data, stack,
875                          core, rss, nproc, nofile, memlock, as and locks. This configuration will be honored
876                          for kernel 2.6 only.
877                         </description>                                                                                                                 
878                         <scalar name="resource" type="symbolic">
879                           <description>
880                            A file which contains the hard- and soft-limit of the given resource in the
881                            first line. The special keyword 'inf' is recognized.
882                           </description>
883                         </scalar>                                                                            
884                         <scalar name="resource.hard" type="symbolic">
885                           <description>
886                            A file which contains the hard- of the given resource in the first line. The
887                            special keyword 'inf' is recognized.
888                           </description>
889                         </scalar>                                                                                             
890                         <scalar name="resource.soft" type="symbolic">
891                           <description>
892                            A file which contains the soft- of the given resource in the first line. The
893                            special keyword 'inf' is recognized.
894                           </description>
895                         </scalar>
896                         <scalar name="resource.min" type="symbolic">
897                           <description>
898                            A file which contains the guaranted minimum of the given resource in the first line. The
899                            special keyword 'inf' is recognized.
900                           </description>
901                         </scalar>
902   </collection>
903   
904   <collection name="uts">
905                         <scalar name="context">
906                           <description>
907                            The context-name of the vserver. This file is listed for completeness only;
908                            the 'context' name is used and set internally by the util-vserver tools and can *not* be
909                            modified.
910                           </description>
911                         </scalar>
912                         <scalar name="sysname">
913                          <description>The sysname of the vserver</description>
914                         </scalar>
915                         <scalar name="nodename">
916                          <description>The node-/hostname of the vserver</description>
917                         </scalar>
918                         <scalar name="release">
919                          <description>The OS-release of the vserver</description>
920                         </scalar>
921                         <scalar name="version">
922                          <description>The OS-version of the vserver</description>
923                         </scalar>
924                         <scalar name="machine">
925                          <description>The machine-type of the vserver</description>
926                         </scalar>
927                         <scalar name="domainname">
928                          <description>The NIS domainname of the vserver</description>
929                         </scalar>
930   </collection>
931  </collection>
932 </database>