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