util-vserver 0.30.215.
[util-vserver.git] / doc / configuration.html
1 <?xml version="1.0"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml">
4   <head>
5     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6     <title>The /etc/vservers directory</title>
7     <link rel="alternate stylesheet" title="gras" type="text/css" href="css/configuration-lsd.css" />
8     <link rel="alternate stylesheet" title="gras1" type="text/css" href="css/configuration-lsd1.css" />
9     <link rel="alternate stylesheet" title="flower" type="text/css" href="css/configuration-flower.css" />
10     <link rel="alternate stylesheet" title="boring" type="text/css" href="configuration.css" />
11     <link rel="stylesheet" title="weedpage" type="text/css" href="css/WeedPageStyle.css" />
12   </head>
13   <body>
14     <h1>The content of the /etc/vservers directory</h1>
15     <ul>
16       <li>
17         <span class="directory">/etc/vservers/<span class="">.defaults</span></span>
18         <br />
19         <ul>
20           <li>
21             <span class="symlink" title="/etc/vservers/.defaults/cachebase">cachebase</span>
22             <br />
23             <div class="description">
24 A link to the directory which will hold cached information about
25 vservers.
26       </div>
27           </li>
28           <li>
29             <span class="boolean" title="/etc/vservers/.defaults/context.dynamic">context.dynamic</span>
30             <br />
31             <div class="description">
32 If this file exists, kernel-side dynamic contexts will be used by the "vserver
33 ... build" command. Otherwise a context will be generated, based on the
34 contents of <a class="optionref" href="#context.next">context.next</a>.
35       </div>
36           </li>
37           <li id="context.next">
38             <span class="file" title="/etc/vservers/.defaults/context.next">context.next</span>
39             <br />
40             <div class="description">
41 The context id to use for the next guest created by "vserver ... build".
42       </div>
43           </li>
44           <li>
45             <span class="data" title="/etc/vservers/.defaults/fstab">fstab</span>
46             <br />
47             <div class="description">
48 The default fstab file to put in newly built guests.
49       </div>
50           </li>
51           <li id="global-namespace-cleanup-skip">
52             <span class="list" title="/etc/vservers/.defaults/namespace-cleanup-skip">namespace-cleanup-skip</span>
53             <br />
54             <div class="description">
55 List of paths to skip during namespace cleanup.
56       </div>
57           </li>
58           <li id="global-nonamespace">
59             <span class="boolean" title="/etc/vservers/.defaults/nonamespace">nonamespace</span>
60             <br />
61             <div class="description">
62 Disable namespace usage globally. It can be overridden for a single vserver
63 by setting the <a class="optionref" href="#global-namespace">namespace</a> flag
64 there.
65
66 In this mode the <span class="directoryname">/vservers</span> directory must have
67 the 'barrier' attribute. Else, common chroot(2) exploits are possible.
68       </div>
69           </li>
70           <li id="global-nonamespace-cleanup">
71             <span class="boolean" title="/etc/vservers/.defaults/nonamespace-cleanup">nonamespace-cleanup</span>
72             <br />
73             <div class="description">
74 Disable namespace cleanup globally. It can be overridden for a single vserver
75 by setting the <a class="optionref" href="#namespace-cleanup">namespace-cleanup</a> flag
76 there.
77       </div>
78           </li>
79           <li>
80             <span class="symlink" title="/etc/vservers/.defaults/run.rev">run.rev</span>
81             <br />
82             <div class="description">
83 Path of the vserver run reverse directory. This directory contains
84 symlinks named with XID numbers which point back to the configuration
85 directory of vservers. Under kernel 2.4 this is required for the XID
86 to VSERVER mapping; Under kernel 2.6 it is unused.
87
88 NOTE: this link exists in 0.30.202+ only; in previous versions it was
89 a vserver specific setting.
90       </div>
91           </li>
92           <li>
93             <span class="file" title="/etc/vservers/.defaults/shell">shell</span>
94             <br />
95             <div class="description">
96 Contains the pathname of the shell which will be used by the "vserver
97 ... enter" command. Can be overridden by the
98 <a class="optionref" href="#shell">per-guest shell</a>.
99       </div>
100           </li>
101           <li>
102             <span class="symlink" title="/etc/vservers/.defaults/vdirbase">vdirbase</span>
103             <br />
104             <div class="description">A link to the default vserver rootdirectory.</div>
105           </li>
106           <li>
107             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span></span>
108             <br />
109             <ul>
110               <li>
111                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">build</span></span>
112                 <br />
113                 <ul>
114                   <li>
115                     <span class="list" title="/etc/vservers/.defaults/apps/build/options">options</span>
116                     <br />
117                     <div class="description">
118 A list of default options to supply to vserver ... build, one option per line.
119           </div>
120                   </li>
121                 </ul>
122               </li>
123               <li>
124                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">debootstrap</span></span>
125                 <br />
126                 <ul>
127                   <li>
128                     <span class="file" title="/etc/vservers/.defaults/apps/debootstrap/mirror">mirror</span>
129                     <br />
130                     <div class="description">
131 The Debian mirror to use with the <code class="tool">debootstrap</code> program
132           </div>
133                   </li>
134                   <li>
135                     <span class="file" title="/etc/vservers/.defaults/apps/debootstrap/uri">uri</span>
136                     <br />
137                     <div class="description">
138 When the <code class="tool">debootstrap</code> package is not installed; fetch it
139 from this uri and install it at a temporary place.
140           </div>
141                   </li>
142                 </ul>
143               </li>
144               <li>
145                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">init</span></span>
146                 <br />
147                 <ul>
148                   <li id="global-environment">
149                     <span class="hash" title="/etc/vservers/.defaults/apps/init/environment">environment</span>
150                     <br />
151                     <div class="description">
152 The environment to set when starting guests. Contains one VAR=VAL
153 pair per line.
154           </div>
155                   </li>
156                   <li>
157                     <span class="symlink" title="/etc/vservers/.defaults/apps/init/tty">tty</span>
158                     <br />
159                     <div class="description">
160 A symlink to the TTY device where input/output will be redirected from/to
161 at startup via initscript.
162           </div>
163                   </li>
164                 </ul>
165               </li>
166               <li>
167                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">pkgmgmt</span></span>
168                 <br />
169                 <ul>
170                   <li>
171                     <span class="data" title="/etc/vservers/.defaults/apps/pkgmgmt/apt.conf">apt.conf</span>
172                     <br />
173                     <div class="description">The default apt.conf which is going to be used. It is overridden by
174 distribution specific configuration file.
175           </div>
176                   </li>
177                   <li>
178                     <span class="symlink" title="/etc/vservers/.defaults/apps/pkgmgmt/base">base</span>
179                     <br />
180                   </li>
181                 </ul>
182               </li>
183               <li>
184                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vdevmap</span></span>
185                 <br />
186                 <ul>
187                   <li>
188                     <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vdevmap</span>/<span class="sybmolic">x</span></span>
189                     <br />
190                     <div class="description">'x' is an arbitrary name, replace it with e.g. device names</div>
191                     <ul>
192                       <li>
193                         <span class="boolean" title="/etc/vservers/.defaults/apps/vdevmap/x/create">create</span>
194                         <br />
195                         <div class="description">When this file exists, the device can be created (if the guest has <a class="optionref" href="#bcapabilities">CAP_MKNOD</a>)</div>
196                       </li>
197                       <li>
198                         <span class="file" title="/etc/vservers/.defaults/apps/vdevmap/x/device">device</span>
199                         <br />
200                         <div class="description">Contains the name of a device node</div>
201                       </li>
202                       <li>
203                         <span class="file" title="/etc/vservers/.defaults/apps/vdevmap/x/flags">flags</span>
204                         <br />
205                         <div class="description">This file will let you specify unimplemented flags manually</div>
206                       </li>
207                       <li>
208                         <span class="boolean" title="/etc/vservers/.defaults/apps/vdevmap/x/open">open</span>
209                         <br />
210                         <div class="description">When this file exists, the device can be opened</div>
211                       </li>
212                       <li id="vdevmap-remap">
213                         <span class="boolean" title="/etc/vservers/.defaults/apps/vdevmap/x/remap">remap</span>
214                         <br />
215                         <div class="description">
216 When this file exists, <a class="optionref" href="#vdevmap-target">target</a> will
217 have to exist as well and opening the device will in fact open the target device
218             </div>
219                       </li>
220                       <li id="vdevmap-target">
221                         <span class="file" title="/etc/vservers/.defaults/apps/vdevmap/x/target">target</span>
222                         <br />
223                         <div class="description">Contains the device node of the target node to open instead of the device when <a class="optionref" href="#vdevmap-remap">remap</a> is set</div>
224                       </li>
225                     </ul>
226                   </li>
227                 </ul>
228               </li>
229               <li>
230                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vlogin</span></span>
231                 <br />
232                 <ul>
233                   <li id="vlogin-disable">
234                     <span class="boolean" title="/etc/vservers/.defaults/apps/vlogin/disable">disable</span>
235                     <br />
236                     <div class="description">
237 When this file exists, vlogin isn't used on vserver &lt;guest&gt; enter.
238           </div>
239                   </li>
240                 </ul>
241               </li>
242               <li>
243                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vprocunhide</span></span>
244                 <br />
245                 <ul>
246                   <li>
247                     <span class="list" title="/etc/vservers/.defaults/apps/vprocunhide/files">files</span>
248                     <br />
249                     <div class="description">
250 A list of files which will be made visible by vprocunhide. Wildcards are
251 allowed and anything ending in '/' will be processed recursively. When this file exists,
252 it overrides the defaults in SYSDEFAULTDIR/vprocunhide-files. The entries there must be
253 absolute filenames inclusive the leading '/proc'.
254           </div>
255                   </li>
256                 </ul>
257               </li>
258               <li>
259                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vshelper</span></span>
260                 <br />
261                 <ul>
262                   <li>
263                     <span class="boolean" title="/etc/vservers/.defaults/apps/vshelper/debug">debug</span>
264                     <br />
265                     <div class="description">
266 When existing, the vshelper execution will be traced.
267           </div>
268                   </li>
269                   <li>
270                     <span class="boolean" title="/etc/vservers/.defaults/apps/vshelper/disabled">disabled</span>
271                     <br />
272                     <div class="description">
273 When existing, the vshelper functionality will be disabled for all
274 vservers.
275           </div>
276                   </li>
277                   <li>
278                     <span class="symlink" title="/etc/vservers/.defaults/apps/vshelper/logfile">logfile</span>
279                     <br />
280                     <div class="description">
281 The file where output will be logged to when <code class="tool">vshelper</code>
282 is invoked from the kernel. This should point somewhere e.g. into
283 <span class="directoryname">/var/log</span>.
284           </div>
285                   </li>
286                   <li>
287                     <span class="boolean" title="/etc/vservers/.defaults/apps/vshelper/warning-disabled">warning-disabled</span>
288                     <br />
289                     <div class="description">
290 When existing, sanity checks for the vshelper functionality will be
291 skipped.
292           </div>
293                   </li>
294                   <li>
295                     <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vshelper</span>/<span class="">vshelper-methods</span></span>
296                     <br />
297                     <ul>
298                       <li>
299                         <span class="script" title="/etc/vservers/.defaults/apps/vshelper/vshelper-methods/$handler">handler</span>
300                         <br />
301                         <div class="description">
302 See <a class="optionref" href="#vshelper-action">vshelper/action</a>.
303             </div>
304                       </li>
305                     </ul>
306                   </li>
307                 </ul>
308               </li>
309               <li>
310                 <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vunify</span></span>
311                 <br />
312                 <ul>
313                   <li>
314                     <span class="list" title="/etc/vservers/.defaults/apps/vunify/exclude">exclude</span>
315                     <br />
316                     <div class="description">Static list of excluded files.</div>
317                   </li>
318                   <li>
319                     <span class="boolean" title="/etc/vservers/.defaults/apps/vunify/pgkmgmt-force">pgkmgmt-force</span>
320                     <br />
321                     <div class="description">
322 When existing, information from packagemanagement will be used to
323 create dynamic exclude-lists. This option requires that (a known)
324 packagemanagement is configured for the vserver; else the requested
325 operation will fail. Most tools assume 'on' as the default value.
326           </div>
327                   </li>
328                   <li>
329                     <span class="boolean" title="/etc/vservers/.defaults/apps/vunify/pkgmgmt-ignore">pkgmgmt-ignore</span>
330                     <br />
331                     <div class="description">
332 When existing, information from packagemanagement will not be used to
333 create dynamic exclude-lists.
334           </div>
335                   </li>
336                   <li>
337                     <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">apps</span>/<span class="">vunify</span>/<span class="">hash</span></span>
338                     <br />
339                     <div class="description">
340 A directory which will be used as the storage place for the
341 <code class="tool">vhashify</code> command.
342           </div>
343                     <ul>
344                       <li>
345                         <span class="symlink" title="/etc/vservers/.defaults/apps/vunify/hash/$id">id</span>
346                         <br />
347                         <div class="description">
348 Points to a directory within the filesystems which are used for the
349 vservers. There must be not more than one of such a directory per
350 filesystem.
351             </div>
352                       </li>
353                       <li>
354                         <span class="file" title="/etc/vservers/.defaults/apps/vunify/hash/method">method</span>
355                         <br />
356                         <div class="description">The used hash method.</div>
357                       </li>
358                     </ul>
359                   </li>
360                 </ul>
361               </li>
362             </ul>
363           </li>
364           <li>
365             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">files</span></span>
366             <br />
367             <div class="description">This directory contains some files which will be copied to the guests during build.</div>
368             <ul>
369               <li>
370                 <span class="data" title="/etc/vservers/.defaults/files/hosts">hosts</span>
371                 <br />
372                 <div class="description">The default /etc/hosts file.</div>
373               </li>
374               <li>
375                 <span class="data" title="/etc/vservers/.defaults/files/krb.conf">krb.conf</span>
376                 <br />
377                 <div class="description">The default /etc/krb.conf file.</div>
378               </li>
379               <li>
380                 <span class="data" title="/etc/vservers/.defaults/files/krb.realms">krb.realms</span>
381                 <br />
382                 <div class="description">The default /etc/krb.realms file.</div>
383               </li>
384               <li>
385                 <span class="data" title="/etc/vservers/.defaults/files/krb5.conf">krb5.conf</span>
386                 <br />
387                 <div class="description">The default /etc/krb5.conf file.</div>
388               </li>
389               <li>
390                 <span class="data" title="/etc/vservers/.defaults/files/ldap.conf">ldap.conf</span>
391                 <br />
392                 <div class="description">The default /etc/ldap.conf file.</div>
393               </li>
394               <li>
395                 <span class="data" title="/etc/vservers/.defaults/files/localtime">localtime</span>
396                 <br />
397                 <div class="description">The default /etc/localtime file.</div>
398               </li>
399               <li>
400                 <span class="data" title="/etc/vservers/.defaults/files/nsswitch.conf">nsswitch.conf</span>
401                 <br />
402                 <div class="description">The default /etc/nsswitch.conf file.</div>
403               </li>
404               <li>
405                 <span class="data" title="/etc/vservers/.defaults/files/resolv.conf">resolv.conf</span>
406                 <br />
407                 <div class="description">The default /etc/resolv.conf file.</div>
408               </li>
409             </ul>
410           </li>
411           <li>
412             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="fixed">init</span></span>
413             <br />
414             <ul>
415               <li>
416                 <span class="data" title="/etc/vservers/.defaults/init/mtab">mtab</span>
417                 <br />
418                 <div class="description">Default mtab file</div>
419               </li>
420             </ul>
421           </li>
422           <li>
423             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">interfaces</span></span>
424             <br />
425             <ul>
426               <li id="global-vlandev">
427                 <span class="boolean" title="/etc/vservers/.defaults/interfaces/vlandev">vlandev</span>
428                 <br />
429                 <div class="description">
430 When this file exists, the steps which setup and destroy a VLAN
431 interface will be executed.
432         </div>
433               </li>
434             </ul>
435           </li>
436         </ul>
437       </li>
438       <li>
439         <span class="directory">/etc/vservers/<span class="">.distributions</span></span>
440         <br />
441         <ul>
442           <li>
443             <span class="symlink" title="/etc/vservers/.distributions/template">template</span>
444             <br />
445             <div class="description">
446 Symlink to the default template for this distribution.
447       </div>
448           </li>
449           <li>
450             <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span></span>
451             <br />
452             <ul>
453               <li>
454                 <span class="data" title="/etc/vservers/.distributions/$dist/apt.conf">apt.conf</span>
455                 <br />
456                 <div class="description">
457 The default apt.conf which is going to be used. It overrides the
458 apt.conf from CONFDIR/.defaults/apps/pkgmgmt.
459         </div>
460               </li>
461               <li>
462                 <span class="file" title="/etc/vservers/.distributions/$dist/dev">dev</span>
463                 <br />
464                 <div class="description"></div>
465               </li>
466               <li>
467                 <span class="symlink" title="/etc/vservers/.distributions/$dist/execdir">execdir</span>
468                 <br />
469                 <div class="description">
470 Directory with all executables and libraries which are required for
471 this distribution.
472         </div>
473               </li>
474               <li>
475                 <span class="script" title="/etc/vservers/.distributions/$dist/initpost">initpost</span>
476                 <br />
477                 <div class="description">
478 Script which will be executed after packages are installed.
479           </div>
480               </li>
481               <li>
482                 <span class="script" title="/etc/vservers/.distributions/$dist/initpre">initpre</span>
483                 <br />
484                 <div class="description">
485 Script which will be executed before packages will be installed.
486           </div>
487               </li>
488               <li>
489                 <span class="symlink" title="/etc/vservers/.distributions/$dist/rpmlib">rpmlib</span>
490                 <br />
491                 <div class="description">
492 Directory which overrides <span class="directoryname">/usr/lib/rpm</span>.
493         </div>
494               </li>
495               <li>
496                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">apt</span></span>
497                 <br />
498                 <div class="description">
499 Default content of the <span class="directoryname">/etc/apt/</span> directory.
500         </div>
501               </li>
502               <li>
503                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">pkgs</span></span>
504                 <br />
505                 <div class="description">
506 Contains files with packagenames.
507         </div>
508                 <ul>
509                   <li>
510                     <span class="list" title="/etc/vservers/.distributions/$dist/pkgs/list">list</span>
511                     <br />
512                     <div class="description">
513 File which contains the name of packages. On top of file the special
514 keywords '--reinstall' and '--can-fail' are possible.
515           </div>
516                   </li>
517                 </ul>
518               </li>
519               <li>
520                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">pubkeys</span></span>
521                 <br />
522                 <div class="description">
523 Directory with GPG pubkeys which are used to sign the packages of this
524 distribution.
525         </div>
526               </li>
527               <li>
528                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">rpm</span></span>
529                 <br />
530                 <div class="description">
531 Default content of the <span class="directoryname">/etc/rpm</span> directory.
532         </div>
533               </li>
534               <li>
535                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">yum</span></span>
536                 <br />
537                 <div class="description">
538 The default, yum-related content of the <span class="directoryname">/etc</span>
539 directory.
540         </div>
541                 <ul>
542                   <li>
543                     <span class="file" title="/etc/vservers/.distributions/$dist/yum/yum.conf">yum.conf</span>
544                     <br />
545                     <div class="description">
546 The master yum configuration file. It supports the @YUMETCDIR@,
547 @YUMCACHEDIR@ and @YUMLOGDIR@ placeholder which will be replaced at
548 <code class="command">vserver ... build</code> time.
549           </div>
550                   </li>
551                 </ul>
552               </li>
553               <li>
554                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">yum.repos.d</span></span>
555                 <br />
556                 <div class="description">A directory with yum repositories.</div>
557               </li>
558             </ul>
559           </li>
560         </ul>
561       </li>
562       <li>
563         <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span></span>
564         <br />
565         <div class="description">
566 The configuration directory for the vserver vserver-name.
567     </div>
568         <ul>
569           <li>
570             <span class="file" title="/etc/vservers/$vserver-name/badness">badness</span>
571             <br />
572             <div class="description">
573 Contains the bias to be applied to processes in this guest when the OOM-killer strikes.
574       </div>
575           </li>
576           <li id="bcapabilities">
577             <span class="list" title="/etc/vservers/$vserver-name/bcapabilities">bcapabilities</span>
578             <br />
579             <div class="description">
580 Contains the system capabilities. See
581 <a href="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/bcaps-v13.c">lib/bcaps-v13.c</a>
582 for possible values.
583       </div>
584           </li>
585           <li>
586             <span class="symlink" title="/etc/vservers/$vserver-name/cache">cache</span>
587             <br />
588             <div class="description">
589 Path of the storage area for cached information about this vserver.
590       </div>
591           </li>
592           <li>
593             <span class="list" title="/etc/vservers/$vserver-name/capabilities">capabilities</span>
594             <br />
595             <div class="description">
596 Contains per line a capability. This file is used for the 2.4 kernel
597 only; for 2.6 use <a class="optionref" href="#bcapabilities">bcapabilities</a>.
598       </div>
599           </li>
600           <li>
601             <span class="list" title="/etc/vservers/$vserver-name/ccapabilities">ccapabilities</span>
602             <br />
603             <div class="description">
604 Contains the context capabilities. See <a href="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/ccaps-v13.c">lib/ccaps-v13.c</a>
605 for possible values.
606       </div>
607           </li>
608           <li>
609             <span class="file" title="/etc/vservers/$vserver-name/context">context</span>
610             <br />
611             <div class="description">
612 Contains the context id which shall be used for the vserver. Valid range is 2 through 49151.
613         </div>
614           </li>
615           <li>
616             <span class="list" title="/etc/vservers/$vserver-name/flags">flags</span>
617             <br />
618             <div class="description">
619 Contains per line a flag. See <a href="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/cflags-v13.c">lib/cflags-v13.c</a>
620 for possible values.
621       </div>
622           </li>
623           <li id="fstab">
624             <span class="data" title="/etc/vservers/$vserver-name/fstab">fstab</span>
625             <br />
626             <div class="description">
627 The fstab file for the vserver. Entries in this file will be mounted
628 within the network context of the host. Use the
629 <a class="optionref" href="#fstab.remote">fstab.remote</a> file when you want that the
630 mounting happens in the network context of the vserver. In most cases
631 the 'fstab' file should be used.
632       </div>
633           </li>
634           <li id="fstab.remote">
635             <span class="data" title="/etc/vservers/$vserver-name/fstab.remote">fstab.remote</span>
636             <br />
637             <div class="description">
638 The fstab file for the vserver. Entries in this file will be mounted
639 within the network context of the guest; this means that mount will be
640 called as <code class="command">chbind &lt;options&gt; mount ...</code>. See
641 <a class="optionref" href="#fstab">fstab</a> also.
642       </div>
643           </li>
644           <li>
645             <span class="file" title="/etc/vservers/$vserver-name/name">name</span>
646             <br />
647             <div class="description">
648 Contains the name of the vserver. When not given, the basename of the directory
649 will be assumed as this name.
650       </div>
651           </li>
652           <li id="global-namespace">
653             <span class="boolean" title="/etc/vservers/$vserver-name/namespace">namespace</span>
654             <br />
655             <div class="description">
656 Overrides the global <a class="optionref" href="#global-nonamespace">nonamespace</a> flag and enables
657 namespace usage for the current vserver.
658       </div>
659           </li>
660           <li id="namespace-cleanup">
661             <span class="boolean" title="/etc/vservers/$vserver-name/namespace-cleanup">namespace-cleanup</span>
662             <br />
663             <div class="description">
664 Overrides the global <a class="optionref" href="#global-nonamespace-cleanup">nonamespace-cleanup</a> flag and enables
665 namespace cleanup for the current vserver.
666       </div>
667           </li>
668           <li>
669             <span class="list" title="/etc/vservers/$vserver-name/namespace-cleanup-skip">namespace-cleanup-skip</span>
670             <br />
671             <div class="description">
672 List of paths to skip during namespace cleanup. This overrides the global
673 <a class="optionref" href="#global-namespace-cleanup-skip">namespace-cleanup-skip</a>
674 file.
675       </div>
676           </li>
677           <li>
678             <span class="list" title="/etc/vservers/$vserver-name/ncapabilities">ncapabilities</span>
679             <br />
680             <div class="description">
681 Contains the network capabilities. See <a href="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/ncaps-net.c">lib/ncaps-net.c</a>
682 for possible values.
683       </div>
684           </li>
685           <li>
686             <span class="file" title="/etc/vservers/$vserver-name/ncontext">ncontext</span>
687             <br />
688             <div class="description">
689 Contains the network context id which shall be used for the vserver. Valid range is 2 through 49151.
690       </div>
691           </li>
692           <li>
693             <span class="list" title="/etc/vservers/$vserver-name/nflags">nflags</span>
694             <br />
695             <div class="description">
696 Contains a network flag per line. See <a href="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/nflags-net.c">lib/nflags-net.c</a>
697 for possible values.
698       </div>
699           </li>
700           <li>
701             <span class="file" title="/etc/vservers/$vserver-name/nice">nice</span>
702             <br />
703             <div class="description">
704 The nice-level on which the vserver will be started.
705       </div>
706           </li>
707           <li>
708             <span class="boolean" title="/etc/vservers/$vserver-name/nonamespace">nonamespace</span>
709             <br />
710             <div class="description">
711 Disables namespace usage for the current vserver.
712
713 In this mode the <span class="directoryname">/vservers</span> directory must have
714 the 'barrier' attribute. Else, common chroot(2) exploits are possible.
715       </div>
716           </li>
717           <li>
718             <span class="list" title="/etc/vservers/$vserver-name/personality">personality</span>
719             <br />
720             <div class="description">
721 Used to set the personality of the vserver. First line in the file
722 is the personality-type followed by flags (one item per line). See
723 <a class="filename" href="file:///usr/include/linux/personality.h">/usr/include/linux/personality.h</a> for possible
724 values.
725       </div>
726           </li>
727           <li>
728             <span class="symlink" title="/etc/vservers/$vserver-name/run">run</span>
729             <br />
730             <div class="description">
731 Points to a file which will contain the XID of the running vserver. When
732 the vserver is stopped, this can be a dangling symlink.
733       </div>
734           </li>
735           <li>
736             <span class="hash" title="/etc/vservers/$vserver-name/schedule">schedule</span>
737             <br />
738             <div class="description">
739 [deprecated; use <a class="optionref" href="#sched">sched</a> instead] Contains the
740 scheduler parameters, one per line.
741
742 The Hard CPU limit uses a mechanism called a Token Bucket.  the
743 concept is simple: you have a bucket of a certain size which is
744 filled with a specified amount R of tokens each interval T until the
745 maximum is reached (excess tokens are spilled). At each timer tick,
746 a running process consumes one token from the bucket, unless the
747 bucket is empty. If the bucket is empty the process is put in the
748 hold queue. When the bucket has been refilled to at least M tokens,
749 all on hold processes are rescheduled.
750
751 See the <a href="http://linux-vserver.org/Scheduler+Parameters">Linux
752 VServer Wiki</a> for more information about this file.
753       </div>
754           </li>
755           <li id="shell">
756             <span class="file" title="/etc/vservers/$vserver-name/shell">shell</span>
757             <br />
758             <div class="description">
759 Contains the pathname of the shell which will be used by the "vserver
760 ... enter" command.
761       </div>
762           </li>
763           <li>
764             <span class="file" title="/etc/vservers/$vserver-name/tag">tag</span>
765             <br />
766             <div class="description">
767 Contains the filesystem tag which shall be used for the vserver. Valid range is 2 through 49151.
768       </div>
769           </li>
770           <li>
771             <span class="symlink" title="/etc/vservers/$vserver-name/vdir">vdir</span>
772             <br />
773             <div class="description">
774 Path of the vserver root directory.
775       </div>
776           </li>
777           <li>
778             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span></span>
779             <br />
780             <ul>
781               <li>
782                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">init</span></span>
783                 <br />
784                 <ul>
785                   <li>
786                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.prepare">cmd.prepare</span>
787                     <br />
788                     <div class="description">
789 The command which is used to setup the init-system (e.g. to set the
790 runlevel in the utmp-file). Each option must be on a separate line.
791           </div>
792                   </li>
793                   <li>
794                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.start">cmd.start</span>
795                     <br />
796                     <div class="description">
797 The command which is used to start the vserver. Each option must be on
798 a separate line.
799           </div>
800                   </li>
801                   <li>
802                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.start-sync">cmd.start-sync</span>
803                     <br />
804                     <div class="description">
805 The command which is used to wait on the vserver after it has been
806 started. Each option must be on a separate line. This file will be
807 ignored when the <a class="optionref" href="#sync">sync</a> flag does not exist and the
808 '--sync' option was not used.
809           </div>
810                   </li>
811                   <li>
812                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.stop">cmd.stop</span>
813                     <br />
814                     <div class="description">
815 The command which is used to stop the vserver. Each option must be on
816 a separate line.
817           </div>
818                   </li>
819                   <li>
820                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.stop-sync">cmd.stop-sync</span>
821                     <br />
822                     <div class="description">
823 The command which is used to wait on the vserver after it has been
824 stopped. Each option must be on a separate line. This file will be
825 ignored when the <a class="optionref" href="#sync">sync</a> flag does not exist and the
826 '--sync' option was not used.
827           </div>
828                   </li>
829                   <li>
830                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/depends">depends</span>
831                     <br />
832                     <div class="description">
833 This file is used to configure vservers which must be running before
834 the current vserver can be started. At shutdown, the current vserver
835 will be stopped before its dependencies. Content of this file are
836 vserver ids (one name per line).
837           </div>
838                   </li>
839                   <li>
840                     <span class="hash" title="/etc/vservers/$vserver-name/apps/init/environment">environment</span>
841                     <br />
842                     <div class="description">
843 The environment to set when starting the guest. Contains one VAR=VAL
844 pair per line.
845           </div>
846                   </li>
847                   <li>
848                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/killseq">killseq</span>
849                     <br />
850                     <div class="description">
851 Contains the 'signal [wait signal]*' sequence which is used to stop
852 the vserver.
853           </div>
854                   </li>
855                   <li>
856                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/mark">mark</span>
857                     <br />
858                     <div class="description">
859 This file is used to mark group of vservers which shall be started/stopped
860 together by the initscript. Content is a simple string like 'default'.
861           </div>
862                   </li>
863                   <li>
864                     <span class="data" title="/etc/vservers/$vserver-name/apps/init/mtab">mtab</span>
865                     <br />
866                     <div class="description">
867 The initial-mtab which will be used for the vserver.
868           </div>
869                   </li>
870                   <li>
871                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/runlevel">runlevel</span>
872                     <br />
873                     <div class="description">The start runlevel.</div>
874                   </li>
875                   <li>
876                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/runlevel.start">runlevel.start</span>
877                     <br />
878                     <div class="description">The start runlevel.</div>
879                   </li>
880                   <li>
881                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/runlevel.stop">runlevel.stop</span>
882                     <br />
883                     <div class="description">The stop runlevel.</div>
884                   </li>
885                   <li>
886                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/style">style</span>
887                     <br />
888                     <div class="description">
889 Contains the init-style.
890           </div>
891                   </li>
892                   <li id="sync">
893                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/init/sync">sync</span>
894                     <br />
895                     <div class="description">
896 If this file is not present, all 'cmd.*-sync files will be ignored.
897             </div>
898                   </li>
899                   <li>
900                     <span class="symlink" title="/etc/vservers/$vserver-name/apps/init/tty">tty</span>
901                     <br />
902                     <div class="description">
903 A symlink to the TTY device where input/output will be redirected
904 from/to at startup via initscript.
905           </div>
906                   </li>
907                 </ul>
908               </li>
909               <li>
910                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vdevmap</span></span>
911                 <br />
912                 <ul>
913                   <li>
914                     <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vdevmap</span>/<span class="sybmolic">x</span></span>
915                     <br />
916                     <div class="description">'x' is an arbitrary name, replace it with e.g. device names</div>
917                     <ul>
918                       <li>
919                         <span class="boolean" title="/etc/vservers/$vserver-name/apps/vdevmap/x/create">create</span>
920                         <br />
921                         <div class="description">When this file exists, the device can be created (if the guest has <a class="optionref" href="#bcapabilities">CAP_MKNOD</a>)</div>
922                       </li>
923                       <li>
924                         <span class="file" title="/etc/vservers/$vserver-name/apps/vdevmap/x/device">device</span>
925                         <br />
926                         <div class="description">Contains the name of a device node</div>
927                       </li>
928                       <li>
929                         <span class="file" title="/etc/vservers/$vserver-name/apps/vdevmap/x/flags">flags</span>
930                         <br />
931                         <div class="description">This file will let you specify unimplemented flags manually</div>
932                       </li>
933                       <li>
934                         <span class="boolean" title="/etc/vservers/$vserver-name/apps/vdevmap/x/open">open</span>
935                         <br />
936                         <div class="description">When this file exists, the device can be opened</div>
937                       </li>
938                       <li id="guest-vdevmap-remap">
939                         <span class="boolean" title="/etc/vservers/$vserver-name/apps/vdevmap/x/remap">remap</span>
940                         <br />
941                         <div class="description">
942 When this file exists, <a class="optionref" href="#guest-vdevmap-target">target</a> will
943 have to exist as well and opening the device will in fact open the target device
944             </div>
945                       </li>
946                       <li id="guest-vdevmap-target">
947                         <span class="file" title="/etc/vservers/$vserver-name/apps/vdevmap/x/target">target</span>
948                         <br />
949                         <div class="description">Contains the device node of the target node to open instead of the device when <a class="optionref" href="#guest-vdevmap-remap">remap</a> is set</div>
950                       </li>
951                     </ul>
952                   </li>
953                 </ul>
954               </li>
955               <li>
956                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vshelper</span></span>
957                 <br />
958                 <ul>
959                   <li id="vshelper-action">
960                     <span class="file" title="/etc/vservers/$vserver-name/apps/vshelper/action">action</span>
961                     <br />
962                     <div class="description">
963 The action which is going to be executed when a vshelper event
964 occurs. The default value is 'restart', but there can be defined own
965 methods by placing scripts into the
966 <a class="optionref" href="#vshelper-methods">vshelper-methods</a> directories. These scripts are
967 fed with the same arguments as the <code class="tool">vshelper</code> script.
968           </div>
969                   </li>
970                   <li>
971                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vshelper/debug">debug</span>
972                     <br />
973                     <div class="description">
974 When existing, the vshelper execution will be traced for this vserver.
975           </div>
976                   </li>
977                   <li>
978                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vshelper/disabled">disabled</span>
979                     <br />
980                     <div class="description">
981 When existing, the vshelper functionality will be disabled for this
982 vserver.
983           </div>
984                   </li>
985                   <li>
986                     <span class="script" title="/etc/vservers/$vserver-name/apps/vshelper/$event">event</span>
987                     <br />
988                     <div class="description">
989 When existing, these scripts will be executed *instead* of the default
990 handler defined in 'action'. Their name must match the event which caused
991 the execution of <code class="tool">vshelper</code>; e.g. 'restart' or 'poweroff'. See
992 the vs_reboot() function in the kernel for more details.
993           </div>
994                   </li>
995                   <li>
996                     <span class="file" title="/etc/vservers/$vserver-name/apps/vshelper/sync-timeout">sync-timeout</span>
997                     <br />
998                     <div class="description">
999 The timeout in seconds which is used when synchronising vserver
1000 startup/shutdown with the vshelper. When not set, 30 seconds will be
1001 assumed.
1002           </div>
1003                   </li>
1004                   <li>
1005                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vshelper/warning-disabled">warning-disabled</span>
1006                     <br />
1007                     <div class="description">
1008 When existing, sanity checks for the vshelper functionality will be
1009 skipped.
1010           </div>
1011                   </li>
1012                 </ul>
1013               </li>
1014               <li id="vshelper-methods">
1015                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vshelper-methods</span></span>
1016                 <br />
1017                 <ul id="vshelper-methods">
1018                   <li>
1019                     <span class="script" title="/etc/vservers/$vserver-name/apps/vshelper-methods/$handler">handler</span>
1020                     <br />
1021                     <div class="description">
1022 See <a class="optionref" href="#vshelper-action">vshelper/action</a>.
1023           </div>
1024                   </li>
1025                 </ul>
1026               </li>
1027               <li>
1028                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vunify</span></span>
1029                 <br />
1030                 <div class="description">
1031 This directory contains configuration data required for vserver
1032 unification.
1033         </div>
1034                 <ul>
1035                   <li>
1036                     <span class="list" title="/etc/vservers/$vserver-name/apps/vunify/exclude">exclude</span>
1037                     <br />
1038                     <div class="description">
1039 <div>Static list of files which are excluded for unification. This list
1040 supports an rsync-like syntax: when a file is prefixed by '+', it is a
1041 candidate for unification; when there is no prefix or a '-' or a '~' it
1042 will be excluded. Shell-wildcards are allowed for the filenames.</div>
1043 <div>When used with <code class="tool">vcopy</code>, the '~' prefix prevents copying
1044 of the file entirely (e.g. for keyfiles). With this tool, the file will
1045 be copied instead of hardlinked when the '-' prefix is used.</div>
1046           </div>
1047                   </li>
1048                   <li>
1049                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vunify/pgkmgmt-force">pgkmgmt-force</span>
1050                     <br />
1051                     <div class="description">
1052 When existing, information from packagemanagement will be used to
1053 create dynamic exclude-lists. This option requires that (a known)
1054 packagemanagement is configured for the vserver; else the requested
1055 operation will fail. Most tools assume 'on' as the default value.
1056           </div>
1057                   </li>
1058                   <li>
1059                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vunify/pkgmgmt-ignore">pkgmgmt-ignore</span>
1060                     <br />
1061                     <div class="description">
1062 When existing, information from packagemanagement will not be used to
1063 create dynamic exclude-lists.
1064           </div>
1065                   </li>
1066                   <li>
1067                     <span class="symlink" title="/etc/vservers/$vserver-name/apps/vunify/$refserver.X">refserver.X</span>
1068                     <br />
1069                     <div class="description">
1070 These are symlinks to the configuration directory
1071 (e.g. CONFDIR/vservers/&lt;id&gt;) of a refserver. There may be
1072 multiple such symlinks but they must be prefixed by 'refserver.' and
1073 will be processed in alphanumerical order.
1074           </div>
1075                   </li>
1076                   <li>
1077                     <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vunify</span>/<span class="">hash</span></span>
1078                     <br />
1079                     <div class="description">
1080 A directory which will be used as the storage place for the
1081 <code class="tool">vhashify</code> command.
1082           </div>
1083                     <ul>
1084                       <li>
1085                         <span class="symlink" title="/etc/vservers/$vserver-name/apps/vunify/hash/$id">id</span>
1086                         <br />
1087                         <div class="description">
1088 Points to a directory within the filesystems which are used for the
1089 vservers. There must be not more than one of such a directory per
1090 filesystem.
1091             </div>
1092                       </li>
1093                       <li>
1094                         <span class="file" title="/etc/vservers/$vserver-name/apps/vunify/hash/method">method</span>
1095                         <br />
1096                         <div class="description">The used hash method.</div>
1097                       </li>
1098                     </ul>
1099                   </li>
1100                 </ul>
1101               </li>
1102             </ul>
1103           </li>
1104           <li>
1105             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">cpuset</span></span>
1106             <br />
1107             <div class="description">
1108 Puts the guest in a cpuset. Required entries are name, cpus and mems.
1109       </div>
1110             <ul>
1111               <li>
1112                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/cpu_exclusive">cpu_exclusive</span>
1113                 <br />
1114                 <div class="description">Is the CPU assignment exclusive?</div>
1115               </li>
1116               <li>
1117                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/cpus">cpus</span>
1118                 <br />
1119                 <div class="description">The list of CPUs in this cpuset</div>
1120               </li>
1121               <li>
1122                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/mems">mems</span>
1123                 <br />
1124                 <div class="description">The list of Memory Nodes in this cpuset</div>
1125               </li>
1126               <li>
1127                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/mems_exclusive">mems_exclusive</span>
1128                 <br />
1129                 <div class="description">Is the memory node assignment exclusive?</div>
1130               </li>
1131               <li>
1132                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/name">name</span>
1133                 <br />
1134                 <div class="description">The name of the cpuset for this vserver</div>
1135               </li>
1136               <li>
1137                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/nocreate">nocreate</span>
1138                 <br />
1139                 <div class="description">When this file exists, the cpuset will be assumed to exist already</div>
1140               </li>
1141             </ul>
1142           </li>
1143           <li>
1144             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">dlimits</span></span>
1145             <br />
1146             <div class="description">
1147 Note that all entries are required for the disk limit to be applied.
1148       </div>
1149             <ul>
1150               <li>
1151                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">dlimits</span>/<span class="symbolic">x</span></span>
1152                 <br />
1153                 <div class="description">'x' is an arbitrary name, replace it with e.g. integers</div>
1154                 <ul>
1155                   <li>
1156                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/directory">directory</span>
1157                     <br />
1158                     <div class="description">The directory to which the limit should be applied</div>
1159                   </li>
1160                   <li>
1161                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/inodes_total">inodes_total</span>
1162                     <br />
1163                     <div class="description">The amount of inodes this vserver should be limited to</div>
1164                   </li>
1165                   <li>
1166                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/reserved">reserved</span>
1167                     <br />
1168                     <div class="description">How much space (percentage-wise) should be reserved for the root user</div>
1169                   </li>
1170                   <li>
1171                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/space_total">space_total</span>
1172                     <br />
1173                     <div class="description">The amount of space this vserver should be limited to (measured in blocks of 1024 bytes)</div>
1174                   </li>
1175                 </ul>
1176               </li>
1177             </ul>
1178           </li>
1179           <li>
1180             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">interfaces</span></span>
1181             <br />
1182             <ul>
1183               <li>
1184                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/bcast">bcast</span>
1185                 <br />
1186                 <div class="description">The guest's broadcast address.</div>
1187               </li>
1188               <li>
1189                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/dev">dev</span>
1190                 <br />
1191                 <div class="description">The default network device. See <a class="optionref" href="#per-if-dev">iface/dev</a> for more information.</div>
1192               </li>
1193               <li>
1194                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/lback">lback</span>
1195                 <br />
1196                 <div class="description">The guest's loopback address.</div>
1197               </li>
1198               <li>
1199                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/mask">mask</span>
1200                 <br />
1201                 <div class="description">The default network mask.</div>
1202               </li>
1203               <li id="local-novlandev">
1204                 <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/novlandev">novlandev</span>
1205                 <br />
1206                 <div class="description">
1207 When this file exists, the steps which setup and destroy a VLAN
1208 interface will be skipped. This overrides the global
1209 <a class="optionref" href="#global-vlandev">vlandev</a> setting for
1210 this vserver.
1211         </div>
1212               </li>
1213               <li>
1214                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/prefix">prefix</span>
1215                 <br />
1216                 <div class="description">The default network prefix-length.</div>
1217               </li>
1218               <li>
1219                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/scope">scope</span>
1220                 <br />
1221                 <div class="description">The default scope of the network interfaces.</div>
1222               </li>
1223               <li id="local-vlandev">
1224                 <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/vlandev">vlandev</span>
1225                 <br />
1226                 <div class="description">
1227 When this file exists, the steps which setup and destroy a VLAN
1228 interface will be executed for all interfaces of this vserver.
1229         </div>
1230               </li>
1231               <li>
1232                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">interfaces</span>/<span class="symbolic">iface</span></span>
1233                 <br />
1234                 <div class="description">
1235 'iface' is an arbitrary name for the interface; the value itself is
1236 not important but may be interesting regarding interface-creation and
1237 usage with <code class="tool">chbind</code>. Both happens in alphabetical order and
1238 numbers like '00' are good names for these directories.
1239         </div>
1240                 <ul>
1241                   <li id="per-if-dev">
1242                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/dev">dev</span>
1243                     <br />
1244                     <div class="description">The network device. When this is specified, the IP address will be assigned and removed when starting and stopping the guest.</div>
1245                   </li>
1246                   <li>
1247                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/disabled">disabled</span>
1248                     <br />
1249                     <div class="description">When this file exists, this interface will be ignored.</div>
1250                   </li>
1251                   <li>
1252                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/gid">gid</span>
1253                     <br />
1254                     <div class="description">
1255 Sets the group ownership of tun/tap interfaces. Requires a group id,
1256 not a group name.
1257           </div>
1258                   </li>
1259                   <li>
1260                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/ip">ip</span>
1261                     <br />
1262                     <div class="description">The IP address which will be assigned to this interface.</div>
1263                   </li>
1264                   <li>
1265                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/linktype">linktype</span>
1266                     <br />
1267                     <div class="description">
1268 Sets the link type of tun/tap interfaces.
1269           </div>
1270                   </li>
1271                   <li>
1272                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/mask">mask</span>
1273                     <br />
1274                     <div class="description">The network mask.</div>
1275                   </li>
1276                   <li>
1277                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/name">name</span>
1278                     <br />
1279                     <div class="description">
1280 When this file exists, the interface will be named with the text in
1281 this file. Without such an entry, the IP will not be shown by
1282 <code class="tool">ifconfig</code> but by <code class="command">ip addr ls</code> only.  Such
1283 a labeled interface is known as an "alias" also (e.g. 'eth0:foo').
1284           </div>
1285                   </li>
1286                   <li>
1287                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/nocsum">nocsum</span>
1288                     <br />
1289                     <div class="description">
1290 If a tun or tap interface is created, the presence of this file will
1291 disable checksumming on it.
1292           </div>
1293                   </li>
1294                   <li>
1295                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/nodev">nodev</span>
1296                     <br />
1297                     <div class="description">
1298 When this file exists, the interface will be assumed to exist
1299 already. This can be used to assign primary interfaces which are
1300 created by the host or another vserver.
1301           </div>
1302                   </li>
1303                   <li>
1304                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/novlandev">novlandev</span>
1305                     <br />
1306                     <div class="description">
1307 When this file exists, the steps which setup and destroy a VLAN
1308 interface will be skipped. This will override the global
1309 <a class="optionref" href="#global-vlandev">vlandev</a> and the per-guest
1310 <a class="optionref" href="#local-vlandev">vlandev</a>.
1311           </div>
1312                   </li>
1313                   <li>
1314                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/prefix">prefix</span>
1315                     <br />
1316                     <div class="description">The network prefix-length.</div>
1317                   </li>
1318                   <li>
1319                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/scope">scope</span>
1320                     <br />
1321                     <div class="description">The scope of the network interface.</div>
1322                   </li>
1323                   <li>
1324                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/shared">shared</span>
1325                     <br />
1326                     <div class="description">
1327 When this file exists, the tun/tap interface created will not be
1328 owned by this particular guest.
1329           </div>
1330                   </li>
1331                   <li>
1332                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/tap">tap</span>
1333                     <br />
1334                     <div class="description">
1335 When this file exists, a tap interface will be created when the guest
1336 starts, and removed when the guest stops.
1337           </div>
1338                   </li>
1339                   <li>
1340                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/tun">tun</span>
1341                     <br />
1342                     <div class="description">
1343 When this file exists, a tun interface will be created when the guest
1344 starts, and removed when the guest stops.
1345           </div>
1346                   </li>
1347                   <li>
1348                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/uid">uid</span>
1349                     <br />
1350                     <div class="description">
1351 Sets the ownership of tun/tap interfaces. Requires a user id, not a
1352 username.
1353           </div>
1354                   </li>
1355                   <li>
1356                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/vlandev">vlandev</span>
1357                     <br />
1358                     <div class="description">
1359 When this file exists, the steps which setup and destroy a VLAN
1360 interface will be executed.
1361           </div>
1362                   </li>
1363                 </ul>
1364               </li>
1365             </ul>
1366           </li>
1367           <li>
1368             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">rlimits</span></span>
1369             <br />
1370             <div class="description">
1371 A directory with resource limits. Possible resources are cpu, fsize,
1372 data, stack, core, rss, nproc, nofile, memlock, as, locks, msgqueue,
1373 nsock, openfd, anon, shmem, semary, nsems and dentry. This
1374 configuration will be honored for kernel 2.6 only.
1375       </div>
1376             <ul>
1377               <li>
1378                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource">resource</span>
1379                 <br />
1380                 <div class="description">
1381 A file which contains the hard- and soft-limit of the given resource
1382 in the first line. The special keyword 'inf' is recognized.
1383         </div>
1384               </li>
1385               <li>
1386                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource.hard">resource.hard</span>
1387                 <br />
1388                 <div class="description">
1389 A file which contains the hard-limit of the given resource in the first
1390 line. The special keyword 'inf' is recognized.
1391         </div>
1392               </li>
1393               <li>
1394                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource.min">resource.min</span>
1395                 <br />
1396                 <div class="description">
1397 A file which contains the guaranteed minimum of the given resource in
1398 the first line. The special keyword 'inf' is recognized.
1399         </div>
1400               </li>
1401               <li>
1402                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource.soft">resource.soft</span>
1403                 <br />
1404                 <div class="description">
1405 A file which contains the soft-limit of the given resource in the first
1406 line. The special keyword 'inf' is recognized.
1407         </div>
1408               </li>
1409             </ul>
1410           </li>
1411           <li id="sched">
1412             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sched</span></span>
1413             <br />
1414             <ul id="sched">
1415               <li id="global-fill-rate">
1416                 <span class="file" title="/etc/vservers/$vserver-name/sched/fill-rate">fill-rate</span>
1417                 <br />
1418                 <div class="description">Amount of tokens to add each <a class="optionref" href="#global-interval">interval</a></div>
1419               </li>
1420               <li id="global-fill-rate2">
1421                 <span class="file" title="/etc/vservers/$vserver-name/sched/fill-rate2">fill-rate2</span>
1422                 <br />
1423                 <div class="description">Amount of tokens to add each <a class="optionref" href="#global-interval2">interval2</a> when advancing idle time</div>
1424               </li>
1425               <li id="global-idle-time">
1426                 <span class="boolean" title="/etc/vservers/$vserver-name/sched/idle-time">idle-time</span>
1427                 <br />
1428                 <div class="description">When this file exists, advancing idle time is activated</div>
1429               </li>
1430               <li id="global-interval">
1431                 <span class="file" title="/etc/vservers/$vserver-name/sched/interval">interval</span>
1432                 <br />
1433                 <div class="description">The interval between refills of the bucket</div>
1434               </li>
1435               <li id="global-interval2">
1436                 <span class="file" title="/etc/vservers/$vserver-name/sched/interval2">interval2</span>
1437                 <br />
1438                 <div class="description">The interval between refills of the bucket when advancing idle time</div>
1439               </li>
1440               <li id="global-priority-bias">
1441                 <span class="file" title="/etc/vservers/$vserver-name/sched/priority-bias">priority-bias</span>
1442                 <br />
1443                 <div class="description">Bias added to priorities calculated within the guest (result is clamped to -20/+19)</div>
1444               </li>
1445               <li id="global-tokens">
1446                 <span class="file" title="/etc/vservers/$vserver-name/sched/tokens">tokens</span>
1447                 <br />
1448                 <div class="description">The initial amount of tokens to put in the bucket</div>
1449               </li>
1450               <li id="global-tokens-max">
1451                 <span class="file" title="/etc/vservers/$vserver-name/sched/tokens-max">tokens-max</span>
1452                 <br />
1453                 <div class="description">The bucket's size</div>
1454               </li>
1455               <li id="global-tokens-min">
1456                 <span class="file" title="/etc/vservers/$vserver-name/sched/tokens-min">tokens-min</span>
1457                 <br />
1458                 <div class="description">The minimum amount of tokens required to unhold the context</div>
1459               </li>
1460               <li>
1461                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sched</span>/<span class="symbolic">cpu-id</span></span>
1462                 <br />
1463                 <div class="description">This directory contains per-CPU and/or per-bucket specific settings. Remember to set the <a class="optionref" href="#cpu-id">cpu-id</a> file. All CPUs inherit the global settings.</div>
1464                 <ul>
1465                   <li>
1466                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/bucket-id">bucket-id</span>
1467                     <br />
1468                     <div class="description">The bucket to apply these settings to</div>
1469                   </li>
1470                   <li id="cpu-id">
1471                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/cpu-id">cpu-id</span>
1472                     <br />
1473                     <div class="description">The CPU to apply these settings to</div>
1474                   </li>
1475                   <li>
1476                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/fill-rate">fill-rate</span>
1477                     <br />
1478                     <div class="description">Amount of tokens to add each <a class="optionref" href="#local-interval">interval</a></div>
1479                   </li>
1480                   <li>
1481                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/fill-rate2">fill-rate2</span>
1482                     <br />
1483                     <div class="description">Amount of tokens to add each <a class="optionref" href="#local-interval2">interval2</a> when advancing idle time</div>
1484                   </li>
1485                   <li>
1486                     <span class="boolean" title="/etc/vservers/$vserver-name/sched/$cpu-id/idle-time">idle-time</span>
1487                     <br />
1488                     <div class="description">When this file exists, advancing idle time is activated</div>
1489                   </li>
1490                   <li id="local-interval">
1491                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/interval">interval</span>
1492                     <br />
1493                     <div class="description">The interval between refills of the bucket</div>
1494                   </li>
1495                   <li id="local-interval2">
1496                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/interval2">interval2</span>
1497                     <br />
1498                     <div class="description">The interval between refills of the bucket when advancing idle time</div>
1499                   </li>
1500                   <li>
1501                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/priority-bias">priority-bias</span>
1502                     <br />
1503                     <div class="description">Bias added to priorities calculated within the guest (result is clamped to -20/+19)</div>
1504                   </li>
1505                   <li>
1506                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/tokens">tokens</span>
1507                     <br />
1508                     <div class="description">The initial amount of tokens to put in the bucket</div>
1509                   </li>
1510                   <li>
1511                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/tokens-max">tokens-max</span>
1512                     <br />
1513                     <div class="description">The bucket's size</div>
1514                   </li>
1515                   <li>
1516                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/tokens-min">tokens-min</span>
1517                     <br />
1518                     <div class="description">The minimum amount of tokens required to unhold the context</div>
1519                   </li>
1520                 </ul>
1521               </li>
1522             </ul>
1523           </li>
1524           <li>
1525             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span></span>
1526             <br />
1527             <div class="description">
1528 A directory for scripts. By default, when one of these scripts will be
1529 executed, the execution of defaultscripts (within .../.defaults/scripts)
1530 will be skipped. To execute them nevertheless, the $DONT_SKIP_DEFAULTS
1531 environment variable must be set by one of the in-shellcontext scripts
1532 (the non-executable ones).
1533       </div>
1534             <ul>
1535               <li>
1536                 <span class="script" title="/etc/vservers/$vserver-name/scripts/initialize">initialize</span>
1537                 <br />
1538                 <div class="description">
1539 The scriptlet which will be executed before the root filesystem is mounted and
1540 the configuration has been loaded. Before executing the script, the
1541 configuration directory will be made the working directory.
1542         </div>
1543               </li>
1544               <li>
1545                 <span class="script" title="/etc/vservers/$vserver-name/scripts/post-start">post-start</span>
1546                 <br />
1547                 <div class="description">
1548 The scriptlet which will be executed after the vserver has been
1549 started. Before executing the script, the vserver root directory
1550 will be made the working directory.
1551         </div>
1552               </li>
1553               <li>
1554                 <span class="script" title="/etc/vservers/$vserver-name/scripts/post-stop">post-stop</span>
1555                 <br />
1556                 <div class="description">
1557 The scriptlet which will be executed after the vserver has been
1558 stopped, but before the directories will be umounted and the the
1559 interfaces disabled. Before executing the script, the vserver root
1560 directory will be made the working directory.
1561         </div>
1562               </li>
1563               <li>
1564                 <span class="script" title="/etc/vservers/$vserver-name/scripts/postpost-stop">postpost-stop</span>
1565                 <br />
1566                 <div class="description">
1567 The scriptlet which will be executed after the vserver has been stopped
1568 completely. Before executing the script, the vserver root directory
1569 will be made the working directory.
1570         </div>
1571               </li>
1572               <li>
1573                 <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-start">pre-start</span>
1574                 <br />
1575                 <div class="description">
1576 The scriptlet which will be executed after network-interfaces were
1577 enabled and the directories mounted, but before the vserver itself has
1578 been started.  Before executing the script, the vserver root directory
1579 will be made the working directory.
1580         </div>
1581               </li>
1582               <li>
1583                 <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-stop">pre-stop</span>
1584                 <br />
1585                 <div class="description">
1586 The scriptlet which will be executed before the vserver will be
1587 stopped. Before executing the script, the vserver root directory
1588 will be made the working directory.
1589         </div>
1590               </li>
1591               <li>
1592                 <span class="script" title="/etc/vservers/$vserver-name/scripts/prepre-start">prepre-start</span>
1593                 <br />
1594                 <div class="description">
1595 The scriptlet which will be executed before the network-interfaces are
1596 enabled and the directories are mounted. Before executing the script,
1597 the configuration directory will be made the working directory.
1598         </div>
1599               </li>
1600               <li>
1601                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">initialize.d</span></span>
1602                 <br />
1603                 <div class="description">
1604 Repository of initialize like scripts.  Before executing the script,
1605 the configuration directory will be made the working directory.
1606         </div>
1607                 <ul>
1608                   <li>
1609                     <span class="script" title="/etc/vservers/$vserver-name/scripts/initialize.d/$script">script</span>
1610                     <br />
1611                     <div class="description">See initialize.</div>
1612                   </li>
1613                 </ul>
1614               </li>
1615               <li>
1616                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">post-start.d</span></span>
1617                 <br />
1618                 <div class="description">
1619 Repository of post-start like scripts. Before executing these scripts,
1620 the vserver root directory will be made the working directory.
1621         </div>
1622                 <ul>
1623                   <li>
1624                     <span class="script" title="/etc/vservers/$vserver-name/scripts/post-start.d/$script">script</span>
1625                     <br />
1626                     <div class="description">See post-start.</div>
1627                   </li>
1628                 </ul>
1629               </li>
1630               <li>
1631                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">post-stop.d</span></span>
1632                 <br />
1633                 <div class="description">
1634 Repository of post-stop like scripts. Before executing the script, the
1635 vserver root directory will be made the working directory.
1636         </div>
1637                 <ul>
1638                   <li>
1639                     <span class="script" title="/etc/vservers/$vserver-name/scripts/post-stop.d/$script">script</span>
1640                     <br />
1641                     <div class="description">See post-stop.</div>
1642                   </li>
1643                 </ul>
1644               </li>
1645               <li>
1646                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">postpost-stop.d</span></span>
1647                 <br />
1648                 <div class="description">
1649 Repository of postpost-stop like scripts. Before executing the script,
1650 the vserver root directory will be made the working directory.
1651         </div>
1652                 <ul>
1653                   <li>
1654                     <span class="script" title="/etc/vservers/$vserver-name/scripts/postpost-stop.d/$script">script</span>
1655                     <br />
1656                     <div class="description">See postpost-stop.</div>
1657                   </li>
1658                 </ul>
1659               </li>
1660               <li>
1661                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">pre-start.d</span></span>
1662                 <br />
1663                 <div class="description">
1664 Repository of pre-start like scripts. Before executing these scripts,
1665 the vserver root directory will be made the working directory.
1666         </div>
1667                 <ul>
1668                   <li>
1669                     <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-start.d/$script">script</span>
1670                     <br />
1671                     <div class="description">See pre-start.</div>
1672                   </li>
1673                 </ul>
1674               </li>
1675               <li>
1676                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">pre-stop.d</span></span>
1677                 <br />
1678                 <div class="description">
1679 Repository of pre-stop like scripts. Before executing the script, the
1680 vserver root directory will be made the working directory.
1681         </div>
1682                 <ul>
1683                   <li>
1684                     <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-stop.d/$script">script</span>
1685                     <br />
1686                     <div class="description">See pre-stop.</div>
1687                   </li>
1688                 </ul>
1689               </li>
1690               <li>
1691                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">prepre-start.d</span></span>
1692                 <br />
1693                 <div class="description">
1694 Repository of prepre-start like scripts.  Before executing the script,
1695 the configuration directory will be made the working directory.
1696         </div>
1697                 <ul>
1698                   <li>
1699                     <span class="script" title="/etc/vservers/$vserver-name/scripts/prepre-start.d/$script">script</span>
1700                     <br />
1701                     <div class="description">See prepre-start.</div>
1702                   </li>
1703                 </ul>
1704               </li>
1705             </ul>
1706           </li>
1707           <li>
1708             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">spaces</span></span>
1709             <br />
1710             <ul>
1711               <li>
1712                 <span class="file" title="/etc/vservers/$vserver-name/spaces/mask">mask</span>
1713                 <br />
1714                 <div class="description">Contains a mask of spaces to clone/enter</div>
1715               </li>
1716               <li>
1717                 <span class="boolean" title="/etc/vservers/$vserver-name/spaces/net">net</span>
1718                 <br />
1719                 <div class="description">Enable network virtualization for this guest</div>
1720               </li>
1721               <li>
1722                 <span class="boolean" title="/etc/vservers/$vserver-name/spaces/pid">pid</span>
1723                 <br />
1724                 <div class="description">Enables pid virtualization for this guest</div>
1725               </li>
1726             </ul>
1727           </li>
1728           <li>
1729             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sysctl</span></span>
1730             <br />
1731             <ul>
1732               <li>
1733                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sysctl</span>/<span class="symbolic">x</span></span>
1734                 <br />
1735                 <div class="description">'x' is an arbitrary name, replace it with e.g. integers</div>
1736                 <ul>
1737                   <li>
1738                     <span class="file" title="/etc/vservers/$vserver-name/sysctl/$x/setting">setting</span>
1739                     <br />
1740                     <div class="description">The sysctl setting</div>
1741                   </li>
1742                   <li>
1743                     <span class="file" title="/etc/vservers/$vserver-name/sysctl/$x/value">value</span>
1744                     <br />
1745                     <div class="description">The value</div>
1746                   </li>
1747                 </ul>
1748               </li>
1749             </ul>
1750           </li>
1751           <li>
1752             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">ulimits</span></span>
1753             <br />
1754             <div class="description">
1755 A directory with ulimits. Possible resources are cpu, data, fsize,
1756 locks, memlock, nofile, nproc, rss and/or stack.
1757       </div>
1758             <ul>
1759               <li>
1760                 <span class="file" title="/etc/vservers/$vserver-name/ulimits/$resource">resource</span>
1761                 <br />
1762                 <div class="description">
1763 A file which contains the hard- and soft-limit of the given resource
1764 in the first line. The special keyword 'inf' is recognized.
1765         </div>
1766               </li>
1767               <li>
1768                 <span class="file" title="/etc/vservers/$vserver-name/ulimits/$resource.hard">resource.hard</span>
1769                 <br />
1770                 <div class="description">
1771 A file which contains the hard-limit of the given resource in the first
1772 line. The special keyword 'inf' is recognized.
1773         </div>
1774               </li>
1775               <li>
1776                 <span class="file" title="/etc/vservers/$vserver-name/ulimits/$resource.soft">resource.soft</span>
1777                 <br />
1778                 <div class="description">
1779 A file which contains the soft-limit of the given resource in the first
1780 line. The special keyword 'inf' is recognized.
1781         </div>
1782               </li>
1783             </ul>
1784           </li>
1785           <li>
1786             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">uts</span></span>
1787             <br />
1788             <ul>
1789               <li>
1790                 <span class="file" title="/etc/vservers/$vserver-name/uts/context">context</span>
1791                 <br />
1792                 <div class="description">
1793 The context-name of the vserver. This file is listed for completeness
1794 only; the 'context' name is used and set internally by the util-vserver
1795 tools and can *not* be modified.
1796         </div>
1797               </li>
1798               <li>
1799                 <span class="file" title="/etc/vservers/$vserver-name/uts/domainname">domainname</span>
1800                 <br />
1801                 <div class="description">The NIS domainname of the vserver</div>
1802               </li>
1803               <li>
1804                 <span class="file" title="/etc/vservers/$vserver-name/uts/machine">machine</span>
1805                 <br />
1806                 <div class="description">The machine-type of the vserver</div>
1807               </li>
1808               <li>
1809                 <span class="file" title="/etc/vservers/$vserver-name/uts/nodename">nodename</span>
1810                 <br />
1811                 <div class="description">The node-/hostname of the vserver</div>
1812               </li>
1813               <li>
1814                 <span class="file" title="/etc/vservers/$vserver-name/uts/release">release</span>
1815                 <br />
1816                 <div class="description">The OS-release of the vserver</div>
1817               </li>
1818               <li>
1819                 <span class="file" title="/etc/vservers/$vserver-name/uts/sysname">sysname</span>
1820                 <br />
1821                 <div class="description">The sysname of the vserver</div>
1822               </li>
1823               <li>
1824                 <span class="file" title="/etc/vservers/$vserver-name/uts/version">version</span>
1825                 <br />
1826                 <div class="description">The OS-version of the vserver</div>
1827               </li>
1828             </ul>
1829           </li>
1830         </ul>
1831       </li>
1832     </ul>
1833   </body>
1834 </html>