UML_MCONSOLE
Section: User Commands (1)
Index
Return to Main Contents
NAME
uml_mconsole --- attach to the management console of a user-mode Linux
kernel
SYNOPSIS
uml_mconsole [socket] [command ...]
DESCRIPTION
This manual page documents briefly the
uml_mconsole command.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
uml_mconsole 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.
OPTIONS
- socket
-
The pathname of the socket to which to connect. This
is printed when UML boots, for example:
mconsole initialized on /tmp/umlNJ32yL/mconsole
-
In this example, you would start uml_mconsole like
this:
uml_mconsole umlNJ32yL
- command
-
Any of the commands listed in the
"COMMANDS" section.
COMMANDS
- version
-
Prints the UML version number.
- halt
-
Shuts down the UML system immediately, without syncing
disks or cleanly shutting down swap space.
- reboot
-
Reboots the UML system immediately, without syncing
disks or cleanly shutting down swap space.
- log string
-
Cause UML to log string to
the kernel log.
- cad
-
Invokes the Control-Alt-Delete handler.
- sysrq letter
-
Performs the SysRq action controlled by
letter.
- stop
-
Pauses UML. UML will do nothing until the 'go'
command is issued.
- go
-
Resumes execution after a 'stop' command.
- config device
-
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:
(mconsole)
config ubd3=root_fs_debian22
OK
(mconsole)
config ubd3
OK root_fs_debian22
- remove
-
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.
(mconsole)
remove ubd3
OK
SEE ALSO
linux(1)
The UserModeLinux-HOWTO (link to URL http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO.html)
AUTHOR
uml_mconsole was written by Jeff Dike and others.
This manual page was written by Matt Zimmerman mdz@debian.org for
the Debian GNU/Linux system, based on material in the
UserModeLinux-HOWTO by Rusty Russell, and the uml_mconsole
source code.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- COMMANDS
-
- SEE ALSO
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 19:49:17 GMT, April 27, 2011