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