uml_mconsole(1)



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  be-
       cause 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  in-
       terface  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 con-
                 figuration 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.source-
       forge.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)

Man(1) output converted with man2html
list of all man pages