1VSERVER(8)                   System Administration                  VSERVER(8)
2
3
4

NAME

6       vserver  -  The  vserver  utility  enables  you  to manage the state of
7       vservers, including building, starting, stopping, etc.
8

SYNTAX

10       vserver [-s|--sync]  [-v|--verbose]  [--silent]  [--]  vserver  command
11       [--help] args*
12
13       --sync - Perform synchronization with vshelper to ensure that the guest
14       has been stopped
15
16       --verbose - Makes things a lot louder.
17
18       --silent - Removes most informative messages.
19
20       vserver - The name of a vserver.
21
22       command - One of the commands listed below.
23
24       --help
25
26              provides additional help  for  provided  command,  for  example:
27              vserver  - build --help args are the arguments that are possible
28              for the different commands, see the arguments for  each  command
29              listed below
30

COMMANDS

32       start [--rescue [--rescue-init] program args]
33
34              Starts  the  specified  vserver.  The optional argument --rescue
35              starts the vserver in rescue mode, which runs program  args*  to
36              start  the  vserver  instead  of  whatever  is  configured.  The
37              optional argument --rescue-init makes the command appear as  PID
38              1  in the vserver. This can be used to start /bin/bash to inves‐
39              tigate why a vserver is not able to start correctly.
40
41       stop [--rescue-init]
42
43              Stops the specified vserver, and kills the remaining  processes.
44              The  optional  argument  --rescue-init  can  be  used  to stop a
45              vserver that was started with the option of the same name.
46
47       restart
48
49              Restarts the specified vserver. This is the subsequent execution
50              of a synchronized 'stop' and a 'start'.
51
52       condrestart
53
54              Restarts a running vserver.
55
56       suexec user program args*
57
58              Executes program args* as the specified user in the vserver.
59
60       exec program args*
61
62              Executes program args* as the root user in the vserver.
63
64       enter
65
66              Executes  the configured shell (default: /bin/bash if it exists)
67              in the vserver and allocates a pty.
68
69       chkconfig chkconfig-options*
70
71              Modifies the init-system; currently, only Red Hat's chkconfig is
72              supported.
73
74       running
75
76              Returns an exit code of 0 iff the vserver is running, 1 if not.
77
78       status
79
80              Provides  some  human  readable  status  information  about  the
81              vserver, and succeeds iff the vserver is running.
82
83       build buildopts*
84
85              Create a vserver from scratch, where the buildopts* are a set of
86              options  and a build method. As this option calls vserver-build,
87              please see vserver-build(8) for a complete listing  of  possible
88              options and methods.
89
90       delete
91
92              Remove a vserver.
93
94       unify [-R] [vunify-opts*]
95
96              Unify or de-unify the vserver with its reference vserver(s).
97
98       pkg install pkg*
99
100              Installs package(s) pkg in the vserver.
101
102       apt-get,apt-config,apt-cache apt-opts*
103
104              Execute the apt-* command for the given vserver
105
106       rpm rpm-opts*
107
108              Execute the rpm command for the given vserver.
109
110       pkgmgmt externalize|internalize [-y]
111
112              Externalize  or internalize the package-management for the given
113              vserver.  ´Externalize' means that package metadata and  manage‐
114              ment  tools  (apt-get,rpm) are living in the host, while 'inter‐
115              nalize' means that data and programs from the  vserver  will  be
116              used.
117
118       hashify
119
120              Hashify the vserver.
121

FILES

123       /usr/sbin/vserver
124
125       /etc/vservers/*
126
127       /var/lib/vservers/*
128

EXAMPLES

130       Please contribute some, if you feel it's important.
131

AUTHORS

133       This  man  page  was  written  by Micah Anderson <micah@debian.org> and
134       based upon the helpful output from the program itself.
135

SEE ALSO

137       chbind(8)  chcontext(8)  rebootmgr(8)  reducecap(8)  vps(8)  vpstree(8)
138       vrpm(8) vserver-build(8) vserver-stat(8) vtop(8)
139
140
141
142util-vserver                   October 24, 2007                     VSERVER(8)