vshost-util-vserver

Build script and sources for util-vserver.
git clone https://ccx.te2000.cz/git/vshost-util-vserver
Log | Files | Refs

configuration.html (96865B)


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