OS Manuals

/usr/bin/qemu-ga

fast processor emulator (FIPS)

From qemu-fips 11.1.3-r0 (enterprise-packages), captured 2026-11-08 by running qemu-ga --help (exit 0). permalink

Usage: /usr/bin/qemu-ga [-m <method> -p <path>] [<options>]
QEMU Guest Agent 11.1.3 (v11.1.3)
Copyright (c) 2003-2026 Fabrice Bellard and the QEMU Project developers

  -c, --config=PATH configuration file path (default is
                    /etc/qemu/qemu-ga.conf/qemu-ga.conf
                    unless overridden by the QGA_CONF environment variable)
  -m, --method      transport method: one of unix-listen, virtio-serial,
                    isa-serial, or vsock-listen (virtio-serial is the default)
  -p, --path        device/socket path (the default for virtio-serial is:
                    /dev/virtio-ports/org.qemu.guest_agent.0,
                    the default for isa-serial is:
                    /dev/ttyS0).
                    Socket addresses for vsock-listen are written as
                    <cid>:<port>.
  -l, --logfile     set logfile path, logs to stderr by default
  -f, --pidfile     specify pidfile (default is /var/run/qemu-ga.pid)
  -F, --fsfreeze-hook
                    enable fsfreeze hook. Accepts an optional argument that
                    specifies script to run on freeze/thaw. Script will be
                    called with 'freeze'/'thaw' arguments accordingly.
                    (default is /etc/qemu/fsfreeze-hook)
                    If using -F with an argument, do not follow -F with a
                    space.
                    (for example: -F/var/run/fsfreezehook.sh)
  -t, --statedir    specify dir to store state information (absolute paths
                    only, default is /var/run)
  -v, --verbose     log extra debugging information
  -V, --version     print version information and exit
  -d, --daemonize   become a daemon
  -b, --block-rpcs  comma-separated list of RPCs to disable (no spaces,
                    use "--block-rpcs=help" to list available RPCs)
  -a, --allow-rpcs  comma-separated list of RPCs to enable (no spaces,
                    use "--allow-rpcs=help" to list available RPCs)
  -D, --dump-conf   dump a qemu-ga config file based on current config
                    options / command-line parameters to stdout
  -r, --retry-path  attempt re-opening path if it's unavailable or closed
                    due to an error which may be recoverable in the future
                    (virtio-serial driver re-install, serial device hot
                    plug/unplug, etc.)
  -h, --help        display this help and exit

See <https://qemu.org/contribute/report-a-bug> for how to report bugs.
More information on the QEMU project at <https://qemu.org>.
Options (14)
OptionDescriptionSource
-m, --methodtransport method: one of unix-listen, virtio-serial, isa-serial, or vsock-listen (virtio-serial is the default)help
-p, --pathdevice/socket path (the default for virtio-serial is: /dev/virtio-ports/org.qemu.guest_agent.0, the default for isa-serial is: /dev/ttyS0).help
-l, --logfileset logfile path, logs to stderr by defaulthelp
-f, --pidfilespecify pidfile (default is /var/run/qemu-ga.pid)help
-F, --fsfreeze-hookenable fsfreeze hook.help
-t, --statedirspecify dir to store state information (absolute paths only, default is /var/run)help
-v, --verboselog extra debugging informationhelp
-V, --versionprint version information and exithelp
-d, --daemonizebecome a daemonhelp
-b, --block-rpcscomma-separated list of RPCs to disable (no spaces, use "--block-rpcs=help" to list available RPCs)help
-a, --allow-rpcscomma-separated list of RPCs to enable (no spaces, use "--allow-rpcs=help" to list available RPCs)help
-D, --dump-confdump a qemu-ga config file based on current config options / command-line parameters to stdouthelp
-r, --retry-pathattempt re-opening path if it's unavailable or closed due to an error which may be recoverable in the future (virtio-serial driver re-install, serial device hot plug/unplug, etc.)help
-h, --helpdisplay this help and exithelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.