Bug 690150 - virt-install: DOC: wrong description on MODE value
Summary: virt-install: DOC: wrong description on MODE value
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: python-virtinst
Version: 6.1
Hardware: Unspecified
OS: Linux
medium
low
Target Milestone: rc
: ---
Assignee: Cole Robinson
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-03-23 13:06 UTC by Nan Zhang
Modified: 2011-12-06 16:16 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
No description necessary
Clone Of:
Environment:
Last Closed: 2011-12-06 16:16:10 UTC
Target Upstream Version:

Attachments (Terms of Use)
Add an attachment (proposed patch, testcase, etc.)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2011:1643 0 normal SHIPPED_LIVE python-virtinst bug fix and enhancement update 2011-12-06 00:50:36 UTC

Description Nan Zhang 2011-03-23 13:06:31 UTC 
Description of problem:
MODE value should be 'bind' or 'connect', not 'tcp'.

--serial unix,path=UNIXPATH,mode=MODE
    Unix socket (see unix(7). MODE has similar behavior and defaults as ’tcp’.

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

How reproducible:
Always

Steps to Reproduce:
# man virt-install
  
Actual results:


Expected results:


Additional info:
Comment 1 Cole Robinson 2011-03-24 15:57:21 UTC 
The man page is a little unclear, what it is saying is that --serial unix,mode= works exactly the same as --serial tcp,mode=

I've clarified this upstream:

http://git.fedorahosted.org/git?p=python-virtinst.git;a=commit;h=04d82eddfcf5e4cacd0c3fca06cb1f7512d841b3
Comment 3 Cole Robinson 2011-07-28 15:34:16 UTC 
Fixed in python-virtinst-0.600.0-1.el6
Comment 5 Huming Jiang 2011-08-02 06:46:00 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:
# man virt-install
...
   --serial unix,path=UNIXPATH,mode=MODE
             Unix socket, see unix(7). MODE has similar behavior and defaults
             as --serial tcp,mode=MODE
...
Comment 6 Cole Robinson 2011-08-02 16:15:02 UTC 
Regenerated man pages in python-virtinst-0.600.0-2.el6
Comment 7 Huming Jiang 2011-08-03 09:21:03 UTC 
I confired it with others, then found following is the final result. sorry about comment 5.
Verified with the following components:
libvirt-0.9.4-0rc1.2.el6.x86_64
kernel-2.6.32-171.el6.x86_64
python-virtinst-0.600.0-2.el6.noarch
qemu-kvm-0.12.1.2-2.175.el6.x86_64

Steps:
# man virt-install
...
   --serial unix,path=UNIXPATH,mode=MODE
             Unix socket, see unix(7). MODE has similar behavior and defaults
             as --serial tcp,mode=MODE
...
Comment 8 Cole Robinson 2011-08-03 14:22:03 UTC 
Thanks for confirming, should we put this bug into VERIFIED then? I think the other doc bugs need the same.
Comment 9 Nan Zhang 2011-08-04 02:07:59 UTC 
Move this to VERIFIED, according to comment 7.
Comment 10 Huming Jiang 2011-08-04 02:36:25 UTC 
Move the needinfo plag, according to comment 9. And set status of the other doc bugs from modified to verified.
Comment 11 Cole Robinson 2011-11-07 16:51:01 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 12 errata-xmlrpc 2011-12-06 16:16:10 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
Note You need to log in before you can comment on or make changes to this bug.