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 id="global-cgroup">
 365             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">cgroup</span></span>
 366             <br />
 367             <div class="description">
 368 This directory contains cgroup settings which should be applied to all guests.
 369 See your kernel documentation for what settings are valid with your
 370 configuration.
 371       </div>
 372             <ul id="global-cgroup">
 373               <li>
 374                 <span class="list" title="/etc/vservers/.defaults/cgroup/inherit">inherit</span>
 375                 <br />
 376                 <div class="description">
 377 Some subsystems start out with clean slates, making it impossible to use the
 378 cgroup before certain things have been set. This is true for e.g. the cpuset
 379 subsystem. This file contains a list of filenames which should be explicitly
 380 inherited from the parent (root) cgroup, if not overridden elsewhere.
 381 The default is cpuset.cpus and cpuset.mems.
 382         </div>
 383               </li>
 384               <li>
 385                 <span class="file" title="/etc/vservers/.defaults/cgroup/mnt">mnt</span>
 386                 <br />
 387                 <div class="description">
 388 The directory to mount the cgroup hierarchy at. The default is /dev/cgroup.
 389         </div>
 390               </li>
 391               <li id="global-cgroup-name">
 392                 <span class="file" title="/etc/vservers/.defaults/cgroup/name">name</span>
 393                 <br />
 394                 <div class="description">
 395 If this file exists, all guests will be put in one cgroup named after the
 396 contents of this file. The default is to put each guest in a cgroup named the
 397 same thing as the guest.
 398         </div>
 399               </li>
 400               <li>
 401                 <span class="file" title="/etc/vservers/.defaults/cgroup/subsys">subsys</span>
 402                 <br />
 403                 <div class="description">
 404 Comma-separated list of subsystems to enable on the cgroup mount point.
 405 The default is "all".
 406         </div>
 407               </li>
 408             </ul>
 409           </li>
 410           <li>
 411             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">files</span></span>
 412             <br />
 413             <div class="description">This directory contains some files which will be copied to the guests during build.</div>
 414             <ul>
 415               <li>
 416                 <span class="data" title="/etc/vservers/.defaults/files/hosts">hosts</span>
 417                 <br />
 418                 <div class="description">The default /etc/hosts file.</div>
 419               </li>
 420               <li>
 421                 <span class="data" title="/etc/vservers/.defaults/files/krb.conf">krb.conf</span>
 422                 <br />
 423                 <div class="description">The default /etc/krb.conf file.</div>
 424               </li>
 425               <li>
 426                 <span class="data" title="/etc/vservers/.defaults/files/krb.realms">krb.realms</span>
 427                 <br />
 428                 <div class="description">The default /etc/krb.realms file.</div>
 429               </li>
 430               <li>
 431                 <span class="data" title="/etc/vservers/.defaults/files/krb5.conf">krb5.conf</span>
 432                 <br />
 433                 <div class="description">The default /etc/krb5.conf file.</div>
 434               </li>
 435               <li>
 436                 <span class="data" title="/etc/vservers/.defaults/files/ldap.conf">ldap.conf</span>
 437                 <br />
 438                 <div class="description">The default /etc/ldap.conf file.</div>
 439               </li>
 440               <li>
 441                 <span class="data" title="/etc/vservers/.defaults/files/localtime">localtime</span>
 442                 <br />
 443                 <div class="description">The default /etc/localtime file.</div>
 444               </li>
 445               <li>
 446                 <span class="data" title="/etc/vservers/.defaults/files/nsswitch.conf">nsswitch.conf</span>
 447                 <br />
 448                 <div class="description">The default /etc/nsswitch.conf file.</div>
 449               </li>
 450               <li>
 451                 <span class="data" title="/etc/vservers/.defaults/files/resolv.conf">resolv.conf</span>
 452                 <br />
 453                 <div class="description">The default /etc/resolv.conf file.</div>
 454               </li>
 455             </ul>
 456           </li>
 457           <li>
 458             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="fixed">init</span></span>
 459             <br />
 460             <ul>
 461               <li>
 462                 <span class="data" title="/etc/vservers/.defaults/init/mtab">mtab</span>
 463                 <br />
 464                 <div class="description">Default mtab file</div>
 465               </li>
 466             </ul>
 467           </li>
 468           <li>
 469             <span class="directory">/etc/vservers/<span class="">.defaults</span>/<span class="">interfaces</span></span>
 470             <br />
 471             <ul>
 472               <li id="global-vlandev">
 473                 <span class="boolean" title="/etc/vservers/.defaults/interfaces/vlandev">vlandev</span>
 474                 <br />
 475                 <div class="description">
 476 When this file exists, the steps which setup and destroy a VLAN
 477 interface will be executed.
 478         </div>
 479               </li>
 480             </ul>
 481           </li>
 482         </ul>
 483       </li>
 484       <li>
 485         <span class="directory">/etc/vservers/<span class="">.distributions</span></span>
 486         <br />
 487         <ul>
 488           <li>
 489             <span class="symlink" title="/etc/vservers/.distributions/template">template</span>
 490             <br />
 491             <div class="description">
 492 Symlink to the default template for this distribution.
 493       </div>
 494           </li>
 495           <li>
 496             <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span></span>
 497             <br />
 498             <ul>
 499               <li>
 500                 <span class="data" title="/etc/vservers/.distributions/$dist/apt.conf">apt.conf</span>
 501                 <br />
 502                 <div class="description">
 503 The default apt.conf which is going to be used. It overrides the
 504 apt.conf from CONFDIR/.defaults/apps/pkgmgmt.
 505         </div>
 506               </li>
 507               <li>
 508                 <span class="file" title="/etc/vservers/.distributions/$dist/dev">dev</span>
 509                 <br />
 510                 <div class="description"></div>
 511               </li>
 512               <li>
 513                 <span class="symlink" title="/etc/vservers/.distributions/$dist/execdir">execdir</span>
 514                 <br />
 515                 <div class="description">
 516 Directory with all executables and libraries which are required for
 517 this distribution.
 518         </div>
 519               </li>
 520               <li>
 521                 <span class="script" title="/etc/vservers/.distributions/$dist/initpost">initpost</span>
 522                 <br />
 523                 <div class="description">
 524 Script which will be executed after packages are installed.
 525           </div>
 526               </li>
 527               <li>
 528                 <span class="script" title="/etc/vservers/.distributions/$dist/initpre">initpre</span>
 529                 <br />
 530                 <div class="description">
 531 Script which will be executed before packages will be installed.
 532           </div>
 533               </li>
 534               <li>
 535                 <span class="symlink" title="/etc/vservers/.distributions/$dist/rpmlib">rpmlib</span>
 536                 <br />
 537                 <div class="description">
 538 Directory which overrides <span class="directoryname">/usr/lib/rpm</span>.
 539         </div>
 540               </li>
 541               <li>
 542                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">apt</span></span>
 543                 <br />
 544                 <div class="description">
 545 Default content of the <span class="directoryname">/etc/apt/</span> directory.
 546         </div>
 547               </li>
 548               <li>
 549                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">pkgs</span></span>
 550                 <br />
 551                 <div class="description">
 552 Contains files with packagenames.
 553         </div>
 554                 <ul>
 555                   <li>
 556                     <span class="list" title="/etc/vservers/.distributions/$dist/pkgs/list">list</span>
 557                     <br />
 558                     <div class="description">
 559 File which contains the name of packages. On top of file the special
 560 keywords '--reinstall' and '--can-fail' are possible.
 561           </div>
 562                   </li>
 563                 </ul>
 564               </li>
 565               <li>
 566                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">pubkeys</span></span>
 567                 <br />
 568                 <div class="description">
 569 Directory with GPG pubkeys which are used to sign the packages of this
 570 distribution.
 571         </div>
 572               </li>
 573               <li>
 574                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">rpm</span></span>
 575                 <br />
 576                 <div class="description">
 577 Default content of the <span class="directoryname">/etc/rpm</span> directory.
 578         </div>
 579               </li>
 580               <li>
 581                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">yum</span></span>
 582                 <br />
 583                 <div class="description">
 584 The default, yum-related content of the <span class="directoryname">/etc</span>
 585 directory.
 586         </div>
 587                 <ul>
 588                   <li>
 589                     <span class="file" title="/etc/vservers/.distributions/$dist/yum/yum.conf">yum.conf</span>
 590                     <br />
 591                     <div class="description">
 592 The master yum configuration file. It supports the @YUMETCDIR@,
 593 @YUMCACHEDIR@ and @YUMLOGDIR@ placeholder which will be replaced at
 594 <code class="command">vserver ... build</code> time.
 595           </div>
 596                   </li>
 597                 </ul>
 598               </li>
 599               <li>
 600                 <span class="directory">/etc/vservers/<span class="">.distributions</span>/<span class="symbolic">dist</span>/<span class="">yum.repos.d</span></span>
 601                 <br />
 602                 <div class="description">A directory with yum repositories.</div>
 603               </li>
 604             </ul>
 605           </li>
 606         </ul>
 607       </li>
 608       <li>
 609         <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span></span>
 610         <br />
 611         <div class="description">
 612 The configuration directory for the vserver vserver-name.
 613     </div>
 614         <ul>
 615           <li>
 616             <span class="file" title="/etc/vservers/$vserver-name/badness">badness</span>
 617             <br />
 618             <div class="description">
 619 Contains the bias to be applied to processes in this guest when the OOM-killer strikes.
 620       </div>
 621           </li>
 622           <li id="bcapabilities">
 623             <span class="list" title="/etc/vservers/$vserver-name/bcapabilities">bcapabilities</span>
 624             <br />
 625             <div class="description">
 626 Contains the system capabilities. See
 627 <a href="http://svn.linux-vserver.org/svn/util-vserver/trunk/lib/bcaps-v13.c">lib/bcaps-v13.c</a>
 628 for possible values.
 629       </div>
 630           </li>
 631           <li>
 632             <span class="symlink" title="/etc/vservers/$vserver-name/cache">cache</span>
 633             <br />
 634             <div class="description">
 635 Path of the storage area for cached information about this vserver.
 636       </div>
 637           </li>
 638           <li>
 639             <span class="list" title="/etc/vservers/$vserver-name/capabilities">capabilities</span>
 640             <br />
 641             <div class="description">
 642 Contains per line a capability. This file is used for the 2.4 kernel
 643 only; for 2.6 use <a class="optionref" href="#bcapabilities">bcapabilities</a>.
 644       </div>
 645           </li>
 646           <li>
 647             <span class="list" title="/etc/vservers/$vserver-name/ccapabilities">ccapabilities</span>
 648             <br />
 649             <div class="description">
 650 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>
 651 for possible values.
 652       </div>
 653           </li>
 654           <li id="cflags">
 655             <span class="list" title="/etc/vservers/$vserver-name/cflags">cflags</span>
 656             <br />
 657             <div class="description">
 658 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>
 659 for possible values.
 660       </div>
 661           </li>
 662           <li>
 663             <span class="file" title="/etc/vservers/$vserver-name/context">context</span>
 664             <br />
 665             <div class="description">
 666 Contains the context id which shall be used for the vserver. Valid range is 2 through 49151.
 667         </div>
 668           </li>
 669           <li>
 670             <span class="list" title="/etc/vservers/$vserver-name/flags">flags</span>
 671             <br />
 672             <div class="description">
 673 Old name for <a class="optionref" href="#cflags">cflags</a>. Deprecated.
 674       </div>
 675           </li>
 676           <li id="fstab">
 677             <span class="data" title="/etc/vservers/$vserver-name/fstab">fstab</span>
 678             <br />
 679             <div class="description">
 680 The fstab file for the vserver. Entries in this file will be mounted
 681 within the network context of the host. Use the
 682 <a class="optionref" href="#fstab.remote">fstab.remote</a> file when you want that the
 683 mounting happens in the network context of the vserver. In most cases
 684 the 'fstab' file should be used.
 685       </div>
 686           </li>
 687           <li id="fstab.remote">
 688             <span class="data" title="/etc/vservers/$vserver-name/fstab.remote">fstab.remote</span>
 689             <br />
 690             <div class="description">
 691 The fstab file for the vserver. Entries in this file will be mounted
 692 within the network context of the guest; this means that mount will be
 693 called as <code class="command">chbind &lt;options&gt; mount ...</code>. See
 694 <a class="optionref" href="#fstab">fstab</a> also.
 695       </div>
 696           </li>
 697           <li>
 698             <span class="file" title="/etc/vservers/$vserver-name/name">name</span>
 699             <br />
 700             <div class="description">
 701 Contains the name of the vserver. When not given, the basename of the directory
 702 will be assumed as this name.
 703       </div>
 704           </li>
 705           <li id="global-namespace">
 706             <span class="boolean" title="/etc/vservers/$vserver-name/namespace">namespace</span>
 707             <br />
 708             <div class="description">
 709 Overrides the global <a class="optionref" href="#global-nonamespace">nonamespace</a> flag and enables
 710 namespace usage for the current vserver.
 711       </div>
 712           </li>
 713           <li id="namespace-cleanup">
 714             <span class="boolean" title="/etc/vservers/$vserver-name/namespace-cleanup">namespace-cleanup</span>
 715             <br />
 716             <div class="description">
 717 Overrides the global <a class="optionref" href="#global-nonamespace-cleanup">nonamespace-cleanup</a> flag and enables
 718 namespace cleanup for the current vserver.
 719       </div>
 720           </li>
 721           <li>
 722             <span class="list" title="/etc/vservers/$vserver-name/namespace-cleanup-skip">namespace-cleanup-skip</span>
 723             <br />
 724             <div class="description">
 725 List of paths to skip during namespace cleanup. This overrides the global
 726 <a class="optionref" href="#global-namespace-cleanup-skip">namespace-cleanup-skip</a>
 727 file.
 728       </div>
 729           </li>
 730           <li>
 731             <span class="list" title="/etc/vservers/$vserver-name/ncapabilities">ncapabilities</span>
 732             <br />
 733             <div class="description">
 734 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>
 735 for possible values.
 736       </div>
 737           </li>
 738           <li>
 739             <span class="file" title="/etc/vservers/$vserver-name/ncontext">ncontext</span>
 740             <br />
 741             <div class="description">
 742 Contains the network context id which shall be used for the vserver. Valid range is 2 through 49151.
 743       </div>
 744           </li>
 745           <li>
 746             <span class="list" title="/etc/vservers/$vserver-name/nflags">nflags</span>
 747             <br />
 748             <div class="description">
 749 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>
 750 for possible values.
 751       </div>
 752           </li>
 753           <li>
 754             <span class="file" title="/etc/vservers/$vserver-name/nice">nice</span>
 755             <br />
 756             <div class="description">
 757 The nice-level on which the vserver will be started.
 758       </div>
 759           </li>
 760           <li>
 761             <span class="file" title="/etc/vservers/$vserver-name/nocgroup">nocgroup</span>
 762             <br />
 763             <div class="description">
 764 If this file exists,
 765 <a class="optionref" href="#global-cgroup">.defaults/cgroup</a> will be ignored
 766 for this guest.
 767       </div>
 768           </li>
 769           <li>
 770             <span class="boolean" title="/etc/vservers/$vserver-name/nonamespace">nonamespace</span>
 771             <br />
 772             <div class="description">
 773 Disables namespace usage for the current vserver.
 774
 775 In this mode the <span class="directoryname">/vservers</span> directory must have
 776 the 'barrier' attribute. Else, common chroot(2) exploits are possible.
 777       </div>
 778           </li>
 779           <li>
 780             <span class="list" title="/etc/vservers/$vserver-name/personality">personality</span>
 781             <br />
 782             <div class="description">
 783 Used to set the personality of the vserver. First line in the file
 784 is the personality-type followed by flags (one item per line). See
 785 <a class="filename" href="file:///usr/include/linux/personality.h">/usr/include/linux/personality.h</a> for possible
 786 values.
 787       </div>
 788           </li>
 789           <li>
 790             <span class="symlink" title="/etc/vservers/$vserver-name/run">run</span>
 791             <br />
 792             <div class="description">
 793 Points to a file which will contain the XID of the running vserver. When
 794 the vserver is stopped, this can be a dangling symlink.
 795       </div>
 796           </li>
 797           <li>
 798             <span class="hash" title="/etc/vservers/$vserver-name/schedule">schedule</span>
 799             <br />
 800             <div class="description">
 801 [deprecated; use <a class="optionref" href="#sched">sched</a> instead] Contains the
 802 scheduler parameters, one per line.
 803
 804 The Hard CPU limit uses a mechanism called a Token Bucket.  the
 805 concept is simple: you have a bucket of a certain size which is
 806 filled with a specified amount R of tokens each interval T until the
 807 maximum is reached (excess tokens are spilled). At each timer tick,
 808 a running process consumes one token from the bucket, unless the
 809 bucket is empty. If the bucket is empty the process is put in the
 810 hold queue. When the bucket has been refilled to at least M tokens,
 811 all on hold processes are rescheduled.
 812
 813 See the <a href="http://linux-vserver.org/Scheduler+Parameters">Linux
 814 VServer Wiki</a> for more information about this file.
 815       </div>
 816           </li>
 817           <li id="shell">
 818             <span class="file" title="/etc/vservers/$vserver-name/shell">shell</span>
 819             <br />
 820             <div class="description">
 821 Contains the pathname of the shell which will be used by the "vserver
 822 ... enter" command.
 823       </div>
 824           </li>
 825           <li>
 826             <span class="file" title="/etc/vservers/$vserver-name/tag">tag</span>
 827             <br />
 828             <div class="description">
 829 Contains the filesystem tag which shall be used for the vserver. Valid range is 2 through 49151.
 830       </div>
 831           </li>
 832           <li>
 833             <span class="symlink" title="/etc/vservers/$vserver-name/vdir">vdir</span>
 834             <br />
 835             <div class="description">
 836 Path of the vserver root directory.
 837       </div>
 838           </li>
 839           <li>
 840             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span></span>
 841             <br />
 842             <ul>
 843               <li>
 844                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">init</span></span>
 845                 <br />
 846                 <ul>
 847                   <li>
 848                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.prepare">cmd.prepare</span>
 849                     <br />
 850                     <div class="description">
 851 The command which is used to setup the init-system (e.g. to set the
 852 runlevel in the utmp-file). Each option must be on a separate line.
 853           </div>
 854                   </li>
 855                   <li>
 856                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.start">cmd.start</span>
 857                     <br />
 858                     <div class="description">
 859 The command which is used to start the vserver. Each option must be on
 860 a separate line.
 861           </div>
 862                   </li>
 863                   <li>
 864                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.start-sync">cmd.start-sync</span>
 865                     <br />
 866                     <div class="description">
 867 The command which is used to wait on the vserver after it has been
 868 started. Each option must be on a separate line. This file will be
 869 ignored when the <a class="optionref" href="#sync">sync</a> flag does not exist and the
 870 '--sync' option was not used.
 871           </div>
 872                   </li>
 873                   <li>
 874                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.stop">cmd.stop</span>
 875                     <br />
 876                     <div class="description">
 877 The command which is used to stop the vserver. Each option must be on
 878 a separate line.
 879           </div>
 880                   </li>
 881                   <li>
 882                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/cmd.stop-sync">cmd.stop-sync</span>
 883                     <br />
 884                     <div class="description">
 885 The command which is used to wait on the vserver after it has been
 886 stopped. Each option must be on a separate line. This file will be
 887 ignored when the <a class="optionref" href="#sync">sync</a> flag does not exist and the
 888 '--sync' option was not used.
 889           </div>
 890                   </li>
 891                   <li>
 892                     <span class="list" title="/etc/vservers/$vserver-name/apps/init/depends">depends</span>
 893                     <br />
 894                     <div class="description">
 895 This file is used to configure vservers which must be running before
 896 the current vserver can be started. At shutdown, the current vserver
 897 will be stopped before its dependencies. Content of this file are
 898 vserver ids (one name per line).
 899           </div>
 900                   </li>
 901                   <li>
 902                     <span class="hash" title="/etc/vservers/$vserver-name/apps/init/environment">environment</span>
 903                     <br />
 904                     <div class="description">
 905 The environment to set when starting the guest. Contains one VAR=VAL
 906 pair per line.
 907           </div>
 908                   </li>
 909                   <li>
 910                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/killseq">killseq</span>
 911                     <br />
 912                     <div class="description">
 913 Contains the 'signal [wait signal]*' sequence which is used to stop
 914 the vserver.
 915           </div>
 916                   </li>
 917                   <li>
 918                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/mark">mark</span>
 919                     <br />
 920                     <div class="description">
 921 This file is used to mark group of vservers which shall be started/stopped
 922 together by the initscript. Content is a simple string like 'default'.
 923           </div>
 924                   </li>
 925                   <li>
 926                     <span class="data" title="/etc/vservers/$vserver-name/apps/init/mtab">mtab</span>
 927                     <br />
 928                     <div class="description">
 929 The initial-mtab which will be used for the vserver.
 930           </div>
 931                   </li>
 932                   <li>
 933                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/runlevel">runlevel</span>
 934                     <br />
 935                     <div class="description">The start runlevel.</div>
 936                   </li>
 937                   <li>
 938                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/runlevel.start">runlevel.start</span>
 939                     <br />
 940                     <div class="description">The start runlevel.</div>
 941                   </li>
 942                   <li>
 943                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/runlevel.stop">runlevel.stop</span>
 944                     <br />
 945                     <div class="description">The stop runlevel.</div>
 946                   </li>
 947                   <li>
 948                     <span class="file" title="/etc/vservers/$vserver-name/apps/init/style">style</span>
 949                     <br />
 950                     <div class="description">
 951 Contains the init-style.
 952           </div>
 953                   </li>
 954                   <li id="sync">
 955                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/init/sync">sync</span>
 956                     <br />
 957                     <div class="description">
 958 If this file is not present, all 'cmd.*-sync files will be ignored.
 959             </div>
 960                   </li>
 961                   <li>
 962                     <span class="symlink" title="/etc/vservers/$vserver-name/apps/init/tty">tty</span>
 963                     <br />
 964                     <div class="description">
 965 A symlink to the TTY device where input/output will be redirected
 966 from/to at startup via initscript.
 967           </div>
 968                   </li>
 969                 </ul>
 970               </li>
 971               <li>
 972                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vdevmap</span></span>
 973                 <br />
 974                 <ul>
 975                   <li>
 976                     <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>
 977                     <br />
 978                     <div class="description">'x' is an arbitrary name, replace it with e.g. device names</div>
 979                     <ul>
 980                       <li>
 981                         <span class="boolean" title="/etc/vservers/$vserver-name/apps/vdevmap/x/create">create</span>
 982                         <br />
 983                         <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>
 984                       </li>
 985                       <li>
 986                         <span class="file" title="/etc/vservers/$vserver-name/apps/vdevmap/x/device">device</span>
 987                         <br />
 988                         <div class="description">Contains the name of a device node</div>
 989                       </li>
 990                       <li>
 991                         <span class="file" title="/etc/vservers/$vserver-name/apps/vdevmap/x/flags">flags</span>
 992                         <br />
 993                         <div class="description">This file will let you specify unimplemented flags manually</div>
 994                       </li>
 995                       <li>
 996                         <span class="boolean" title="/etc/vservers/$vserver-name/apps/vdevmap/x/open">open</span>
 997                         <br />
 998                         <div class="description">When this file exists, the device can be opened</div>
 999                       </li>
1000                       <li id="guest-vdevmap-remap">
1001                         <span class="boolean" title="/etc/vservers/$vserver-name/apps/vdevmap/x/remap">remap</span>
1002                         <br />
1003                         <div class="description">
1004 When this file exists, <a class="optionref" href="#guest-vdevmap-target">target</a> will
1005 have to exist as well and opening the device will in fact open the target device
1006             </div>
1007                       </li>
1008                       <li id="guest-vdevmap-target">
1009                         <span class="file" title="/etc/vservers/$vserver-name/apps/vdevmap/x/target">target</span>
1010                         <br />
1011                         <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>
1012                       </li>
1013                     </ul>
1014                   </li>
1015                 </ul>
1016               </li>
1017               <li>
1018                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vshelper</span></span>
1019                 <br />
1020                 <ul>
1021                   <li id="vshelper-action">
1022                     <span class="file" title="/etc/vservers/$vserver-name/apps/vshelper/action">action</span>
1023                     <br />
1024                     <div class="description">
1025 The action which is going to be executed when a vshelper event
1026 occurs. The default value is 'restart', but there can be defined own
1027 methods by placing scripts into the
1028 <a class="optionref" href="#vshelper-methods">vshelper-methods</a> directories. These scripts are
1029 fed with the same arguments as the <code class="tool">vshelper</code> script.
1030           </div>
1031                   </li>
1032                   <li>
1033                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vshelper/debug">debug</span>
1034                     <br />
1035                     <div class="description">
1036 When existing, the vshelper execution will be traced for this vserver.
1037           </div>
1038                   </li>
1039                   <li>
1040                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vshelper/disabled">disabled</span>
1041                     <br />
1042                     <div class="description">
1043 When existing, the vshelper functionality will be disabled for this
1044 vserver.
1045           </div>
1046                   </li>
1047                   <li>
1048                     <span class="script" title="/etc/vservers/$vserver-name/apps/vshelper/$event">event</span>
1049                     <br />
1050                     <div class="description">
1051 When existing, these scripts will be executed *instead* of the default
1052 handler defined in 'action'. Their name must match the event which caused
1053 the execution of <code class="tool">vshelper</code>; e.g. 'restart' or 'poweroff'. See
1054 the vs_reboot() function in the kernel for more details.
1055           </div>
1056                   </li>
1057                   <li>
1058                     <span class="file" title="/etc/vservers/$vserver-name/apps/vshelper/sync-timeout">sync-timeout</span>
1059                     <br />
1060                     <div class="description">
1061 The timeout in seconds which is used when synchronising vserver
1062 startup/shutdown with the vshelper. When not set, 30 seconds will be
1063 assumed.
1064           </div>
1065                   </li>
1066                   <li>
1067                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vshelper/warning-disabled">warning-disabled</span>
1068                     <br />
1069                     <div class="description">
1070 When existing, sanity checks for the vshelper functionality will be
1071 skipped.
1072           </div>
1073                   </li>
1074                 </ul>
1075               </li>
1076               <li id="vshelper-methods">
1077                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vshelper-methods</span></span>
1078                 <br />
1079                 <ul id="vshelper-methods">
1080                   <li>
1081                     <span class="script" title="/etc/vservers/$vserver-name/apps/vshelper-methods/$handler">handler</span>
1082                     <br />
1083                     <div class="description">
1084 See <a class="optionref" href="#vshelper-action">vshelper/action</a>.
1085           </div>
1086                   </li>
1087                 </ul>
1088               </li>
1089               <li>
1090                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vunify</span></span>
1091                 <br />
1092                 <div class="description">
1093 This directory contains configuration data required for vserver
1094 unification.
1095         </div>
1096                 <ul>
1097                   <li>
1098                     <span class="list" title="/etc/vservers/$vserver-name/apps/vunify/exclude">exclude</span>
1099                     <br />
1100                     <div class="description">
1101 <div>Static list of files which are excluded for unification. This list
1102 supports an rsync-like syntax: when a file is prefixed by '+', it is a
1103 candidate for unification; when there is no prefix or a '-' or a '~' it
1104 will be excluded. Shell-wildcards are allowed for the filenames.</div>
1105 <div>When used with <code class="tool">vcopy</code>, the '~' prefix prevents copying
1106 of the file entirely (e.g. for keyfiles). With this tool, the file will
1107 be copied instead of hardlinked when the '-' prefix is used.</div>
1108           </div>
1109                   </li>
1110                   <li>
1111                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vunify/pgkmgmt-force">pgkmgmt-force</span>
1112                     <br />
1113                     <div class="description">
1114 When existing, information from packagemanagement will be used to
1115 create dynamic exclude-lists. This option requires that (a known)
1116 packagemanagement is configured for the vserver; else the requested
1117 operation will fail. Most tools assume 'on' as the default value.
1118           </div>
1119                   </li>
1120                   <li>
1121                     <span class="boolean" title="/etc/vservers/$vserver-name/apps/vunify/pkgmgmt-ignore">pkgmgmt-ignore</span>
1122                     <br />
1123                     <div class="description">
1124 When existing, information from packagemanagement will not be used to
1125 create dynamic exclude-lists.
1126           </div>
1127                   </li>
1128                   <li>
1129                     <span class="symlink" title="/etc/vservers/$vserver-name/apps/vunify/$refserver.X">refserver.X</span>
1130                     <br />
1131                     <div class="description">
1132 These are symlinks to the configuration directory
1133 (e.g. CONFDIR/vservers/&lt;id&gt;) of a refserver. There may be
1134 multiple such symlinks but they must be prefixed by 'refserver.' and
1135 will be processed in alphanumerical order.
1136           </div>
1137                   </li>
1138                   <li>
1139                     <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">apps</span>/<span class="">vunify</span>/<span class="">hash</span></span>
1140                     <br />
1141                     <div class="description">
1142 A directory which will be used as the storage place for the
1143 <code class="tool">vhashify</code> command.
1144           </div>
1145                     <ul>
1146                       <li>
1147                         <span class="symlink" title="/etc/vservers/$vserver-name/apps/vunify/hash/$id">id</span>
1148                         <br />
1149                         <div class="description">
1150 Points to a directory within the filesystems which are used for the
1151 vservers. There must be not more than one of such a directory per
1152 filesystem.
1153             </div>
1154                       </li>
1155                       <li>
1156                         <span class="file" title="/etc/vservers/$vserver-name/apps/vunify/hash/method">method</span>
1157                         <br />
1158                         <div class="description">The used hash method.</div>
1159                       </li>
1160                     </ul>
1161                   </li>
1162                 </ul>
1163               </li>
1164             </ul>
1165           </li>
1166           <li id="guest-cgroup">
1167             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">cgroup</span></span>
1168             <br />
1169             <div class="description">
1170 This directory contains cgroup settings to be applied to this guest.
1171 See your kernel documentation for what settings are valid with your
1172 configuration.
1173       </div>
1174             <ul id="guest-cgroup">
1175               <li>
1176                 <span class="file" title="/etc/vservers/$vserver-name/cgroup/name">name</span>
1177                 <br />
1178                 <div class="description">
1179 If this file exists, the guest will be put in a cgroup named after the
1180 contents of this file. The default is to name the cgroup the same thing as the
1181 guest, unless
1182 <a class="optionref" href="#global-cgroup-name">.defaults/cgroup/name</a> says
1183 otherwise.
1184         </div>
1185               </li>
1186             </ul>
1187           </li>
1188           <li>
1189             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">cpuset</span></span>
1190             <br />
1191             <div class="description">
1192 Puts the guest in a cpuset. Required entries are name, cpus and mems.
1193       </div>
1194             <ul>
1195               <li>
1196                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/cpu_exclusive">cpu_exclusive</span>
1197                 <br />
1198                 <div class="description">Is the CPU assignment exclusive?</div>
1199               </li>
1200               <li>
1201                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/cpus">cpus</span>
1202                 <br />
1203                 <div class="description">The list of CPUs in this cpuset</div>
1204               </li>
1205               <li>
1206                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/mems">mems</span>
1207                 <br />
1208                 <div class="description">The list of Memory Nodes in this cpuset</div>
1209               </li>
1210               <li>
1211                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/mems_exclusive">mems_exclusive</span>
1212                 <br />
1213                 <div class="description">Is the memory node assignment exclusive?</div>
1214               </li>
1215               <li>
1216                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/name">name</span>
1217                 <br />
1218                 <div class="description">The name of the cpuset for this vserver</div>
1219               </li>
1220               <li>
1221                 <span class="file" title="/etc/vservers/$vserver-name/cpuset/nocreate">nocreate</span>
1222                 <br />
1223                 <div class="description">When this file exists, the cpuset will be assumed to exist already</div>
1224               </li>
1225             </ul>
1226           </li>
1227           <li>
1228             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">dlimits</span></span>
1229             <br />
1230             <div class="description">
1231 Note that all entries are required for the disk limit to be applied.
1232       </div>
1233             <ul>
1234               <li>
1235                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">dlimits</span>/<span class="symbolic">x</span></span>
1236                 <br />
1237                 <div class="description">'x' is an arbitrary name, replace it with e.g. integers</div>
1238                 <ul>
1239                   <li>
1240                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/directory">directory</span>
1241                     <br />
1242                     <div class="description">The directory to which the limit should be applied</div>
1243                   </li>
1244                   <li>
1245                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/inodes_total">inodes_total</span>
1246                     <br />
1247                     <div class="description">The amount of inodes this vserver should be limited to</div>
1248                   </li>
1249                   <li>
1250                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/reserved">reserved</span>
1251                     <br />
1252                     <div class="description">How much space (percentage-wise) should be reserved for the root user</div>
1253                   </li>
1254                   <li>
1255                     <span class="file" title="/etc/vservers/$vserver-name/dlimits/$x/space_total">space_total</span>
1256                     <br />
1257                     <div class="description">The amount of space this vserver should be limited to (measured in blocks of 1024 bytes)</div>
1258                   </li>
1259                 </ul>
1260               </li>
1261             </ul>
1262           </li>
1263           <li>
1264             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">interfaces</span></span>
1265             <br />
1266             <ul>
1267               <li>
1268                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/bcast">bcast</span>
1269                 <br />
1270                 <div class="description">The guest's broadcast address.</div>
1271               </li>
1272               <li>
1273                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/dev">dev</span>
1274                 <br />
1275                 <div class="description">The default network device. See <a class="optionref" href="#per-if-dev">iface/dev</a> for more information.</div>
1276               </li>
1277               <li>
1278                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/lback">lback</span>
1279                 <br />
1280                 <div class="description">The guest's loopback address.</div>
1281               </li>
1282               <li>
1283                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/mask">mask</span>
1284                 <br />
1285                 <div class="description">The default network mask.</div>
1286               </li>
1287               <li id="local-novlandev">
1288                 <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/novlandev">novlandev</span>
1289                 <br />
1290                 <div class="description">
1291 When this file exists, the steps which setup and destroy a VLAN
1292 interface will be skipped. This overrides the global
1293 <a class="optionref" href="#global-vlandev">vlandev</a> setting for
1294 this vserver.
1295         </div>
1296               </li>
1297               <li>
1298                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/prefix">prefix</span>
1299                 <br />
1300                 <div class="description">The default network prefix-length.</div>
1301               </li>
1302               <li>
1303                 <span class="file" title="/etc/vservers/$vserver-name/interfaces/scope">scope</span>
1304                 <br />
1305                 <div class="description">The default scope of the network interfaces.</div>
1306               </li>
1307               <li id="local-vlandev">
1308                 <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/vlandev">vlandev</span>
1309                 <br />
1310                 <div class="description">
1311 When this file exists, the steps which setup and destroy a VLAN
1312 interface will be executed for all interfaces of this vserver.
1313         </div>
1314               </li>
1315               <li>
1316                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">interfaces</span>/<span class="symbolic">iface</span></span>
1317                 <br />
1318                 <div class="description">
1319 'iface' is an arbitrary name for the interface; the value itself is
1320 not important but may be interesting regarding interface-creation and
1321 usage with <code class="tool">chbind</code>. Both happens in alphabetical order and
1322 numbers like '00' are good names for these directories.
1323         </div>
1324                 <ul>
1325                   <li id="per-if-dev">
1326                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/dev">dev</span>
1327                     <br />
1328                     <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>
1329                   </li>
1330                   <li>
1331                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/disabled">disabled</span>
1332                     <br />
1333                     <div class="description">When this file exists, this interface will be ignored.</div>
1334                   </li>
1335                   <li>
1336                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/gid">gid</span>
1337                     <br />
1338                     <div class="description">
1339 Sets the group ownership of tun/tap interfaces. Requires a group id,
1340 not a group name.
1341           </div>
1342                   </li>
1343                   <li>
1344                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/ip">ip</span>
1345                     <br />
1346                     <div class="description">The IP address which will be assigned to this interface.</div>
1347                   </li>
1348                   <li>
1349                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/linktype">linktype</span>
1350                     <br />
1351                     <div class="description">
1352 Sets the link type of tun/tap interfaces.
1353           </div>
1354                   </li>
1355                   <li>
1356                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/mask">mask</span>
1357                     <br />
1358                     <div class="description">The network mask.</div>
1359                   </li>
1360                   <li>
1361                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/name">name</span>
1362                     <br />
1363                     <div class="description">
1364 When this file exists, the interface will be named with the text in
1365 this file. Without such an entry, the IP will not be shown by
1366 <code class="tool">ifconfig</code> but by <code class="command">ip addr ls</code> only.  Such
1367 a labeled interface is known as an "alias" also (e.g. 'eth0:foo').
1368           </div>
1369                   </li>
1370                   <li>
1371                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/nocsum">nocsum</span>
1372                     <br />
1373                     <div class="description">
1374 If a tun or tap interface is created, the presence of this file will
1375 disable checksumming on it.
1376           </div>
1377                   </li>
1378                   <li>
1379                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/nodev">nodev</span>
1380                     <br />
1381                     <div class="description">
1382 When this file exists, the interface will be assumed to exist
1383 already. This can be used to assign primary interfaces which are
1384 created by the host or another vserver.
1385           </div>
1386                   </li>
1387                   <li>
1388                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/novlandev">novlandev</span>
1389                     <br />
1390                     <div class="description">
1391 When this file exists, the steps which setup and destroy a VLAN
1392 interface will be skipped. This will override the global
1393 <a class="optionref" href="#global-vlandev">vlandev</a> and the per-guest
1394 <a class="optionref" href="#local-vlandev">vlandev</a>.
1395           </div>
1396                   </li>
1397                   <li>
1398                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/peer">peer</span>
1399                     <br />
1400                     <div class="description">
1401 Sets the peer for a point-to-point link, such as a tun interface.
1402           </div>
1403                   </li>
1404                   <li>
1405                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/prefix">prefix</span>
1406                     <br />
1407                     <div class="description">The network prefix-length.</div>
1408                   </li>
1409                   <li>
1410                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/scope">scope</span>
1411                     <br />
1412                     <div class="description">The scope of the network interface.</div>
1413                   </li>
1414                   <li>
1415                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/shared">shared</span>
1416                     <br />
1417                     <div class="description">
1418 When this file exists, the tun/tap interface created will not be
1419 owned by this particular guest.
1420           </div>
1421                   </li>
1422                   <li>
1423                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/tap">tap</span>
1424                     <br />
1425                     <div class="description">
1426 When this file exists, a tap interface will be created when the guest
1427 starts, and removed when the guest stops.
1428           </div>
1429                   </li>
1430                   <li>
1431                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/tun">tun</span>
1432                     <br />
1433                     <div class="description">
1434 When this file exists, a tun interface will be created when the guest
1435 starts, and removed when the guest stops.
1436           </div>
1437                   </li>
1438                   <li>
1439                     <span class="file" title="/etc/vservers/$vserver-name/interfaces/$iface/uid">uid</span>
1440                     <br />
1441                     <div class="description">
1442 Sets the ownership of tun/tap interfaces. Requires a user id, not a
1443 username.
1444           </div>
1445                   </li>
1446                   <li>
1447                     <span class="boolean" title="/etc/vservers/$vserver-name/interfaces/$iface/vlandev">vlandev</span>
1448                     <br />
1449                     <div class="description">
1450 When this file exists, the steps which setup and destroy a VLAN
1451 interface will be executed.
1452           </div>
1453                   </li>
1454                 </ul>
1455               </li>
1456             </ul>
1457           </li>
1458           <li>
1459             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">ionice</span></span>
1460             <br />
1461             <ul>
1462               <li>
1463                 <span class="file" title="/etc/vservers/$vserver-name/ionice/class">class</span>
1464                 <br />
1465                 <div class="description">The IO scheduling class to use for this guest (see ionice(1)).</div>
1466               </li>
1467               <li>
1468                 <span class="file" title="/etc/vservers/$vserver-name/ionice/priority">priority</span>
1469                 <br />
1470                 <div class="description">The IO scheduling priority to use for this guest (see ionice(1)).</div>
1471               </li>
1472             </ul>
1473           </li>
1474           <li>
1475             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">rlimits</span></span>
1476             <br />
1477             <div class="description">
1478 A directory with resource limits. Possible resources are cpu, fsize,
1479 data, stack, core, rss, nproc, nofile, memlock, as, locks, msgqueue,
1480 nsock, openfd, anon, shmem, semary, nsems and dentry. This
1481 configuration will be honored for kernel 2.6 only.
1482       </div>
1483             <ul>
1484               <li>
1485                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource">resource</span>
1486                 <br />
1487                 <div class="description">
1488 A file which contains the hard- and soft-limit of the given resource
1489 in the first line. The special keyword 'inf' is recognized.
1490         </div>
1491               </li>
1492               <li>
1493                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource.hard">resource.hard</span>
1494                 <br />
1495                 <div class="description">
1496 A file which contains the hard-limit of the given resource in the first
1497 line. The special keyword 'inf' is recognized.
1498         </div>
1499               </li>
1500               <li>
1501                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource.min">resource.min</span>
1502                 <br />
1503                 <div class="description">
1504 A file which contains the guaranteed minimum of the given resource in
1505 the first line. The special keyword 'inf' is recognized.
1506         </div>
1507               </li>
1508               <li>
1509                 <span class="file" title="/etc/vservers/$vserver-name/rlimits/$resource.soft">resource.soft</span>
1510                 <br />
1511                 <div class="description">
1512 A file which contains the soft-limit of the given resource in the first
1513 line. The special keyword 'inf' is recognized.
1514         </div>
1515               </li>
1516             </ul>
1517           </li>
1518           <li id="sched">
1519             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sched</span></span>
1520             <br />
1521             <ul id="sched">
1522               <li id="global-fill-rate">
1523                 <span class="file" title="/etc/vservers/$vserver-name/sched/fill-rate">fill-rate</span>
1524                 <br />
1525                 <div class="description">Amount of tokens to add each <a class="optionref" href="#global-interval">interval</a></div>
1526               </li>
1527               <li id="global-fill-rate2">
1528                 <span class="file" title="/etc/vservers/$vserver-name/sched/fill-rate2">fill-rate2</span>
1529                 <br />
1530                 <div class="description">Amount of tokens to add each <a class="optionref" href="#global-interval2">interval2</a> when advancing idle time</div>
1531               </li>
1532               <li id="global-idle-time">
1533                 <span class="boolean" title="/etc/vservers/$vserver-name/sched/idle-time">idle-time</span>
1534                 <br />
1535                 <div class="description">When this file exists, advancing idle time is activated</div>
1536               </li>
1537               <li id="global-interval">
1538                 <span class="file" title="/etc/vservers/$vserver-name/sched/interval">interval</span>
1539                 <br />
1540                 <div class="description">The interval between refills of the bucket</div>
1541               </li>
1542               <li id="global-interval2">
1543                 <span class="file" title="/etc/vservers/$vserver-name/sched/interval2">interval2</span>
1544                 <br />
1545                 <div class="description">The interval between refills of the bucket when advancing idle time</div>
1546               </li>
1547               <li id="global-priority-bias">
1548                 <span class="file" title="/etc/vservers/$vserver-name/sched/priority-bias">priority-bias</span>
1549                 <br />
1550                 <div class="description">Bias added to priorities calculated within the guest (result is clamped to -20/+19)</div>
1551               </li>
1552               <li id="global-tokens">
1553                 <span class="file" title="/etc/vservers/$vserver-name/sched/tokens">tokens</span>
1554                 <br />
1555                 <div class="description">The initial amount of tokens to put in the bucket</div>
1556               </li>
1557               <li id="global-tokens-max">
1558                 <span class="file" title="/etc/vservers/$vserver-name/sched/tokens-max">tokens-max</span>
1559                 <br />
1560                 <div class="description">The bucket's size</div>
1561               </li>
1562               <li id="global-tokens-min">
1563                 <span class="file" title="/etc/vservers/$vserver-name/sched/tokens-min">tokens-min</span>
1564                 <br />
1565                 <div class="description">The minimum amount of tokens required to unhold the context</div>
1566               </li>
1567               <li>
1568                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sched</span>/<span class="symbolic">cpu-id</span></span>
1569                 <br />
1570                 <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>
1571                 <ul>
1572                   <li>
1573                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/bucket-id">bucket-id</span>
1574                     <br />
1575                     <div class="description">The bucket to apply these settings to</div>
1576                   </li>
1577                   <li id="cpu-id">
1578                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/cpu-id">cpu-id</span>
1579                     <br />
1580                     <div class="description">The CPU to apply these settings to</div>
1581                   </li>
1582                   <li>
1583                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/fill-rate">fill-rate</span>
1584                     <br />
1585                     <div class="description">Amount of tokens to add each <a class="optionref" href="#local-interval">interval</a></div>
1586                   </li>
1587                   <li>
1588                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/fill-rate2">fill-rate2</span>
1589                     <br />
1590                     <div class="description">Amount of tokens to add each <a class="optionref" href="#local-interval2">interval2</a> when advancing idle time</div>
1591                   </li>
1592                   <li>
1593                     <span class="boolean" title="/etc/vservers/$vserver-name/sched/$cpu-id/idle-time">idle-time</span>
1594                     <br />
1595                     <div class="description">When this file exists, advancing idle time is activated</div>
1596                   </li>
1597                   <li id="local-interval">
1598                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/interval">interval</span>
1599                     <br />
1600                     <div class="description">The interval between refills of the bucket</div>
1601                   </li>
1602                   <li id="local-interval2">
1603                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/interval2">interval2</span>
1604                     <br />
1605                     <div class="description">The interval between refills of the bucket when advancing idle time</div>
1606                   </li>
1607                   <li>
1608                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/priority-bias">priority-bias</span>
1609                     <br />
1610                     <div class="description">Bias added to priorities calculated within the guest (result is clamped to -20/+19)</div>
1611                   </li>
1612                   <li>
1613                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/tokens">tokens</span>
1614                     <br />
1615                     <div class="description">The initial amount of tokens to put in the bucket</div>
1616                   </li>
1617                   <li>
1618                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/tokens-max">tokens-max</span>
1619                     <br />
1620                     <div class="description">The bucket's size</div>
1621                   </li>
1622                   <li>
1623                     <span class="file" title="/etc/vservers/$vserver-name/sched/$cpu-id/tokens-min">tokens-min</span>
1624                     <br />
1625                     <div class="description">The minimum amount of tokens required to unhold the context</div>
1626                   </li>
1627                 </ul>
1628               </li>
1629             </ul>
1630           </li>
1631           <li>
1632             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span></span>
1633             <br />
1634             <div class="description">
1635 A directory for scripts. By default, when one of these scripts will be
1636 executed, the execution of defaultscripts (within .../.defaults/scripts)
1637 will be skipped. To execute them nevertheless, the $DONT_SKIP_DEFAULTS
1638 environment variable must be set by one of the in-shellcontext scripts
1639 (the non-executable ones).
1640       </div>
1641             <ul>
1642               <li>
1643                 <span class="script" title="/etc/vservers/$vserver-name/scripts/initialize">initialize</span>
1644                 <br />
1645                 <div class="description">
1646 The scriptlet which will be executed before the root filesystem is mounted and
1647 the configuration has been loaded. Before executing the script, the
1648 configuration directory will be made the working directory.
1649         </div>
1650               </li>
1651               <li>
1652                 <span class="script" title="/etc/vservers/$vserver-name/scripts/post-start">post-start</span>
1653                 <br />
1654                 <div class="description">
1655 The scriptlet which will be executed after the vserver has been
1656 started. Before executing the script, the vserver root directory
1657 will be made the working directory.
1658         </div>
1659               </li>
1660               <li>
1661                 <span class="script" title="/etc/vservers/$vserver-name/scripts/post-stop">post-stop</span>
1662                 <br />
1663                 <div class="description">
1664 The scriptlet which will be executed after the vserver has been
1665 stopped, but before the directories will be umounted and the the
1666 interfaces disabled. Before executing the script, the vserver root
1667 directory will be made the working directory.
1668         </div>
1669               </li>
1670               <li>
1671                 <span class="script" title="/etc/vservers/$vserver-name/scripts/postpost-stop">postpost-stop</span>
1672                 <br />
1673                 <div class="description">
1674 The scriptlet which will be executed after the vserver has been stopped
1675 completely. Before executing the script, the vserver root directory
1676 will be made the working directory.
1677         </div>
1678               </li>
1679               <li>
1680                 <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-start">pre-start</span>
1681                 <br />
1682                 <div class="description">
1683 The scriptlet which will be executed after network-interfaces were
1684 enabled and the directories mounted, but before the vserver itself has
1685 been started.  Before executing the script, the vserver root directory
1686 will be made the working directory.
1687         </div>
1688               </li>
1689               <li>
1690                 <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-stop">pre-stop</span>
1691                 <br />
1692                 <div class="description">
1693 The scriptlet which will be executed before the vserver will be
1694 stopped. Before executing the script, the vserver root directory
1695 will be made the working directory.
1696         </div>
1697               </li>
1698               <li>
1699                 <span class="script" title="/etc/vservers/$vserver-name/scripts/prepre-start">prepre-start</span>
1700                 <br />
1701                 <div class="description">
1702 The scriptlet which will be executed before the network-interfaces are
1703 enabled and the directories are mounted. Before executing the script,
1704 the configuration directory will be made the working directory.
1705         </div>
1706               </li>
1707               <li>
1708                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">initialize.d</span></span>
1709                 <br />
1710                 <div class="description">
1711 Repository of initialize like scripts.  Before executing the script,
1712 the configuration directory will be made the working directory.
1713         </div>
1714                 <ul>
1715                   <li>
1716                     <span class="script" title="/etc/vservers/$vserver-name/scripts/initialize.d/$script">script</span>
1717                     <br />
1718                     <div class="description">See initialize.</div>
1719                   </li>
1720                 </ul>
1721               </li>
1722               <li>
1723                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">post-start.d</span></span>
1724                 <br />
1725                 <div class="description">
1726 Repository of post-start like scripts. Before executing these scripts,
1727 the vserver root directory will be made the working directory.
1728         </div>
1729                 <ul>
1730                   <li>
1731                     <span class="script" title="/etc/vservers/$vserver-name/scripts/post-start.d/$script">script</span>
1732                     <br />
1733                     <div class="description">See post-start.</div>
1734                   </li>
1735                 </ul>
1736               </li>
1737               <li>
1738                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">post-stop.d</span></span>
1739                 <br />
1740                 <div class="description">
1741 Repository of post-stop like scripts. Before executing the script, the
1742 vserver root directory will be made the working directory.
1743         </div>
1744                 <ul>
1745                   <li>
1746                     <span class="script" title="/etc/vservers/$vserver-name/scripts/post-stop.d/$script">script</span>
1747                     <br />
1748                     <div class="description">See post-stop.</div>
1749                   </li>
1750                 </ul>
1751               </li>
1752               <li>
1753                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">postpost-stop.d</span></span>
1754                 <br />
1755                 <div class="description">
1756 Repository of postpost-stop like scripts. Before executing the script,
1757 the vserver root directory will be made the working directory.
1758         </div>
1759                 <ul>
1760                   <li>
1761                     <span class="script" title="/etc/vservers/$vserver-name/scripts/postpost-stop.d/$script">script</span>
1762                     <br />
1763                     <div class="description">See postpost-stop.</div>
1764                   </li>
1765                 </ul>
1766               </li>
1767               <li>
1768                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">pre-start.d</span></span>
1769                 <br />
1770                 <div class="description">
1771 Repository of pre-start like scripts. Before executing these scripts,
1772 the vserver root directory will be made the working directory.
1773         </div>
1774                 <ul>
1775                   <li>
1776                     <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-start.d/$script">script</span>
1777                     <br />
1778                     <div class="description">See pre-start.</div>
1779                   </li>
1780                 </ul>
1781               </li>
1782               <li>
1783                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">pre-stop.d</span></span>
1784                 <br />
1785                 <div class="description">
1786 Repository of pre-stop like scripts. Before executing the script, the
1787 vserver root directory will be made the working directory.
1788         </div>
1789                 <ul>
1790                   <li>
1791                     <span class="script" title="/etc/vservers/$vserver-name/scripts/pre-stop.d/$script">script</span>
1792                     <br />
1793                     <div class="description">See pre-stop.</div>
1794                   </li>
1795                 </ul>
1796               </li>
1797               <li>
1798                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">scripts</span>/<span class="">prepre-start.d</span></span>
1799                 <br />
1800                 <div class="description">
1801 Repository of prepre-start like scripts.  Before executing the script,
1802 the configuration directory will be made the working directory.
1803         </div>
1804                 <ul>
1805                   <li>
1806                     <span class="script" title="/etc/vservers/$vserver-name/scripts/prepre-start.d/$script">script</span>
1807                     <br />
1808                     <div class="description">See prepre-start.</div>
1809                   </li>
1810                 </ul>
1811               </li>
1812             </ul>
1813           </li>
1814           <li>
1815             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">spaces</span></span>
1816             <br />
1817             <ul>
1818               <li>
1819                 <span class="file" title="/etc/vservers/$vserver-name/spaces/mask">mask</span>
1820                 <br />
1821                 <div class="description">Contains a mask of spaces to clone/enter</div>
1822               </li>
1823               <li>
1824                 <span class="boolean" title="/etc/vservers/$vserver-name/spaces/net">net</span>
1825                 <br />
1826                 <div class="description">Enable network virtualization for this guest</div>
1827               </li>
1828               <li>
1829                 <span class="boolean" title="/etc/vservers/$vserver-name/spaces/pid">pid</span>
1830                 <br />
1831                 <div class="description">Enables pid virtualization for this guest</div>
1832               </li>
1833             </ul>
1834           </li>
1835           <li>
1836             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sysctl</span></span>
1837             <br />
1838             <ul>
1839               <li>
1840                 <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">sysctl</span>/<span class="symbolic">x</span></span>
1841                 <br />
1842                 <div class="description">'x' is an arbitrary name, replace it with e.g. integers</div>
1843                 <ul>
1844                   <li>
1845                     <span class="file" title="/etc/vservers/$vserver-name/sysctl/$x/setting">setting</span>
1846                     <br />
1847                     <div class="description">The sysctl setting</div>
1848                   </li>
1849                   <li>
1850                     <span class="file" title="/etc/vservers/$vserver-name/sysctl/$x/value">value</span>
1851                     <br />
1852                     <div class="description">The value</div>
1853                   </li>
1854                 </ul>
1855               </li>
1856             </ul>
1857           </li>
1858           <li>
1859             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">ulimits</span></span>
1860             <br />
1861             <div class="description">
1862 A directory with ulimits. Possible resources are cpu, data, fsize,
1863 locks, memlock, nofile, nproc, rss and/or stack.
1864       </div>
1865             <ul>
1866               <li>
1867                 <span class="file" title="/etc/vservers/$vserver-name/ulimits/$resource">resource</span>
1868                 <br />
1869                 <div class="description">
1870 A file which contains the hard- and soft-limit of the given resource
1871 in the first line. The special keyword 'inf' is recognized.
1872         </div>
1873               </li>
1874               <li>
1875                 <span class="file" title="/etc/vservers/$vserver-name/ulimits/$resource.hard">resource.hard</span>
1876                 <br />
1877                 <div class="description">
1878 A file which contains the hard-limit of the given resource in the first
1879 line. The special keyword 'inf' is recognized.
1880         </div>
1881               </li>
1882               <li>
1883                 <span class="file" title="/etc/vservers/$vserver-name/ulimits/$resource.soft">resource.soft</span>
1884                 <br />
1885                 <div class="description">
1886 A file which contains the soft-limit of the given resource in the first
1887 line. The special keyword 'inf' is recognized.
1888         </div>
1889               </li>
1890             </ul>
1891           </li>
1892           <li>
1893             <span class="directory">/etc/vservers/<span class="symbolic">vserver-name</span>/<span class="">uts</span></span>
1894             <br />
1895             <ul>
1896               <li>
1897                 <span class="file" title="/etc/vservers/$vserver-name/uts/context">context</span>
1898                 <br />
1899                 <div class="description">
1900 The context-name of the vserver. This file is listed for completeness
1901 only; the 'context' name is used and set internally by the util-vserver
1902 tools and can *not* be modified.
1903         </div>
1904               </li>
1905               <li>
1906                 <span class="file" title="/etc/vservers/$vserver-name/uts/domainname">domainname</span>
1907                 <br />
1908                 <div class="description">The NIS domainname of the vserver</div>
1909               </li>
1910               <li>
1911                 <span class="file" title="/etc/vservers/$vserver-name/uts/machine">machine</span>
1912                 <br />
1913                 <div class="description">The machine-type of the vserver</div>
1914               </li>
1915               <li>
1916                 <span class="file" title="/etc/vservers/$vserver-name/uts/nodename">nodename</span>
1917                 <br />
1918                 <div class="description">The node-/hostname of the vserver</div>
1919               </li>
1920               <li>
1921                 <span class="file" title="/etc/vservers/$vserver-name/uts/release">release</span>
1922                 <br />
1923                 <div class="description">The OS-release of the vserver</div>
1924               </li>
1925               <li>
1926                 <span class="file" title="/etc/vservers/$vserver-name/uts/sysname">sysname</span>
1927                 <br />
1928                 <div class="description">The sysname of the vserver</div>
1929               </li>
1930               <li>
1931                 <span class="file" title="/etc/vservers/$vserver-name/uts/version">version</span>
1932                 <br />
1933                 <div class="description">The OS-version of the vserver</div>
1934               </li>
1935             </ul>
1936           </li>
1937         </ul>
1938       </li>
1939     </ul>
1940   </body>
1941 </html>