The content of the /etc/vservers directory
-
/etc/vservers/vserver-name
The configuration directory for the vserver vserver-name.
-
bcapabilities
[experimental; name is subject of possible change] Contains the system capabilities. See
lib/bcaps-v13.c
for possible values.
-
capabilities
Contains per line a capability. This file is used for the 2.4
kernel only; for 2.6 use 'bcapabilities'.
-
ccapabilities
[experimental; name is subject of possible change] Contains the context capabilities. See
lib/ccaps-v13.c
for possible values.
-
context
Contains the context which shall be used for the vserver.
-
domainname
The domainname of the vserver. Same as uts/domainname.
-
flags
Contains per line a flag. See
lib/cflags-v13.c
for possible values.
-
fstab
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.
-
fstab.local
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'.
-
hostname
Contains the hostname of the vserver. Same as uts/nodename.
-
name
Contains the name of the vserver. When not given, the basename of the directory
will be assumed as this name.
-
nice
The nice-level on which the vserver will be started.
-
run
Path of the vserver run directory
-
run.rev
Path of the vserver run reverse directory
-
schedule
[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.
-
shell
Contains the pathname of the shell which will be used by the "vserver ... enter"
command.
-
vdir
Path of the vserver root directory
-
/etc/vservers/vserver-name/apps
-
/etc/vservers/vserver-name/apps/init
-
cmd.prepare
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.
-
cmd.start
The command which is used to start the vserver. Each option must be on a
separate line.
-
cmd.start-sync
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.
-
cmd.stop
The command which is used to stop the vserver. Each option must be on a
separate line.
-
cmd.stop-sync
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.
-
depends
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).
-
killseq
Contains the 'signal [wait signal]*' sequence which is used to stop the
vserver.
-
mark
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'.
-
mtab
The initial-mtab which will be used for the vserver.
-
runlevel
The start runlevel.
-
runlevel.start
The start runlevel.
-
runlevel.stop
The stop runlevel.
-
style
Contains the init-style.
-
sync
If this file is not present, all 'cmd.*-sync files will be ignored.
-
tty
A symlink to the TTY device where input/output will be redirected from/to
at startup via initscript.
-
/etc/vservers/vserver-name/apps/vshelper
-
action
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.
-
disabled
When existing, the vshelper functionality will be disabled for this
vserver.
-
event
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.
-
logfile
The file where output will be logged to when 'vshelper' is invoked from the
kernel. This should point somewhere e.g. into /var/log.
-
sync-timeout
The timeout in seconds which is used when synchronising vserver startup/shutdown
with the vshelper. When no set, 30 seconds will be assumed.
-
warning-disabled
When existing, sanity checks for the vshelper functionality will be
skipped.
-
/etc/vservers/vserver-name/apps/vshelper-methods
-
handler
See vshelper/action.
-
/etc/vservers/vserver-name/apps/vunify
This directory contains configuration data required for vserver
unification.
-
exclude
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.
-
refserver.X
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.
-
/etc/vservers/vserver-name/interfaces
-
bcast
The default broadcast address.
-
dev
The default network device.
-
mask
The default network mask.
-
prefix
The default network prefix.
-
scope
The default scope of the network interfaces.
-
/etc/vservers/vserver-name/interfaces/iface
'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.
-
bcast
The broadcast address.
-
dev
The network device.
-
disabled
When this file exists, this interface will be ignored.
-
ip
The ip which will be assigned to this interface.
-
mask
The network mask.
-
name
When this file exists, the interface will be named with the text in this file.
-
nodev
When this file exists, the interface will be assumed to exist already.
-
prefix
The network prefix.
-
scope
The scope of the network interface.
-
/etc/vservers/vserver-name/rlimits
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.
-
resource
A file which contains the hard- and soft-limit of the given resource in the
first line. The special keyword 'inf' is recognized.
-
resource.hard
A file which contains the hard- of the given resource in the first line. The
special keyword 'inf' is recognized.
-
resource.min
A file which contains the guaranted minimum of the given resource in the first line. The
special keyword 'inf' is recognized.
-
resource.soft
A file which contains the soft- of the given resource in the first line. The
special keyword 'inf' is recognized.
-
/etc/vservers/vserver-name/scripts
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).
-
postpost-stop
The scriptlet which will be executed after the vserver has been stopped
completely.
-
post-start
The scriptlet which will be executed after the vserver has been started.
-
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.
-
prepre-start
The scriptlet which will be executed before the network-interfaces are enabled
and the directories are mounted."
-
pre-start
The scriptlet which will be executed after network-interfaces were enabled and
the directories mounted, but before the vserver itself has been started.
-
pre-stop
The scriptlet which will be executed before the vserver will be stopped.
-
/etc/vservers/vserver-name/scripts/postpost-stop.d
Repository of postpost-stop like scripts
-
script
See postpost-stop.
-
/etc/vservers/vserver-name/scripts/post-start.d
Repository of post-start like scripts
-
/etc/vservers/vserver-name/scripts/post-stop.d
Repository of post-stop like scripts
-
/etc/vservers/vserver-name/scripts/prepre-start.d
Repository of prepre-start like scripts
-
/etc/vservers/vserver-name/scripts/pre-start.d
Repository of pre-start like scripts
-
/etc/vservers/vserver-name/scripts/pre-stop.d
Repository of pre-stop like scripts
-
/etc/vservers/vserver-name/ulimits
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.
-
resource
A file which contains the hard- and soft-limit of the given resource in the
first line. The special keyword 'inf' is recognized.
-
resource.hard
A file which contains the hard- of the given resource in the first line. The
special keyword 'inf' is recognized.
-
resource.soft
A file which contains the soft- of the given resource in the first line. The
special keyword 'inf' is recognized.
-
/etc/vservers/vserver-name/uts
-
context
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.
-
domainname
The NIS domainname of the vserver
-
machine
The machine-type of the vserver
-
nodename
The node-/hostname of the vserver
-
release
The OS-release of the vserver
-
sysname
The sysname of the vserver
-
version
The OS-version of the vserver
/etc/vservers/.default
-
vdirbase
-
/etc/vservers/.default/apps
-
/etc/vservers/.default/apps/debootstrap
-
mirror
The Debian mirror to use with the 'debootstrap' program
-
uri
When the 'debootstrap' package is not installed; fetch it from this uri and
install it at a temporary place.
-
/etc/vservers/.default/apps/init
-
tty
A symlink to the TTY device where input/output will be redirected from/to
at startup via initscript.
-
/etc/vservers/.default/apps/pkgmgmt
-
apt.conf
The default apt.conf which is going to be used. It is overridden by
distribution specific configuration file.
-
base
-
/etc/vservers/.default/apps/vprocunhide
-
files
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'.
-
/etc/vservers/.default/apps/vunify
-
exclude
Static list of excluded files.
/etc/vservers/.default/init
/etc/vservers/.default/.distributions
/etc/vservers/.default/.distributions/dist
-
apt.conf
The default apt.conf which is going to be used. It overrides the apt.conf
from CONFDIR/.defaults/apps/pkgmgmt.
-
dev
-
execdir
Directory with all executables and libraries which are required for this
distribution.
-
initpost
Script which will be executed after packages are installed.
-
initpre
Script which will be executed before packages will be installed.
-
rpmlib
Directory which overrides /usr/lib/rpm.
-
/etc/vservers/.default/.distributions/dist/apt
Default content of the /etc/apt/ directory.
-
/etc/vservers/.default/.distributions/dist/pkgs
Contains files with packages.
-
list
File which contains the name of packages. On top of file the special
keywords '--reinstall' and '--can-fail' are possible.
-
/etc/vservers/.default/.distributions/dist/pubkeys
Directory with GPG pubkeys which are used to sign the packages of this
distribution.
-
/etc/vservers/.default/.distributions/dist/rpm
Default content of the /etc/rpm directory.