Bug 442429 - libvirt man page and virsh help incosistencies for "domain commands"
Summary: libvirt man page and virsh help incosistencies for "domain commands"
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: libvirt
Version: 5.3
Hardware: All
OS: Linux
medium
medium
Target Milestone: rc
: ---
Assignee: Daniel Veillard
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks: 409971 449772
TreeView+ depends on / blocked
 
Reported: 2008-04-14 18:59 UTC by Adam Stokes
Modified: 2018-10-20 01:13 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2009-01-20 21:21:49 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
patch for the virsh man page (8.44 KB, patch)
2008-04-15 15:26 UTC, Daniel Veillard
no flags Details | Diff


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2009:0142 0 normal SHIPPED_LIVE libvirt bug fix and enhancement update 2009-01-20 16:05:03 UTC

Description Adam Stokes 2008-04-14 18:59:16 UTC
Description of problem:
For "DOMAIN COMMANDS" of man page, there are the following two
bugs about first parameter,
> (1) domid
  man page   : domain-name
  virsh help : domain name or uuid
  -> We can specify 'name' or 'uuid',
     so 'domain-name-or-uuid' will be better for man page.
> (2) domname
  man page   : domain-id
  virsh help : domain id or uuid
  -> We can specify 'id' or 'uuid',
     so 'domain-id-or-uuid' will be better for man page.

Also, the following eight commands have no documentation
on man page,
 1) start
 2) domblkstat
 3) domifstat
 4) hostname
 5) migrate
 6) schedinfo
 7) dump
 8) uri

Version-Release number of selected component (if applicable):
libvirt 0.4.0

How reproducible:
100%

Steps to Reproduce:
1. man virsh, read domid or domname
2. virsh help, read description for domid or domname
3.
  
Actual results:
> (1) domid
  man page   : domain-name
  virsh help : domain name or uuid
  -> We can specify 'name' or 'uuid',
     so 'domain-name-or-uuid' will be better for man page.
> (2) domname
  man page   : domain-id
  virsh help : domain id or uuid
  -> We can specify 'id' or 'uuid',
     so 'domain-id-or-uuid' will be better for man page.

Expected results:
Consistent documentation between both help and man page

Additional info:

Comment 1 Daniel Veillard 2008-04-15 15:25:08 UTC
Okidoc, I added the missing commands and fixed the couple of things
you reported, it's in the project CVS, I'm attaching the patch, hopefully
we will be able to add this for 5.3,

Daniel


Comment 2 Daniel Veillard 2008-04-15 15:26:00 UTC
Created attachment 302477 [details]
patch for the virsh man page

Comment 3 RHEL Program Management 2008-06-02 20:07:16 UTC
This request was evaluated by Red Hat Product Management for inclusion in a Red
Hat Enterprise Linux maintenance release.  Product Management has requested
further review of this request by Red Hat Engineering, for potential
inclusion in a Red Hat Enterprise Linux Update release for currently deployed
products.  This request is not yet committed for inclusion in an Update
release.

Comment 4 Daniel Veillard 2008-06-18 15:55:00 UTC
libvirt-0.3.3-8.el5 has been built with the fix in dist-5E-qu-candidate,

Daniel

Comment 8 errata-xmlrpc 2009-01-20 21:21:49 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2009-0142.html


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