X-Git-Url: http://git.linux-vserver.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=util-vserver%2Fdoc%2Fconfiguration.xml;h=48af8e01b42a37df7ca456cb86a0872cb5b33fe7;hb=702ac5383430e4dd00f3610a78dadf6f84e4296b;hp=9453f3b036e82e013510f7a9dae55cb8ee806c9b;hpb=6e7d84cf0bdb34db2f7d9632011537b67a475f7e;p=util-vserver.git diff --git a/util-vserver/doc/configuration.xml b/util-vserver/doc/configuration.xml index 9453f3b..48af8e0 100644 --- a/util-vserver/doc/configuration.xml +++ b/util-vserver/doc/configuration.xml @@ -1,367 +1,921 @@ - - - - The configuration directory of the current vserver - - - The name of the current vserver - - - The fixed value of the current action (e.g. 'prepre-start', 'post-stop', ...). - - "> - - - - - - - - - - -]> - - - - - The base configuration directory. - - - - - Default mtab-file - - - - - - /vservers - - - - - - - /vservers/.pkg - - - - - - - - - - - - - - - - - Contains files with packages. - - File which contains the name of packages. On top of file the special - keywords '--reinstall' and '--can-fail' are possible. - - - - - Directory with GPG pubkeys which are used to sign the packages of this - distribution. - - - - Default content of the /etc/apt/ directory. - - - - Default content of the /etc/rpm directory. - - - - Directory which overrides /usr/lib/rpm. - - - - Directory with all executables and libraries which are required for this - distribution. - - - - - - The configuration directory for the vserver vserver-name. - - - Contains the hostname of the vserver. - - - - Contains the name of the vserver. When not given, the basename of the directory - will be assumed as this name. - - - - The domainname of the vserver. - - - - The nice-level on which the vserver will be started. - - - - Contains per line a capability. - - - - Contains the pathname of the shell which will be used by the "vserver ... enter" - command. - - - - Contains per line a flag. - - - - Contains the context which shall be used for the vserver. - - - - The fstab file for the vserver. - - - - - - The initial-mtab which will be used for the vserver. - - - - Contains the init-style; possible values are 'sysv', 'plain' and - 'minit'. - - - - The start runlevel. - - - - The start runlevel. - - - - The stop runlevel. - - - - Contains the 'signal [wait signal]*' sequence which is used to stop the - vserver. - - - - The command which is used to start the vserver. Each option must be on a - separate line. - - - - The command which is used to wait on the vserver after it has been - started. Each option must be on a separate line. This file will be ignored when the - 'sync' does not exist and the '--sync' option was not used. - - - - The command which is used to stop the vserver. Each option must be on a - separate line. - - - - The command which is used to wait on the vserver after it has been - stopped. Each option must be on a separate line. This file will be ignored when the - 'sync' does not exist and the '--sync' option was not used. - - - - The command which is used to setup the init-system (e.g. to set the runlevel - in the utmp-file). Each option must be on a separate line. - - - - Without this file, the 'cmd.*-sync' files will be ignored. - - - - - - - - &init-dir-text; &init-prepre-start; - - - - - - - - &init-dir-text; &init-pre-start; - - - - - - - - - &init-dir-text; &init-post-start; - - - - - - - - &init-dir-text; &init-pre-stop; - - - - - - - &init-dir-text; &init-post-stop; - - - - - - - &init-dir-text; &init-postpost-stop; - - - - - - - - - The deafult broadcast address. - - - The default network-device. - - - The default network-prefix. - - - The default network-mask. - - - The default scope of the network interfaces. - - - - - When this file exists, this interface will be ignored. - - - - The ip which will be assigned to this interface. - - - The broadcast address. - - - The network-device. - - - The network-prefix. - - - The network-mask. - - - The scope of the network interfaces. - - - When this file exists, the interface will be named. - - - - - - - - - + + + + + + + + Default mtab file + + + + + /vservers + + + + + + /vservers/.pkg + + + + The default apt.conf which is going to be used. It is overridden by + distribution specific configuration file. + + + + + + + + The Debian mirror to use with the 'debootstrap' program + + + + + When the 'debootstrap' package is not installed; fetch it from this uri and + install it at a temporary place. + + + + + + + + A list of files which will be made visibly by vprocunhide. Wildcards are + allowed and anything ending in '/' will be processed recursively. When this file exists, + it overrides the defaults in SYSDEFAULTDIR/vprocunhide-files. The entries there must be + absolute filenames inclusive the leading '/proc'. + + + + + + + + A symlink to the TTY device where input/output will be redirected from/to + at startup via initscript. + + + + + + + + Static list of excluded files. + + + + + + + + + + + + + + The default apt.conf which is going to be used. It overrides the apt.conf + from CONFDIR/.defaults/apps/pkgmgmt. + + + + + Script which will be executed before packages will be installed. + + + + + The configuration directory of the vserver which is going to be set up. + + + + + The pathname of the vserver binary. + + + + + + + Script which will be executed after packages are installed. + + + + + The configuration directory of the vserver which is going to be set up. + + + + + The pathname of the vserver binary. + + + + + + + + Contains files with packages. + + + + File which contains the name of packages. On top of file the special + keywords '--reinstall' and '--can-fail' are possible. + + + + + + + Directory with GPG pubkeys which are used to sign the packages of this + distribution. + + + + + + Default content of the /etc/apt/ directory. + + + + + + Default content of the /etc/rpm directory. + + + + + + Directory which overrides /usr/lib/rpm. + + + + + Directory with all executables and libraries which are required for this + distribution. + + + + + + + + + + The configuration directory for the vserver vserver-name. + + + + + Path of the vserver root directory + + + + + + Path of the vserver run directory + + + + + + Path of the vserver run reverse directory + + + + + + [experimental; name is subject of possible change] Contains the system capabilities. See + lib/bcaps-v13.c + for possible values. + + + + + [experimental; name is subject of possible change] Contains the context capabilities. See + lib/ccaps-v13.c + for possible values. + + + + + [experimental; name is subject of possible change] Contains the scheduler parameters, + one per line. + + The Hard CPU limit uses a mechanism called a Token Bucket. + the concept is simple: you have a bucket of a certain size + which is filled with a specified amount R of tokens each + interval T until the maximum is reached (excess tokens + are spilled). At each timer tick, a running process consumes + one token from the bucket, unless the bucket is empty. If the + bucket is empty the process is put in the hold queue. When the + bucket has been refilled to at least M tokens, all on hold + processes are rescheduled. + + + + + Amount of tokens append to the bucket each interval. + + + + + The intervall between refills of amount 'fill_rate'. This value is express in ticks. + + + + + Initial bucket contents. + + + + + The minimum amount of tokens required to unhold processes + + + + + The bucket size. + + + + + Unused at the moment. + + + + + + + Contains the hostname of the vserver. Same as uts/nodename. + + + + + Contains the name of the vserver. When not given, the basename of the directory + will be assumed as this name. + + + + + The domainname of the vserver. Same as uts/domainname. + + + + + The nice-level on which the vserver will be started. + + + + + Contains per line a capability. This file is used for the 2.4 + kernel only; for 2.6 use 'bcapabilities'. + + + + + Contains the pathname of the shell which will be used by the "vserver ... enter" + command. + + + + + Contains per line a flag. See + lib/cflags-v13.c + for possible values. + + + + + The new process will believe it is process number 1. Useful to run a real + /sbin/init in a vserver. + + + + + The new process is trapped and can't use chcontext anymore. + + + + + The new process and its children will share a common + + + + + Limit the number of process in the vserver according to + ulimit setting. Normally, ulimit is a per user thing. + With this flag, it becomes a per vserver thing. + + + + + No one can join this security context once created. + + + + + Apply the current ulimit to the whole context + + + + + + + Contains the context which shall be used for the vserver. + + + + + The fstab file for the vserver. Entries in this file will be mounted within the + network context of the vserver; this means that mount will be called as 'chbind <options> + mount ...'. Use the 'fstab.local' file when you do not want this behavior, but in most cases + the 'fstab' file should be used. + + + + + The fstab file for the vserver. In opposite to the normal 'fstab' file, the + mounting happens in the local network context. Currently there is no way to mix entries of + both files; 'fstab' will be always processed before 'fstab.local'. + + + + + + + + The initial-mtab which will be used for the vserver. + + + + + + Contains the init-style. + + + + + + + + + + + The start runlevel. + + + + The start runlevel. + + + + The stop runlevel. + + + + + Contains the 'signal [wait signal]*' sequence which is used to stop the + vserver. + + + + + + The command which is used to start the vserver. Each option must be on a + separate line. + + + + + + The command which is used to wait on the vserver after it has been + started. Each option must be on a separate line. This file will be ignored when the + 'sync' does not exist and the '--sync' option was not used. + + + + + + The command which is used to stop the vserver. Each option must be on a + separate line. + + + + + + The command which is used to wait on the vserver after it has been + stopped. Each option must be on a separate line. This file will be ignored when the + 'sync' does not exist and the '--sync' option was not used. + + + + + + The command which is used to setup the init-system (e.g. to set the runlevel + in the utmp-file). Each option must be on a separate line. + + + + + + If this file is not present, all 'cmd.*-sync files will be ignored. + + + + + + A symlink to the TTY device where input/output will be redirected from/to + at startup via initscript. + + + + + + This file is used to mark group of vservers which shall be started/stopped + together by the initscript. Content is a simple string like 'default'. + + + + + + This file is used to configure vservers which must be running before the + current vserver can be started. At shutdown, the current vserver will be stopped before + its dependencies. Content of this file are vserver ids (one name per line). + + + + + + + + The timeout in seconds which is used when synchronising vserver startup/shutdown + with the vshelper. When no set, 30 seconds will be assumed. + + 30 + + + + + The action which is going to be executed when a vshelper event occurs. The + default value is 'restart', but there can be defined own methods by placing scripts into + the 'vshelper-methods' directories. These scripts are fed with the same arguments as the + 'vshelper' script. + + restart + + + + + When existing. these scripts will be executed *instead* of the default + handler defined in 'action'. Their name must match the event which caused the execution + of 'vshelper'; e.g. 'restart' or 'poweroff'. See the vs_reboot() function in the kernel + for more details. + + + + The xid of the context calling the vshelper + + + The reboot-event + + + + + + + When existing, the vshelper functionality will be disabled for this + vserver. + + + + + + When existing, sanity checks for the vshelper functionality will be + skipped. + + + + + + The file where output will be logged to when 'vshelper' is invoked from the + kernel. This should point somewhere e.g. into /var/log. + + + + + + + + See vshelper/action. + + + + + + + This directory contains configuration data required for vserver + unification. + + + + + Static list of excluded files. This list supports an rsync syntax: when a + file is prefixed by '+', it is a candidate for unification; when there is no prefix or a + '-' it will be excluded. Shell-wildcards are allowed for the filenames. + + + + + + These are symlinks to the configuration directory + (e.g. CONFDIR/vservers/<id>) of a refserver. There may be multiple such symlinks + but they must be prefixed by 'refserver.' and will be processed in alphanumerical + order. + + + + + + + + A directory for scripts. By default, when one of these scripts will be executed, + the execution of defaultscripts (within .../.defaults/scripts) will be skipped. To execute + them nevertheless, the $DONT_SKIP_DEFAULTS environment variable must be set by one of the + in-shellcontext scripts (the non-executable ones). + + + + + The scriptlet which will be executed before the network-interfaces are enabled + and the directories are mounted." + + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + Repository of prepre-start like scripts + + + See prepre-start. + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + + + The scriptlet which will be executed after network-interfaces were enabled and + the directories mounted, but before the vserver itself has been started. + + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + Repository of pre-start like scripts + + + See pre-start. + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + + + + The scriptlet which will be executed after the vserver has been started. + + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + Repository of post-start like scripts + + + See post-start. + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + + + + The scriptlet which will be executed before the vserver will be stopped. + + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + Repository of pre-stop like scripts + + + See pre-stop. + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + + + The scriptlet which will be executed after the vserver has been stopped, but + before the directories will be umounted and the the interfaces + disabled. + + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + Repository of post-stop like scripts + + + See post-stop. + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + + + The scriptlet which will be executed after the vserver has been stopped + completely. + + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + Repository of postpost-stop like scripts + + + See postpost-stop. + + + The configuration directory of the current vserver. + + + The name of the current vserver. + + + The fixed value of the current action (e.g. 'prepre-start', 'post-stop'...). + + + + + + + + + The default broadcast address. + + + The default network device. + + + The default network prefix. + + + The default network mask. + + + The default scope of the network interfaces. + + + + + 'iface' is an arbitrary name for the interface; the value itself is not important + but may be interesting regarding interface-creation and usage with 'chbind'. Both happens in + alphabetical order and numbers like '00' are good names for these directories. + + + + When this file exists, this interface will be ignored. + + + + The ip which will be assigned to this interface. + + + The broadcast address. + + + The network device. + + + The network prefix. + + + The network mask. + + + The scope of the network interface. + + + + When this file exists, the interface will be named with the text in this file. + + + + + When this file exists, the interface will be assumed to exist already. + + + + + + + + A directory with ulimits. Possible resources are cpu, data, fsize, locks, + memlock, nofile, nproc, rss and/or stack. This configuration will be honored + for kernel 2.4 only. + + + + A file which contains the hard- and soft-limit of the given resource in the + first line. The special keyword 'inf' is recognized. + + + + + A file which contains the hard- of the given resource in the first line. The + special keyword 'inf' is recognized. + + + + + A file which contains the soft- of the given resource in the first line. The + special keyword 'inf' is recognized. + + + + + + + A directory with resource limits. Possible resources are cpu, data, fsize, locks, + memlock, nofile, nproc, rss and/or stack. This configuration will be honored + for kernel 2.6 only. + + + + A file which contains the hard- and soft-limit of the given resource in the + first line. The special keyword 'inf' is recognized. + + + + + A file which contains the hard- of the given resource in the first line. The + special keyword 'inf' is recognized. + + + + + A file which contains the soft- of the given resource in the first line. The + special keyword 'inf' is recognized. + + + + + A file which contains the guaranted minimum of the given resource in the first line. The + special keyword 'inf' is recognized. + + + + + + + + The context-name of the vserver. This file is listed for completeness only; + the 'context' name is used and set internally by the util-vserver tools and can *not* be + modified. + + + + The sysname of the vserver + + + The node-/hostname of the vserver + + + The OS-release of the vserver + + + The OS-version of the vserver + + + The machine-type of the vserver + + + The NIS domainname of the vserver + + + +