Bug 694713

Summary: doc:virt-image:The graphics description not clearly in man help
Product: Red Hat Enterprise Linux 6 Reporter: zhe peng <zpeng>
Component: python-virtinstAssignee: Cole Robinson <crobinso>
Status: CLOSED ERRATA QA Contact: Virtualization Bugs <virt-bugs>
Severity: low Docs Contact:
Priority: low    
Version: 6.1CC: dyuan, hjiang, mzhan, nzhang
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
No description necessary
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-12-06 16:16:36 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description zhe peng 2011-04-08 05:24:45 UTC
Description of problem:


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


How reproducible:
always

Steps to Reproduce:
1.man virt-image

in "Graphics Configuration" section

 
Actual results:
.....
--vnc

--vncport
.....

Expected results:
.....
--graphics vnc

--graphics vnc,port
.....


Additional info:
  I think graphics general format should like this
        --graphics TYPE,opt1=arg1,opt2=arg2,...

Comment 2 zhe peng 2011-04-08 05:56:00 UTC
Description of problem:

the description of graphics configuration not clearly in man help

Version-Release number of selected component (if applicable):
python-virtinst-0.500.5-3.el6.noarch

Comment 3 Nan Zhang 2011-04-08 05:59:12 UTC
Missing the following description of usage in virt-image man manual.

# virt-image --help
(...)
  Graphics Configuration:
    --graphics=GRAPHICS
                        Specify display configuration. Ex:
                        --graphics vnc
                        --graphics spice,port=1,tlsport=2
                        --graphics none
                        --graphics vnc,password=foobar,port=5910,keymap=ja
(...)

Comment 4 RHEL Program Management 2011-04-08 06:00:30 UTC
Since RHEL 6.1 External Beta has begun, and this bug remains
unresolved, it has been rejected as it is not proposed as
exception or blocker.

Red Hat invites you to ask your support representative to
propose this request, if appropriate and relevant, in the
next release of Red Hat Enterprise Linux.

Comment 6 Cole Robinson 2011-07-28 15:34:25 UTC
Fixed in python-virtinst-0.600.0-1.el6

Comment 8 Huming Jiang 2011-08-02 05:48:55 UTC
Could still reproduce this bug in the following componets:
python-virtinst-0.600.0-1.el6.
libvirt-0.9.4-0rc1.el6.x86_64
kernel-2.6.32-171.el6.x86_64
qemu-kvm-0.12.1.2-2.174.el6.x86_64


How reproducible:
always

Steps to Reproduce:
1.man virt-image

in "Graphics Configuration" section


Actual results:
.....
--vnc

--vncport
.....

Expected results:
.....
--graphics vnc

--graphics vnc,port
.....
Additional info:

# virt-image --help
(...)
  Graphics Configuration:
    --graphics=GRAPHICS
                        Specify display configuration. Ex:
                        --graphics vnc
                        --graphics spice,port=1,tlsport=2
                        --graphics none
                        --graphics vnc,password=foobar,port=5910,keymap=ja
(...)

So set the bug status from ON_QA to ASSIGNED

Comment 9 Cole Robinson 2011-08-02 16:14:47 UTC
Regenerated man pages in python-virtinst-0.600.0-2.el6

Comment 10 Huming Jiang 2011-08-03 08:35:33 UTC
Verified with the following components:
python-virtinst-0.600.0-2.el6.noarch

Steps:
#man virt-image
...
--graphics TYPE,opt1=arg1,opt2=arg2,...
...
--vnc
         This option is deprecated in favor of "--graphics vnc,..."
--vncport=VNCPORT
         This option is deprecated in favor of "--graphics vnc,port=PORT,..."
...
#man 1 virt-install
...
Graphics Configuration
...
General format of a graphical string is

             --graphics TYPE,opt1=arg1,opt2=arg2,...

         For example:

             --graphics vnc,password=foobar
...
type
...

Comment 11 Huming Jiang 2011-08-04 02:40:04 UTC
According to comment 10, move the status to verified.

Comment 12 Cole Robinson 2011-11-07 16:52:47 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
No description necessary

Comment 13 errata-xmlrpc 2011-12-06 16:16:36 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2011-1643.html