.TH "UML_MCONSOLE" "1" 
.SH "NAME" 
uml_mconsole \(em attach to the management console of a user-mode Linux 
kernel 
.SH "SYNOPSIS" 
.PP 
\fBuml_mconsole\fR [\fIsocket\fR]  [\fIcommand\fR \&...]  
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBuml_mconsole\fR command. 
.PP 
This manual page was written for the \fBDebian GNU/Linux\fP distribution 
because the original program does not have a manual page. 
.PP 
\fBuml_mconsole\fR is a program to connect to 
the management console of a user-mode Linux kernel.  The UML 
management console is a low-level interface to the kernel, 
somewhat like the i386 SysRq interface. Since there is a 
full-blown operating system under UML, there is much greater 
flexibility possible than with the SysRq mechanism. 
.SH "OPTIONS" 
.IP "\fIsocket\fR" 10 
The pathname of the socket to which to connect.  This 
is printed when UML boots, for example: 
 
.PP 
.nf 
mconsole initialized on /tmp/umlNJ32yL/mconsole 
 
.fi 
 
.IP "" 10 
In this example, you would start uml_mconsole like 
this: 
 
.PP 
.nf 
 
.ft B 
uml_mconsole umlNJ32yL 
.ft              
.fi 
 
.IP "\fIcommand\fR" 10 
Any of the commands listed in the 
\(lqCOMMANDS\(rq section. 
.SH "COMMANDS" 
.IP "version" 10 
Prints the UML version number. 
.IP "halt" 10 
Shuts down the UML system immediately, without syncing 
disks or cleanly shutting down swap space. 
.IP "reboot" 10 
Reboots the UML system immediately, without syncing 
disks or cleanly shutting down swap space. 
.IP "log \fIstring\fR" 10 
Cause UML to log \fIstring\fR to 
the kernel log. 
.IP "cad" 10 
Invokes the Control-Alt-Delete handler. 
.IP "sysrq \fIletter\fR" 10 
Performs the SysRq action controlled by 
\fIletter\fR. 
.IP "stop" 10 
Pauses UML.  UML will do nothing until the 'go' 
command is issued. 
.IP "go" 10 
Resumes execution after a 'stop' command. 
.IP "config \fB\fIdevice\fR\fP" 10 
Adds a new device to the virtual machine, or queries 
the configuration of an existing device.  It takes one 
argument, which is either the device to add, with the same 
syntax as the kernel command line, or the name of an 
existing device.  For example: 
.PP 
.nf 
(mconsole)  
.ft B 
config ubd3=root_fs_debian22 
.ft  
OK 
 
.fi 
.PP 
.nf 
(mconsole)  
.ft B 
config ubd3 
.ft  
OK root_fs_debian22 
 
.fi 
.IP "remove" 10 
Deletes a device from the virtual machine.  Its 
argument is the name of the device to be removed.  In the 
case of the ubd driver, the removed block device must not be 
mounted, swapped on, or otherwise open, and in the case of 
the network driver, the device must be down. 
.PP 
.nf 
(mconsole)  
.ft B 
remove ubd3 
.ft  
OK 
 
.fi 
.SH "SEE ALSO" 
.PP 
linux(1) 
.PP 
The \fIUserModeLinux-HOWTO (link to URL http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO.html) \fR 
.SH "AUTHOR" 
.PP 
uml_mconsole was written by Jeff Dike and others. 
.PP 
This manual page was written by Matt Zimmerman mdz@debian.org for 
the \fBDebian GNU/Linux\fP system, based on material in the 
UserModeLinux-HOWTO by Rusty Russell, and the uml_mconsole 
source code. 
.\" created by instant / docbook-to-man