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 832329 - [Doc]Problems about help of virsh domiftune command
Summary: [Doc]Problems about help of virsh domiftune command
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: libvirt
Version: 6.3
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: rc
: ---
Assignee: Martin Kletzander
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-06-15 07:54 UTC by hongming
Modified: 2013-02-21 07:17 UTC (History)
7 users (show)

Fixed In Version: libvirt-0.9.13-3.el6
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2013-02-21 07:17:44 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-06-15 07:54:28 UTC
Description of problem:
There are some problems about  help of virsh domiftune command.Please pay attention to the content of brackets



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

How reproducible:
100% 

Steps to Reproduce:
1.#virsh help domiftune
 
  NAME
    domiftune - get/set parameters of a virtual interface

  SYNOPSIS
    domiftune <domain> <interface> [<inbound>] [<outbound>] [--config] [--live] [--current]

  DESCRIPTION
    Get/set parameters of a domain's virtual interface.

  OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--interface] <string>  interface device (Should add "MAC address")
    [--inbound] <string>  control domain's incoming traffics (Should be <number>)
    [--outbound] <string>  control domain's outgoing traffics (Should be <number>)
    --config         affect next boot
    --live           affect running domain
    --current        affect current domain


2.# virsh domiftune rhel6u31 vnet4 --outbound 1000000,2000000,200

3. # virsh domiftune rhel6u31 vnet4
inbound.average: 1000000
inbound.peak   : 2000000
inbound.burst  : 200
outbound.average: 1000000
outbound.peak  : 2000000
outbound.burst : 200

  
Actual results:


Expected results:
Please pay attention to the content of brackets.

Additional info:

Comment 2 hongming 2012-06-15 08:10:24 UTC
The lost of  "Mac address"  also can be reproduced in the help of virsh domifstat command

# virsh help domifstat
  NAME
    domifstat - get network interface stats for a domain

  SYNOPSIS
    domifstat <domain> <interface>

  DESCRIPTION
    Get network interface stats for a running domain.

  OPTIONS
    [--domain] <string>  domain name, id or uuid 
    [--interface] <string>  interface device (Should add "MAC address")

Comment 3 Martin Kletzander 2012-06-19 08:54:10 UTC
I'm sorry, but I really don't follow here. Are you saying that there should be <MAC address> and <number> instead of <string>? Or <number>,<number>,<number> and so on?

This info is generated from the code and for the generator it's only known what is allowed to be there before anything else gets parsed from it. The generator cannot say what should be the format of the string or the data. Both syntax and semantic is done after that. Apart from other programs, we are at least showing the user what format are we expecting (instead of [--inbound] INBOUND, [--outbound] OUTBOUND, and so on).

In case you meant it some other way around, don't hesitate and let me know.

Thanks

Comment 4 hongming 2012-06-19 09:39:11 UTC
Sorry , I misunderstood the format of inbound and outbound argument. They should be <string >. It works fine as follows
# virsh domiftune rhel6u31 vnet1 --inbound "10,10,20"
# virsh domiftune rhel6u31 vnet1 --inbound 10,10,10

About adding "MAC address" in help ,I also refer to the help of domif-getlink and 
domif-setlink. And the Mac Address argument also works in domiftune command, so we also should show the "Mac Address" in the instruction of "interface" argument. They should be consistent.
       

# virsh help domif-setlink
OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--interface] <string>  interface device (MAC Address)
    [--state] <string>  new state of the device
    --persistent     persist interface state

# virsh help domif-getlink
OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--interface] <string>  interface device (MAC Address)
    --persistent     Get persistent interface state

# virsh domiftune rhel6u31 52:54:00:e1:fe:89
inbound.average: 30
inbound.peak   : 0
inbound.burst  : 0
outbound.average: 0
outbound.peak  : 0
outbound.burst : 0

#virsh help domiftune
OPTIONS
    [--interface] <string>  interface device (Should add "MAC address")

Comment 5 hongming 2012-06-19 09:47:04 UTC
domifstat don't support the "MAC address" as interface argument.It only support "target name".Please ignore Comment 2. 

# virsh domifstat rhel6u31 52:54:00:e1:fe:89
error: Failed to get interface stats rhel6u31 52:54:00:e1:fe:89
error: invalid argument: invalid path, '52:54:00:e1:fe:89' is not a known interface

# virsh domifstat rhel6u31 vnet1 
vnet1 rx_bytes 471972
vnet1 rx_packets 6278
vnet1 rx_errs 0
vnet1 rx_drop 0
vnet1 tx_bytes 278714
vnet1 tx_packets 1036
vnet1 tx_errs 0
vnet1 tx_drop 0

Comment 6 Martin Kletzander 2012-06-19 12:47:05 UTC
Moving to POST:

commit 4b2273074c2459136c67e657d2a2ac2e9db6f5a4
Author: Martin Kletzander <mkletzan>
Date:   Tue Jun 19 14:14:50 2012 +0200

    virsh: make domiftune interface help string consistent

Comment 8 yuping zhang 2012-07-24 07:21:03 UTC
Verified this issue with libvirt-0.9.13-3.el6.x86_64.
 
The MAC Address has been add to interface of domif-setlink,domif-getlink and domiftune commands.

#virsh help domif-setlink
  NAME
    domif-setlink - set link state of a virtual interface

  SYNOPSIS
    domif-setlink <domain> <interface> <state> [--config]

  DESCRIPTION
    Set link state of a domain's virtual interface. This command wraps usage of update-device command.

  OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--interface] <string>  interface device (MAC Address)
    [--state] <string>  new state of the device
    --config         affect next boot

# virsh help domif-getlink
  NAME
    domif-getlink - get link state of a virtual interface

  SYNOPSIS
    domif-getlink <domain> <interface> [--config]

  DESCRIPTION
    Get link state of a domain's virtual interface.

  OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--interface] <string>  interface device (MAC Address)
    --config         Get persistent interface state

# virsh help domiftune
  NAME
    domiftune - get/set parameters of a virtual interface

  SYNOPSIS
    domiftune <domain> <interface> [<inbound>] [<outbound>] [--config] [--live] [--current]

  DESCRIPTION
    Get/set parameters of a domain's virtual interface.

  OPTIONS
    [--domain] <string>  domain name, id or uuid
    [--interface] <string>  interface device (MAC Address)
    [--inbound] <string>  control domain's incoming traffics
    [--outbound] <string>  control domain's outgoing traffics
    --config         affect next boot
    --live           affect running domain
    --current        affect current domain

So change the bug status to VERIFIED.

Comment 9 errata-xmlrpc 2013-02-21 07:17:44 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.