qemu-init library


qemud-cfg

This is the same content like the man page qemud-cfg(8). See naming conventions for abbreviations.

/** start man page **/


qemud-cfg(8)

May 2, 2021

NAME

 qemud-cfg  - read and print configurations of virtual machines.

SYNOPSIS

         qemud-cfg [ options ] name 

DESCRIPTION

 qemud-cfg  is designed as an executable library commonly invoked  qemu-adm  and  qemud-init .

OPTIONS

 -c \ Print control parameters required by  qemud-init  on fd 3. The format is KEY=VALUE. The keys will be set in the environment.  qemud-init  does use these variables to start  <name> .

 -f \ Print the pidfile of  <name>  with absolute path on fd 3. The format is  PIDFILE=VARDIR/run/<name>-qemu.pid .  qemud-init  does use it to set the qemu option  -pidfile .

 -p \ Print the actual configuration from config files of  <name>  in a human friendly format to stdout.

 -r \ Print the actual runtime configuration of  <name>  in a human friendly format to stdout. If  <name>  is not running  qemud-cfg  does fallback to  -p  automatically.

 -x \ Read the config files of  <name>  and print the qemu command line on fd 4. Required by  qemud-init  to start a virtual machine.

 -v \ Make  qemud-cfg  more verbose. Could be used multiple times. Takes effect with  -p  or  -r  only.

Only one of the options  -p ,  -r  or  -x  could be used at a time.

CONFIG FILES

 qemud-cfg  reads the configuration from  <name>-qemud.rc  (required) and  <name>-qemu.cfg  (optional). See man qemu-init(5) for details.

RETURN CODES

 qemud-cfg  returns 0 on success. Otherwise it returns with an error code and sets  errno  accordingly.

AUTHOR

Kai Peter (©2020-present)

SEE ALSO:

qemu-adm(1), qemu-init(5) , qemud-init(8)