doc/configuration.html

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