RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 823916 - Need to update virt-viewer man page
Summary: Need to update virt-viewer man page
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: virt-viewer
Version: 6.3
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: rc
: ---
Assignee: Virt Viewer Maint
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On: 1179477
Blocks: 921341
TreeView+ depends on / blocked
 
Reported: 2012-05-22 12:54 UTC by yuping zhang
Modified: 2016-04-26 15:27 UTC (History)
12 users (show)

Fixed In Version: virt-viewer-2.0-1.el6
Doc Type: Bug Fix
Doc Text:
No doc needed
Clone Of:
: 921341 (view as bug list)
Environment:
Last Closed: 2015-07-22 06:30:06 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2015:1322 0 normal SHIPPED_LIVE virt-viewer and spice-gtk bug fix and enhancement update 2015-07-20 17:53:14 UTC

Description yuping zhang 2012-05-22 12:54:54 UTC 
Description of problem:
1.No man page for --display option in #man virt-viewer
  --display=DISPLAY                                                 X display to use

2.No man page for --display and --direct options in #man remote-viewer
 -d, --direct                                                      Direct connection with no automatic tunnels
 --display=DISPLAY                                                 X display to use

3.No man page for Spice Options both #man virt-viewer and #man remote-viewer
Spice Options:
  --spice-disable-effects=<wallpaper,font-smooth,animation,all>     Disable guest display effects
  --spice-color-depth=<16,32>                                       Guest display color depth
  --spice-ca-file=<file>                                            Truststore file for secure connections
  --spice-host-subject=<host-subject>                               Subject of the host certificate (field=value pairs separated by commas)
  --spice-disable-audio                                             Disable audio support
  --spice-smartcard                                                 Enable smartcard support
  --spice-smartcard-certificates=<certificates>                     Certificates to use for software smartcards (field=values separated by commas)
  --spice-smartcard-db=<certificate-db>                             Path to the local certificate database to use for software smartcard certificates
  --spice-disable-usbredir                                          Disable USB redirection support
  --spice-usbredir-filter=<filter-string>                           Filter for excluding USB devices from auto redirection
  --spice-cache-size=<bytes>                                        Image cache size
  --spice-glz-window-size=<bytes>                                   Glz compression history size
  --spice-debug                                                     Enable Spice-GTK debugging
  --spice-gtk-version                                               Display Spice-GTK version information

4.The Copyright need to update in virt-viewer man page.
#man virt-viewer
COPYRIGHT
       Copyright (C) 2007-2008 Red Hat, Inc., and various contributors.

5.No punctuation before "The viewer can connect.."
#man virt-viewer
...
DESCRIPTION
       virt-viewer is a minimal tool for displaying the graphical console of a virtual machine. The console is accessed using the VNC or
       SPICE protocol. The guest can be referred to based on its name, ID, or UUID. If the guest is not already running, then the viewer
       can be told to wait until is starts before attempting to connect to the console The viewer can connect to remote hosts to lookup
       the console information and then also connect to the remote console using the same network transport.
....

Version-Release number of selected component (if applicable):
virt-viewer-0.5.2-9.el6.x86_64

How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:
Comment 4 CongDong 2013-10-29 09:14:51 UTC 
I can reproduce the bug with:
virt-viewer-0.5.6-8.el6.x86_64

Steps:
# man virt-viewer

Result:
1. Same with the description
2. Another problem:
...
DESCRIPTION
...then the viewer
       can be told to wait until is starts before attempting to connect to the console
...

The word "is" after until should be "it".
Comment 5 Marc-Andre Lureau 2013-12-10 23:28:59 UTC 
--display is not a virt-viewer specific option, hence it should not be documented by virt-viewer man page (otherwise we'd need to patch all the man pages of all gtk+ programs).

Same for
--spice-*

Why is it worth updating copyright date everytime a minor modification is made?
Comment 8 Jonathon Jongsma 2015-03-02 16:42:58 UTC 
rebased to release 2.0 which should have an updated man page.
Comment 10 tingting zheng 2015-03-03 08:01:15 UTC 
Tested with:
virt-viewer-2.0-2.el6.x86_64

Steps:
1.Check in virt-viewer --help and manual,--direct option is included in both:
# man virt-viewer 
       -d, --direct
           Do not attempt to tunnel the console over SSH, even if the main connection URI used SSH.

# virt-viewer --help

  -d, --direct                                                      Direct connection with no automatic tunnels

2.Check virt-viewer manual,punctuation has been added before "The viewer can connect.."

3.Check issue in comment 4,the word "is" after until has been changed to "it".
# man virt-viewer
……
then the viewer can be told to wait until it starts before attempting to connect to the console.

Refer to the above comments,move the bug to VERIFIED.
Comment 13 errata-xmlrpc 2015-07-22 06:30:06 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-1322.html
Note You need to log in before you can comment on or make changes to this bug.