umlmon

umlmon − Monitor daemon for User Mode Linux

umlmon [OPTION] vmname

The umlmon daemon controls the environment and the execution of a single User Mode Linux (UML) kernel.

The virtual machine must be configured in the configuration file(s). After execution, the umlmon daemon installs the RPC interface, puts itself into the background, and wait for commands arriving on the RPC interface. It does not start the UML kernel automatically.

−fg

The daemon remains in the foreground. (This may be useful to debug problems.)

−version

Outputs the version number and exits.

These are the default locations of the files. One can change the locations in /etc/umlmon.

/etc/umlmon:

The main configuration file, see umlmon(5) for a description.

/var/run/umlmon/vmname.pid:

The process ID of the daemon.

/var/lib/umlmon/vmname:

This directory hierarchy contains the data and runtime files of the virtual machine.

/var/lib/umlmon/vmname/ctrl:

This is the Unix Domain socket connecting to the RPC interface of the daemon.

/var/lib/umlmon/vmname/config:

These are the user changes of the configuration. These settings override the settings in /etc/umlmon.

/var/lib/umlmon/vmname/jail:

This directory is prepared as chroot jail for the UML kernel.

/var/lib/umlmon/shared:

This directory is the shared part of all UML jails. It contains several administrative files (locks and macpool) that must not be changed by the user.

The daemon mounts a number of file systems:

/var/lib/umlmon/vmname/jail/shared:

This is a bind mount of /var/lib/umlmon/shared. This mount is performed immediately after the daemon starts.

/var/lib/umlmon/vmname/jail/tmp:

This is a tmpfs filesystem of the appropriate size that will contain the backing file for the virtual memory of the UML kernel. This file system is created just before the UML kernel is executed.

/var/lib/umlmon/vmname/jail/proc/mm:

If the host system supports SKAS3, this file is a bind mount of /proc/mm so the UML kernel can access the mm interface. This mount is established just before the UML kernel is executed.

SIGTERM

Shuts the daemon regularly down. If the UML kernel is running, it is usually killed (because the controlling terminal vanishes).

SIGINT

If running in the foreground, this signal terminates the daemon process immediately.

UMLMON was written by Gerd Stolpmann.

Report bugs to gerd@gerd−stolpmann.de

You can get commercial support for UMLMON. Please ask Gerd Stolpmann <gerd@gerd−stolpmann.de>.

Copyright (C) 2005 Informatikbuero Gerd Stolpmann. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

umlwatch(1), umlmon(5), umlmon(7), umldir(8), umladmin(8)