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 837761 - [Doc] Inaccurate description about force option in change-media help
Summary: [Doc] Inaccurate description about force option in change-media help
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: libvirt
Version: 6.4
Hardware: Unspecified
OS: Unspecified
medium
low
Target Milestone: rc
: ---
Assignee: Gunannan Ren
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-07-05 07:16 UTC by hongming
Modified: 2013-02-21 07:18 UTC (History)
9 users (show)

Fixed In Version: libvirt-0.10.1-1.el6
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2013-02-21 07:18:54 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHSA-2013:0276 0 normal SHIPPED_LIVE Moderate: libvirt security, bug fix, and enhancement update 2013-02-20 21:18:26 UTC

Description hongming 2012-07-05 07:16:26 UTC 
Description of problem:
The force option in virsh change-media help page isn't  correctly described. 

Version-Release number of selected component (if applicable):
libvirt-0.9.13-2.el6.x86_64

How reproducible:
100% 

Steps to Reproduce:
1. # virsh help change-media

 --force         force media insertion  (it is not only for force media insertion  but also for force media changing )


2. #man virsh
 
The --force option can be used to force media changing.
 

3.  # virsh change-media qed-rhel6.3 hdd --eject --force
succeeded to complete action eject on media
 
# virsh change-media qed-rhel6.3 hdd /var/lib/libvirt/images/aaa.iso --update --force
succeeded to complete action update on media

  
Actual results:


Expected results:


Additional info:
Comment 2 Dave Allan 2012-07-06 18:50:42 UTC 
Yeah, agreed that it should read:

    --force          force operation
Comment 3 Gunannan Ren 2012-08-31 10:20:11 UTC 
commit c3e7245af5e8b07c7f3d4c6548b10f0f2227f9e5
Author: Guannan Ren <gren>
Date:   Fri Aug 31 17:58:44 2012 +0800

    doc: update option force to subcommand change-media
    
    BZ: https://bugzilla.redhat.com/show_bug.cgi?id=837761
Comment 5 yuping zhang 2012-09-03 06:08:07 UTC 
Verified this issue with libvirt-0.10.1-1.el6.x86_64.

# virsh help change-media
  NAME
    change-media - Change media of CD or floppy drive

  SYNOPSIS
    change-media <domain> <path> [<source>] [--eject] [--insert] [--update] [--current] [--live] [--config] [--force]

  DESCRIPTION
    Change media of CD or floppy drive.

  OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--path] <string>  Fully-qualified path or target of disk device
    [--source] <string>  source of the media
    --eject          Eject the media
    --insert         Insert the media
    --update         Update the media
    --current        can be either or both of --live and --config, depends on implementation of hypervisor driver
    --live           alter live configuration of running domain
    --config         alter persistent configuration, effect observed on next boot
    --force          force media changing <=================== updated.

So change the bug status to VERIFIED.
Comment 6 errata-xmlrpc 2013-02-21 07:18:54 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/RHSA-2013-0276.html
Note You need to log in before you can comment on or make changes to this bug.