vserver.8 (4033B)
1 .TH VSERVER 8 "October 24, 2007" "util-vserver" "System Administration" 2 .SH "NAME" 3 .LP 4 vserver \- The vserver utility enables you to manage the state of vservers, including building, starting, stopping, etc. 5 .SH SYNTAX 6 .B vserver 7 [\fB-s|--sync\fR] [\fB-v|--verbose\fR] [\fB--silent\fR] [\-\-] \fIvserver\fR \fIcommand\fR [\fB--help\fR] \fIargs*\fR 8 .TP 9 \fB\-\-sync\fR - Perform synchronization with vshelper to ensure that the guest has been stopped 10 .TP 11 \fB\-\-verbose\fR - Makes things a lot louder. 12 .TP 13 \fB\-\-silent\fR - Removes most informative messages. 14 .TP 15 \fIvserver\fR - The name of a vserver. 16 .TP 17 \fIcommand\fR - One of the commands listed below. 18 .TP 19 \fB\-\-help\fR 20 .IP 21 provides additional help for provided \fIcommand\fR, for example: vserver - build --help 22 \fIargs\fR are the arguments that are possible for the different commands, see the 23 arguments for each \fIcommand\fR listed below 24 .SH "COMMANDS" 25 .TP 26 \fBstart\fR [\fB\-\-rescue\fR [\fB\-\-rescue\-init\fR] \fIprogram args\fR] 27 .IP 28 \&Starts the specified vserver. The optional argument \fB--rescue\fR starts the 29 vserver in rescue mode, which runs \fIprogram args*\fR to start the vserver 30 instead of whatever is configured. The optional argument \fB--rescue-init\fR 31 makes the command appear as PID 1 in the vserver. This can be used to start 32 /bin/bash to investigate why a vserver is not able to start correctly. 33 .TP 34 \fBstop\fR [\fB\-\-rescue\-init\fR] 35 .IP 36 \&Stops the specified vserver, and kills the remaining processes. The optional 37 argument \fB--rescue-init\fR can be used to stop a vserver that was started 38 with the option of the same name. 39 .TP 40 \fBrestart\fR 41 .IP 42 \&Restarts the specified vserver. This is the subsequent execution of a 43 synchronized 'stop' and a 'start'. 44 .TP 45 \fBcondrestart\fR 46 .IP 47 \&Restarts a running vserver. 48 .TP 49 \fBsuexec\fR \fIuser\fR \fIprogram args*\fR 50 .IP 51 \&Executes \fIprogram args*\fR as the specified \fIuser\fR in the vserver. 52 .TP 53 \fBexec\fR \fIprogram args*\fR 54 .IP 55 \&Executes \fIprogram args*\fR as the root user in the vserver. 56 .TP 57 \fBenter\fR 58 .IP 59 \&Executes the configured shell (default: /bin/bash if it exists) in the 60 vserver and allocates a pty. 61 .TP 62 \fBchkconfig\fR \fIchkconfig\-options*\fR 63 .IP 64 \&Modifies the init\-system; currently, only Red Hat's \fBchkconfig\fR is 65 supported. 66 .TP 67 \fBrunning\fR 68 .IP 69 \&Returns an exit code of 0 iff the vserver is running, 1 if not. 70 .TP 71 \fBstatus\fR 72 .IP 73 \&Provides some human readable status information about the vserver, and 74 succeeds iff the vserver is running. 75 .TP 76 \fBbuild\fR \fIbuildopts*\fR 77 .IP 78 \&Create a vserver from scratch, where the \fIbuildopts*\fR are a set of 79 options and a build method. As this option calls vserver-build, please see 80 vserver-build(8) for a complete listing of possible options and methods. 81 .TP 82 \fBdelete\fR 83 .IP 84 \&Remove a vserver. 85 .TP 86 \fBunify\fR [\fB\-R\fR] [\fIvunify\-opts*\fR] 87 .IP 88 \&Unify or de-unify the vserver with its reference vserver(s). 89 .TP 90 \fBpkg install\fR \fIpkg*\fR 91 .IP 92 \&Installs package(s) \fIpkg\fR in the vserver. 93 .TP 94 \fBapt\-get,apt\-config,apt\-cache\fR \fIapt\-opts*\fR 95 .IP 96 \&Execute the apt\-* command for the given vserver 97 .TP 98 \fBrpm\fR \fIrpm\-opts*\fR 99 .IP 100 \&Execute the \fBrpm\fR command for the given vserver. 101 .TP 102 \fBpkgmgmt\fR \fBexternalize\fR|\fBinternalize\fR [\fB\-y\fR] 103 .IP 104 \&Externalize or internalize the package\-management for the given vserver. 105 \'Externalize' means that package metadata and management tools (apt\-get,rpm) 106 are living in the host, while 'internalize' means that data and programs from 107 the vserver will be used. 108 .TP 109 \fBhashify\fR 110 .IP 111 \&Hashify the vserver. 112 .SH "FILES" 113 .LP 114 \fI/usr/sbin/vserver\fP 115 .P 116 \fI/etc/vservers/*\fP 117 .P 118 .P 119 \fI/var/lib/vservers/*\fP 120 .SH "EXAMPLES" 121 .LP 122 Please contribute some, if you feel it's important. 123 .SH "AUTHORS" 124 .LP 125 This man page was written by Micah Anderson <micah@debian.org> and based upon the helpful output from the program itself. 126 .SH "SEE ALSO" 127 .LP 128 chbind(8) chcontext(8) 129 rebootmgr(8) reducecap(8) 130 vps(8) vpstree(8) 131 vrpm(8) 132 vserver\-build(8) 133 vserver\-stat(8) 134 vtop(8)