debian man page for uml_mconsole

UML_MCONSOLE(1) 					      General Commands Manual						   UML_MCONSOLE(1)

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.

																   UML_MCONSOLE(1)