665b5d0dff
Add a simple man page for the qemu agent. Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com> Reviewed-by: Michael Roth <mdroth@linux.vnet.ibm.com> *squashed in review comments from Eric Blake <eblake@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
138 lines
3.2 KiB
Plaintext
138 lines
3.2 KiB
Plaintext
@example
|
|
@c man begin SYNOPSIS
|
|
usage: qemu-ga [OPTIONS]
|
|
@c man end
|
|
@end example
|
|
|
|
@c man begin DESCRIPTION
|
|
|
|
The QEMU Guest Agent is a daemon intended to be run within virtual
|
|
machines. It allows the hypervisor host to perform various operations
|
|
in the guest, such as:
|
|
|
|
@itemize
|
|
@item
|
|
get information from the guest
|
|
@item
|
|
set the guest's system time
|
|
@item
|
|
read/write a file
|
|
@item
|
|
sync and freeze the filesystems
|
|
@item
|
|
suspend the guest
|
|
@item
|
|
reconfigure guest local processors
|
|
@item
|
|
set user's password
|
|
@item
|
|
...
|
|
@end itemize
|
|
|
|
qemu-ga will read a system configuration file on startup (located at
|
|
q@file{/etc/qemu/qemu-ga.conf} by default), then parse remaining
|
|
configuration options on the command line. For the same key, the last
|
|
option wins, but the lists accumulate (see below for configuration
|
|
file format).
|
|
|
|
@c man end
|
|
|
|
@c man begin OPTIONS
|
|
@table @option
|
|
@item -m, --method=@var{method}
|
|
Transport method: one of @samp{unix-listen}, @samp{virtio-serial}, or
|
|
@samp{isa-serial} (@samp{virtio-serial} is the default).
|
|
|
|
@item -p, --path=@var{path}
|
|
Device/socket path (the default for virtio-serial is
|
|
@samp{/dev/virtio-ports/org.qemu.guest_agent.0},
|
|
the default for isa-serial is @samp{/dev/ttyS0})
|
|
|
|
@item -l, --logfile=@var{path}
|
|
Set log file path (default is stderr).
|
|
|
|
@item -f, --pidfile=@var{path}
|
|
Specify pid file (default is @samp{/var/run/qemu-ga.pid}).
|
|
|
|
@item -F, --fsfreeze-hook=@var{path}
|
|
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
|
|
@samp{/etc/qemu/fsfreeze-hook}). If using -F with an argument, do
|
|
not follow -F with a space (for example:
|
|
@samp{-F/var/run/fsfreezehook.sh}).
|
|
|
|
@item -t, --statedir=@var{path}
|
|
Specify the directory to store state information (absolute paths only,
|
|
default is @samp{/var/run}).
|
|
|
|
@item -v, --verbose
|
|
Log extra debugging information.
|
|
|
|
@item -V, --version
|
|
Print version information and exit.
|
|
|
|
@item -d, --daemon
|
|
Daemonize after startup (detach from terminal).
|
|
|
|
@item -b, --blacklist=@var{list}
|
|
Comma-separated list of RPCs to disable (no spaces, @samp{?} to list
|
|
available RPCs).
|
|
|
|
@item -D, --dump-conf
|
|
Dump the configuration in a format compatible with @file{qemu-ga.conf}
|
|
and exit.
|
|
|
|
@item -h, --help
|
|
Display this help and exit.
|
|
@end table
|
|
|
|
@c man end
|
|
|
|
@c man begin FILES
|
|
|
|
The syntax of the @file{qemu-ga.conf} configuration file follows the
|
|
Desktop Entry Specification, here is a quick summary: it consists of
|
|
groups of key-value pairs, interspersed with comments.
|
|
|
|
@example
|
|
# 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
|
|
@end example
|
|
|
|
The list of keys follows the command line options:
|
|
@table @option
|
|
@item daemon= boolean
|
|
@item method= string
|
|
@item path= string
|
|
@item logfile= string
|
|
@item pidfile= string
|
|
@item fsfreeze-hook= string
|
|
@item statedir= string
|
|
@item verbose= boolean
|
|
@item blacklist= string list
|
|
@end table
|
|
|
|
@c man end
|
|
|
|
@ignore
|
|
|
|
@setfilename qemu-ga
|
|
@settitle QEMU Guest Agent
|
|
|
|
@c man begin AUTHOR
|
|
Michael Roth <mdroth@linux.vnet.ibm.com>
|
|
@c man end
|
|
|
|
@c man begin SEEALSO
|
|
qemu(1)
|
|
@c man end
|
|
|
|
@end ignore
|