-
badness
Contains the bias to be applied to processes in this guest when the OOM-killer strikes.
-
bcapabilities
-
cache
Path of the storage area for cached information about this vserver.
-
capabilities
Contains per line a capability. This file is used for the 2.4 kernel
only; for 2.6 use
bcapabilities.
-
ccapabilities
Contains the context capabilities. See
lib/ccaps-v13.c
for possible values.
-
cflags
-
context
Contains the context id which shall be used for the vserver. Valid range is 2 through 49151.
-
flags
Old name for
cflags. Deprecated.
-
fstab
The fstab file for the vserver. Entries in this file will be mounted
within the network context of the host. Use the
fstab.remote file when you want that the
mounting happens in the network context of the vserver. In most cases
the 'fstab' file should be used.
-
fstab.remote
The fstab file for the vserver. Entries in this file will be mounted
within the network context of the guest; this means that mount will be
called as
chbind <options> mount ...
. See
fstab also.
-
name
Contains the name of the vserver. When not given, the basename of the directory
will be assumed as this name.
-
namespace
Overrides the global
nonamespace flag and enables
namespace usage for the current vserver.
-
namespace-cleanup
Overrides the global
nonamespace-cleanup flag and enables
namespace cleanup for the current vserver.
-
namespace-cleanup-skip
-
ncapabilities
Contains the network capabilities. See
lib/ncaps-net.c
for possible values.
-
ncontext
Contains the network context id which shall be used for the vserver. Valid range is 2 through 49151.
-
nflags
-
nice
The nice-level on which the vserver will be started.
-
nocgroup
-
nonamespace
Disables namespace usage for the current vserver.
In this mode the /vservers directory must have
the 'barrier' attribute. Else, common chroot(2) exploits are possible.
-
noncontext
When this file exists, it disables network isolation for this guest. Typically used with netns.
-
nonetns
-
personality
Used to set the personality of the vserver. First line in the file
is the personality-type followed by flags (one item per line). See
/usr/include/linux/personality.h for possible
values.
-
run
Points to a file which will contain the XID of the running vserver. When
the vserver is stopped, this can be a dangling symlink.
-
schedule
[deprecated; use
sched instead] 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.
See the
Linux
VServer Wiki for more information about this file.
-
shell
Contains the pathname of the shell which will be used by the "vserver
... enter" command.
-
tag
Contains the filesystem tag which shall be used for the vserver. Valid range is 2 through 49151.
-
umask
Contains the namespaces allowed to be unshared. See
lib/umask-v23.c
for possible values.
-
vdir
Path of the vserver root directory.
-
/etc/vservers/vserver-name/apps
-
/etc/vservers/vserver-name/cgroup
This directory contains cgroup settings to be applied to this guest.
See your kernel documentation for what settings are valid with your
configuration.
-
name
If this file exists, the guest will be put in a cgroup named after the
contents of this file. The default is to name the cgroup the same thing as the
guest, unless
.defaults/cgroup/name says
otherwise.
-
/etc/vservers/vserver-name/cpuset
Puts the guest in a cpuset. Required entries are name, cpus and mems.
-
cpu_exclusive
Is the CPU assignment exclusive?
-
cpus
The list of CPUs in this cpuset
-
mems
The list of Memory Nodes in this cpuset
-
mems_exclusive
Is the memory node assignment exclusive?
-
name
The name of the cpuset for this vserver
-
nocreate
When this file exists, the cpuset will be assumed to exist already
-
/etc/vservers/vserver-name/dlimits
Note that all entries are required for the disk limit to be applied.
-
/etc/vservers/vserver-name/interfaces
-
bcast
The guest's broadcast address.
-
dev
The default network device. See
iface/dev for more information.
-
lback
The guest's loopback address.
-
mask
The default network mask.
-
novlandev
When this file exists, the steps which setup and destroy a VLAN
interface will be skipped. This overrides the global
vlandev setting for
this vserver.
-
prefix
The default network prefix-length.
-
scope
The default scope of the network interfaces.
-
vlandev
When this file exists, the steps which setup and destroy a VLAN
interface will be executed for all interfaces of this vserver.
-
/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.
-
dev
The network device. When this is specified, the IP address will be assigned and removed when starting and stopping the guest.
-
disabled
When this file exists, this interface will be ignored.
-
gid
Sets the group ownership of tun/tap interfaces. Requires a group id,
not a group name.
-
ip
The IP address which will be assigned to this interface.
-
linktype
Sets the link type of tun/tap interfaces.
-
mask
The network mask.
-
name
When this file exists, the interface will be named with the text in
this file. Without such an entry, the IP will not be shown by
ifconfig
but by ip addr ls
only. Such
a labeled interface is known as an "alias" also (e.g. 'eth0:foo').
-
nocsum
If a tun or tap interface is created, the presence of this file will
disable checksumming on it.
-
nodev
When this file exists, the interface will be assumed to exist
already. This can be used to assign primary interfaces which are
created by the host or another vserver.
-
novlandev
When this file exists, the steps which setup and destroy a VLAN
interface will be skipped. This will override the global
vlandev and the per-guest
vlandev.
-
peer
Sets the peer for a point-to-point link, such as a tun interface.
-
prefix
The network prefix-length.
-
scope
The scope of the network interface.
-
shared
When this file exists, the tun/tap interface created will not be
owned by this particular guest.
-
tap
When this file exists, a tap interface will be created when the guest
starts, and removed when the guest stops.
-
tun
When this file exists, a tun interface will be created when the guest
starts, and removed when the guest stops.
-
uid
Sets the ownership of tun/tap interfaces. Requires a user id, not a
username.
-
vlandev
When this file exists, the steps which setup and destroy a VLAN
interface will be executed.
-
/etc/vservers/vserver-name/ionice
-
/etc/vservers/vserver-name/netns
When this directory exists, a network namespace will be used for this guest.
Note that you typically will want to
disable
network isolation when using network namespaces.
-
name
The name of the network namespace to use for the guest. Defaults to the
guest's name.
-
shared
Whether or not util-vserver should add and delete the network namespace when
the guest is started and stopped, respectively.
-
/etc/vservers/vserver-name/netns/interfaces
-
/etc/vservers/vserver-name/netns/interfaces/iface
'iface' is an arbitrary name for the interface; the value itself is
not important but may be interesting regarding interface-creation.
It happens in alphabetical order and numbers like '00' are good names for
these directories.
For each of these directories, a pair of network interfaces will be created,
one left on the host, and the other moved into the guest's namespace.
-
guest
Name of the interface in the guest. Defaults to gethX, where X starts at 0
and increases for every interface.
-
host
Name of the interface on the host.
-
type
Type of link to create. Defaults to veth.
-
/etc/vservers/vserver-name/rlimits
A directory with resource limits. Possible resources are cpu, fsize,
data, stack, core, rss, nproc, nofile, memlock, as, locks, msgqueue,
nsock, openfd, anon, shmem, semary, nsems and dentry. 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-limit of the given resource in the first
line. The special keyword 'inf' is recognized.
-
resource.min
A file which contains the guaranteed minimum of the given resource in
the first line. The special keyword 'inf' is recognized.
-
resource.soft
A file which contains the soft-limit of the given resource in the first
line. The special keyword 'inf' is recognized.
-
/etc/vservers/vserver-name/sched
-
fill-rate
-
fill-rate2
Amount of tokens to add each
interval2 when advancing idle time
-
idle-time
When this file exists, advancing idle time is activated
-
interval
The interval between refills of the bucket
-
interval2
The interval between refills of the bucket when advancing idle time
-
priority-bias
Bias added to priorities calculated within the guest (result is clamped to -20/+19)
-
tokens
The initial amount of tokens to put in the bucket
-
tokens-max
The bucket's size
-
tokens-min
The minimum amount of tokens required to unhold the context
-
/etc/vservers/vserver-name/sched/cpu-id
This directory contains per-CPU and/or per-bucket specific settings. Remember to set the
cpu-id file. All CPUs inherit the global settings.
-
bucket-id
The bucket to apply these settings to
-
cpu-id
The CPU to apply these settings to
-
fill-rate
-
fill-rate2
Amount of tokens to add each
interval2 when advancing idle time
-
idle-time
When this file exists, advancing idle time is activated
-
interval
The interval between refills of the bucket
-
interval2
The interval between refills of the bucket when advancing idle time
-
priority-bias
Bias added to priorities calculated within the guest (result is clamped to -20/+19)
-
tokens
The initial amount of tokens to put in the bucket
-
tokens-max
The bucket's size
-
tokens-min
The minimum amount of tokens required to unhold the context
-
/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).
-
initialize
The scriptlet which will be executed before the root filesystem is mounted and
the configuration has been loaded. Before executing the script, the
configuration directory will be made the working directory.
-
post-start
The scriptlet which will be executed after the vserver has been
started. Before executing the script, the vserver root directory
will be made the working directory.
-
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. Before executing the script, the vserver root
directory will be made the working directory.
-
postpost-stop
The scriptlet which will be executed after the vserver has been stopped
completely. Before executing the script, the vserver root directory
will be made the working directory.
-
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. Before executing the script, the vserver root directory
will be made the working directory.
-
pre-stop
The scriptlet which will be executed before the vserver will be
stopped. Before executing the script, the vserver root directory
will be made the working directory.
-
prepre-start
The scriptlet which will be executed before the network-interfaces are
enabled and the directories are mounted. Before executing the script,
the configuration directory will be made the working directory.
-
/etc/vservers/vserver-name/scripts/initialize.d
Repository of initialize like scripts. Before executing the script,
the configuration directory will be made the working directory.
-
/etc/vservers/vserver-name/scripts/post-start.d
Repository of post-start like scripts. Before executing these scripts,
the vserver root directory will be made the working directory.
-
/etc/vservers/vserver-name/scripts/post-stop.d
Repository of post-stop like scripts. Before executing the script, the
vserver root directory will be made the working directory.
-
/etc/vservers/vserver-name/scripts/postpost-stop.d
Repository of postpost-stop like scripts. Before executing the script,
the vserver root directory will be made the working directory.
-
script
See postpost-stop.
-
/etc/vservers/vserver-name/scripts/pre-start.d
Repository of pre-start like scripts. Before executing these scripts,
the vserver root directory will be made the working directory.
-
/etc/vservers/vserver-name/scripts/pre-stop.d
Repository of pre-stop like scripts. Before executing the script, the
vserver root directory will be made the working directory.
-
/etc/vservers/vserver-name/scripts/prepre-start.d
Repository of prepre-start like scripts. Before executing the script,
the configuration directory will be made the working directory.
-
/etc/vservers/vserver-name/spaces
-
mask
Contains a mask of spaces to clone/enter
-
net
Enable network virtualization for this guest
-
pid
Enables pid virtualization for this guest
-
/etc/vservers/vserver-name/sysctl
-
/etc/vservers/vserver-name/ulimits
A directory with ulimits. Possible resources are cpu, data, fsize,
locks, memlock, nofile, nproc, rss and/or stack.
-
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-limit of the given resource in the first
line. The special keyword 'inf' is recognized.
-
resource.soft
A file which contains the soft-limit 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