Bug 1027154 - qemu-guest-agent missing documentation
Summary: qemu-guest-agent missing documentation
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: qemu-kvm
Version: 7.0
Hardware: Unspecified
OS: Unspecified
low
low
Target Milestone: rc
: ---
Assignee: Ademar Reis
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-11-06 09:56 UTC by Karel Volný
Modified: 2014-09-03 08:06 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-09-03 08:06:30 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Karel Volný 2013-11-06 09:56:19 UTC
Description of problem:
In today's updates, I have noticed a package "qemu-guest-agent". As I had no clue what this is for, I tried to read the docs, but I have found them missing and lacking - no clue what does this application do.

Version-Release number of selected component (if applicable):
qemu-guest-agent-1.5.3-13.el7

How reproducible:
always

Steps to Reproduce:
1. man qemu-ga
2. qemu-ga --help

Actual results:
1. No manual entry for qemu-ga
2.
Usage: qemu-ga [-m <method> -p <path>] [<options>]
QEMU Guest Agent 1.5.3

 -m, --method     transport method: one of unix-listen, virtio-serial, or
...

Expected results:
1. (manpage is shown)
2.
Usage: qemu-ga [-m <method> -p <path>] [<options>]
QEMU Guest Agent 1.5.3

A daemon program running inside the domain which is supposed to help management applications with executing functions which need assistance of the guest OS. 

Options:
 -m, --method     transport method: one of unix-listen, virtio-serial, or
...


Additional info:
Sample text taken from http://wiki.libvirt.org/page/Qemu_guest_agent ... I don't say that it is perfect (well, to me, the exact purpose of this would be still a puzzle if I had read only this one sentence).

Comment 2 Miroslav Rezanina 2014-09-03 08:06:30 UTC
User should never execute qemu-ga directly. It's handle through provided systemd unit.

Proper usage is documented in Virtualization Deployment Guide.


Note You need to log in before you can comment on or make changes to this bug.