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