6ea2052aa8f2abcbd5af750f19e558580684e8a2
[util-vserver.git] / man / vserver.8
1 .TH "vserver" "8" "0.1.0" "Klavs Klavsen <kl@vsen.dk>" "System Administration"
2 .SH "NAME"
3 .LP 
4 vserver \- The vserver utility enables you to control different aspects of your vservers.
5 .SH "SYNTAX"
6 .LP 
7 vserver [ options ] [vserver name] [options]
8
9 .SH "DESCRIPTION"
10 .LP 
11 vserver \- The vserver utility enables you to control different aspects of your vservers, such as stopping and starting them, and services within them.
12 .SH "OPTIONS"
13 .LP 
14 .TP 
15 \fBbuild\fR Create a virtual server by copying the packages of the root server
16 .TP 
17 \fBenter\fR Enter in the virtual server context and starts a shell. Same as "vserver name exec /bin/sh\".
18 .TP 
19 \fBexec\fR Exec a command in the virtual server context as root.
20 syntax: vserver name exec command ...
21 .TP 
22 \fBsuexec\fR Exec a command in the virtual server context under some user id.
23 syntax: vserver name suexec userid command ...
24 .TP 
25 \fBservice\fR Control a service inside a vserver. 
26 syntax: vserver name service service\-name (start/stop/restart etc.)
27 .TP 
28 \fBstart\fR Starts the various services in the vserver.
29 It uses the default runlevel found in the
30 .B /etc/inittab
31 file of the vserver.
32 .TP 
33 \fBstop\fR Ends all services and kills the remaining processes.
34 .TP 
35 \fBrunning\fR Tells if a virtual server is running. It returns proper exit code, so you can use it as a test.
36 .TP
37 \fBstatus\fR Tells various information about the state of a virtual server:
38 running status, number of running processes and uptime.
39 .TP
40 .I --nodev
41 do not configure the IP devices associated with the vserver. This
42 is useful to execute some commands on the vserver (or enter it)
43 without making it active on the network. Especially useful if you
44 have an active copy of the vserver moved to another server on the
45 network.
46 .TP
47 .I --silent
48 cuts most informative messages.
49
50 .SH "FILES"
51 .LP 
52 \fI/usr/sbin/vserver\fP 
53 .P
54 \fI/etc/vservers/*.conf\fP 
55 .P
56 \fI/etc/vservers/*.sh\fP 
57 .P
58 \fI/vservers/*\fP 
59
60 .SH "EXAMPLES"
61 .LP 
62 Please contribute some, if you feel it's important.
63 .SH "AUTHORS"
64 .LP 
65 This Man page was written by Klavs Klavsen <kl@vsen.dk> and based upon the helpful output from the program itself and the documentation on the Virtual Server site <http://www.solucorp.qc.ca/miscprj/s_context.hc?prjstate=1&nodoc=0>
66 .SH "SEE ALSO"
67 .LP 
68 chbind(8) chcontext(8)
69 newvserver(8)
70 rebootmgr(8) reducecap(8)
71 vps(8) vpstree(8)
72 vrpm(8)
73 vserver\-stat(8) 
74 vtop(8)