qemu-init user tools
The user tools are for interactive usage at the command line. They use the functionality of the library. How to use each of these user tools is described in the man pages:
However, below are some more internal information and examples.
qemu-adm  is the administration tool of qemu-init. It is designed to do all the tasks which are implemented in the qemu-init library.
- qemud-reg - register and unregister virtual machines, show short status (running or not) of registered virtual machines
We use pluto as <name> (unique identifier) in the examples below.
Register a virtual machine
To register a virtual machine located in
$> qemu-adm -r /path/to/vm/pluto [-f]
Afterwards the virtual machine could be called by it's name “pluto”. Inside the folder
/path/to/vm  the files pluto-qemud.rc (rc-file), pluto-qemu.cfg (cfg-file) and optional (-f) a default (empty) disk image pluto-qemu.img will be created if not exists. The folder will be created if not exists.
Un-register a virtual machine
The opposite is to un-register a virtual machine:
$> qemu-adm -u pluto
This action removes pluto from registered virtual machines. It does not remove any files!
Start a virtual machine
$> qemu-adm -S pluto
-D  stops a and
-R  restarts a virtual machine.
Change AUTOSTART option
This command reverts the autostart option of pluto (used by qemud):
$> qemu-adm -a pluto
If AUTOSTART is OFF it will be set to ON and vice versa. This option requires root privileges.
List registered virtual machines
To show all registered machines run:
$> qemu-adm -l
This shows the actual status of a virtual machine:
$> qemu-adm -s pluto
If the virtual machine is up and running the actual runtime configuration will be printed additional.
To get the status of all registered virtual machines run:
$> qemu-adm -s [all]
This executes internal
sudo qemud status  - thus the user have to be in the qemu-init group (default:
qemu-init is designed to work at the host system local only. For remote access
ssh  is recommended. More complex commands needs to be quoted properly. Example:
$> ssh <remote_host> 'qemu-adm -c "info name" pluto'
Especially a remote connection to the monitor requires that
ssh  have to be used with the
$> ssh -t <remote_host> 'qemu-adm -m pluto'
It is important to use
ssh -t  here to be able to pipe
CTRL-C  through the
ssh  command (to disconnect from the monitor)!