Bug 1047725

Summary:	[rhel7][virt-manager] some control characters displayed in man page title for virt-manager unexpectedly
Product:	Red Hat Enterprise Linux 7	Reporter:	zhengqin <zsong>
Component:	virt-manager	Assignee:	Giuseppe Scrivano <gscrivan>
Status:	CLOSED ERRATA	QA Contact:	Virtualization Bugs <virt-bugs>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	7.0	CC:	codong, dyuan, gscrivan, honzhang, juzhou, mzhan, tzheng
Target Milestone:	rc	Keywords:	Upstream
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:	virt-manager-1.1.0-1.el7	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-03-05 10:03:05 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description zhengqin 2014-01-02 02:24:47 UTC

Description of problem:
some control characters displayed in man page title for virt-manager 
unexpectedly, and this issue also occurs for virt-install

Version-Release number of selected component (if applicable):
libvirt-1.1.1-17.el7.x86_64
virt-manager-0.10.0-9.el7.x86_64


How reproducible:
always

Steps to Reproduce:
#man virt-manager


Results:
1. some control characters displayed in man page title for virt-manager 
unexpectedly
IO::FILE=IO(0X1003BC1F0C8)(1)           Virtual Machine Manager              IO::FILE=IO(0X1003BC1F0C8)(1)



Expected results:
No additional characters displayed in man page, and it should be displayed just like following:
VIRT-MANAGER(1)     Virtual Machine Manager       VIRT-MANAGER(1)

Additional info:
1. This issue also occurs for virt-install(virt-install-0.10.0-9.el7.x86_64)
2. This issue does not occur on RHEL6 with virt-manager-0.9.0-19.el6.x86_64.

Comment 1 Cui Lei 2014-01-02 05:25:54 UTC

Man page of virt-image, virt-clone and virt-convert in RHEL7 also exist this issue.

Comment 2 Giuseppe Scrivano 2014-07-25 11:13:00 UTC

works in the upstream version

Comment 3 zhoujunqin 2014-08-01 03:02:15 UTC

Hi Giuseppe Scrivano,
I can reproduce the bug issue with package version:
virt-manager-common-0.10.0-20.el7.noarch
virt-install-0.10.0-20.el7.noarch
virt-manager-0.10.0-20.el7.noarch

and also find another two problems in virt-manager manual page, please help have a look, thanks.

1. "-help" should be "--help", for the following reason.
# man virt-manager
....
OPTIONS
       The following options are accepted when running "virt-manager":

       -h, -help
           Display command line help summary
...

reason-1.1
# virt-manager  --help
Usage: virt-manager [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
.........>use "--help"

# virt-manager  -h
Usage: virt-manager [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
...

reason-1.2 "-help" just have the function "-h" not "--help"
# virt-manager  -help
Usage: virt-manager [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
....
and it work well when i put other invaild characters after "h", no error report.

# virt-manager  -haaaaddd
Usage: virt-manager [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
....

2. 
# man virt-manager
...
      --spice-disable-auto-usbredir Auto USB redirection is supportted by default. This option switches off it.
...
# virt-manager --help
  --spice-disable-auto-usbredir
                        Disable Auto USB redirection support
Problems:
In virt-manager manual,miss "return" after --spice-disable-auto-usbredir,the interpretation of the option should listed in another line.

so Giuseppe Scrivano, above two problems, shall we fix them together in this bug or need open another bug to track it, thanks.

Comment 4 Giuseppe Scrivano 2014-08-01 09:37:10 UTC

thanks to have reported these issues, I don't think there is need to open a new BZ.

They are both fixed upstream now.

Comment 6 CongDong 2014-09-09 10:25:47 UTC

Can reproduce the problems in description and comment 3 with 
virt-manager-0.10.0-20.el7.noarch

VERIFY with :
virt-manager-1.1.0-1.el7.noarch

Steps:
1. Check control characters 

a). # man virt-manager
VIRT-MANAGER(1)                                   Virtual Machine Manager                                  VIRT-MANAGER(1)
...
1.1.0                                                   2014-09-08                                         VIRT-MANAGER(1)

b).#man virt-install 
VIRT-INSTALL(1)                                   Virtual Machine Manager                                  VIRT-INSTALL(1)
...
1.1.0                                                   2014-09-08                                         VIRT-INSTALL(1)


2. Check man page
a). # virt-manager
       -h, --help
           Display command line help summary
...
           --spice-disable-auto-usbredir
               Auto USB redirection is supported by default. This option switches off it.

b).
# virt-manager -help
usage: virt-manager [options]
virt-manager: error: argument -h/--help: ignored explicit argument 'elp'

# virt-manager -h
usage: virt-manager [options]

optional arguments:
  -h, --help            show this help message and exit
...

# virt-manager --help
usage: virt-manager [options]

optional arguments:
  -h, --help            show this help message and exit


As the result, set VERIFIED

Comment 9 errata-xmlrpc 2015-03-05 10:03:05 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.

https://rhn.redhat.com/errata/RHBA-2015-0427.html