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)