QEMU-GA(8)                           QEMU                           QEMU-GA(8)

<?><?><?> (NAME)
       qemu-ga - <?><?><?><?> <?><?><?><?><?> QEMU

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       qemu-ga [OPTIONS]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?> <?><?><?><?><?> QEMU <?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?>:

       o <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
         <?><?><?><?><?>

       o <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>

       o <?><?><?><?><?><?>/<?><?><?><?><?> <?><?><?><?>

       o <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?>

       o <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>

       o <?><?><?><?><?><?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>

       o <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>

       o ...

       <?><?><?><?><?> qemu-ga <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> /etc/qemu/qemu-ga.conf)
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?>).

       <?><?><?> <?><?><?><?><?><?> <?><?> RPC<?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> RPC<?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?> RPC<?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       RPC<?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?> <?><?> <?><?> <?><?><?><?><?> RPC<?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> RPC<?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?>.

       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       RPC<?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)

       -c, --config=PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              (<?><?><?><?><?><?><?> /etc/qemu/qemu-ga.conf <?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> QGA_CONF <?><?><?><?><?><?><?><?> <?><?><?>).

       -m, --method=METHOD
              <?><?><?> <?><?><?><?><?><?>: <?><?><?> <?><?>
              <?><?><?><?><?><?> unix-listen<?> virtio-serial<?> <?><?>
              isa-serial<?> <?><?> vsock-listen (virtio-serial <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>).

       -p, --path=PATH
              <?><?><?><?> <?><?><?><?><?><?>/<?><?><?><?>
              (<?><?><?><?><?><?><?> <?><?><?><?> virtio-serial
              <?><?><?><?><?> <?><?> /dev/virtio-ports/org.qemu.guest_agent.0
              <?> <?><?><?><?><?><?><?> <?><?><?><?> isa-serial
              <?><?><?><?><?> <?><?> /dev/ttyS0 <?><?><?>).
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> vsock-listen
              <?><?> <?><?><?><?> <cid>:<port> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       -l, --logfile=PATH
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              (<?><?><?><?><?><?><?> stderr <?><?><?>).

       -f, --pidfile=PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?> pid
              (<?><?><?><?><?><?><?> /var/run/qemu-ga.pid <?><?><?>).

       -F, --fsfreeze-hook=PATH
              <?><?><?><?><?><?><?><?><?> <?><?><?> fsfreeze. <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>/<?><?><?> (freeze/thaw) <?><?> <?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              'freeze'/'thaw' <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              (<?><?><?><?><?><?><?> /etc/qemu/fsfreeze-hook <?><?><?>).
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> -F <?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> -F <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> (<?><?><?><?> <?><?><?><?>:
              -F/var/run/fsfreezehook.sh).

       -t, --statedir=PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              (<?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> /var/run <?><?><?>).

       -v, --verbose
              <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?>.

       -V, --version
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>.

       -d, --daemon
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> (<?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?>).

       -b, --block-rpcs=LIST
              <?><?><?><?><?><?> <?><?> RPC<?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?>
              <?><?><?><?><?><?> <?><?> --block-rpcs=help <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> RPC<?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?>).

       -a, --allow-rpcs=LIST
              <?><?><?><?><?><?> <?><?> RPC<?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?>
              <?><?><?><?><?><?> <?><?> --allow-rpcs=help <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> RPC<?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?>).

       -D, --dump-conf
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> qemu-ga.conf <?> <?><?><?><?>.

       -h, --help
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       qemu-ga.conf <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> (Desktop Entry Specification) <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?>: <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>-<?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.

          # qemu-ga configuration sample
          [general]
          daemonize = 0
          pidfile = /var/run/qemu-ga.pid
          verbose = 0
          method = virtio-serial
          path = /dev/virtio-ports/org.qemu.guest_agent.0
          statedir = /var/run

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

                  +-------------------+----------------------------+
                  |<?><?><?><?> (Key) | <?><?><?> <?><?><?><?>     |
                  |                   | (Key type)                 |
                  +-------------------+----------------------------+
                  |daemon             | <?><?><?><?> (boolean)     |
                  +-------------------+----------------------------+
                  |method             | <?><?><?><?> (string)      |
                  +-------------------+----------------------------+
                  |path               | <?><?><?><?> (string)      |
                  +-------------------+----------------------------+
                  |logfile            | <?><?><?><?> (string)      |
                  +-------------------+----------------------------+
                  |pidfile            | <?><?><?><?> (string)      |
                  +-------------------+----------------------------+
                  |fsfreeze-hook      | <?><?><?><?> (string)      |
                  +-------------------+----------------------------+
                  |statedir           | <?><?><?><?> (string)      |
                  +-------------------+----------------------------+
                  |verbose            | <?><?><?><?> (boolean)     |
                  +-------------------+----------------------------+
                  |block-rpcs         | <?><?><?><?><?>            |
                  |                   | <?><?><?><?> (string list) |
                  +-------------------+----------------------------+
                  |allow-rpcs         | <?><?><?><?><?>            |
                  |                   | <?><?><?><?> (string list) |
                  +-------------------+----------------------------+
<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       qemu(1)

<?><?><?><?><?><?><?> (AUTHOR)
       Michael Roth <mdroth@linux.vnet.ibm.com>

<?><?> <?><?><?> (COPYRIGHT)
       2026, The QEMU Project Developers

11.1.1                          August 28, 2026                     QEMU-GA(8)