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