Bug 676981 - Update qemu-kvm bootorder/bootindex documentation
Summary: Update qemu-kvm bootorder/bootindex documentation
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: qemu-kvm
Version: 6.1
Hardware: Unspecified
OS: Unspecified
low
low
Target Milestone: rc
: ---
Assignee: Gleb Natapov
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-02-12 08:08 UTC by Keqin Hong
Modified: 2013-12-09 00:53 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-12-12 18:31:41 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Keqin Hong 2011-02-12 08:08:13 UTC
Description of problem:
QEMU-KVM now can use bootindex property to pass boot orders to seabios. As a result, the old "-boot [order=drives][,once=drives][,menu=on|off]" will become obsolete.
If both "-boot [order=drives][,once=drives][,menu=on|off]" and bootindex property of NIC/block devices are provided, the former will be overridden.

Please update qemu-kvm help and manpage accordingly.
Since bootindex for floppy drives is a special case (-global isa-fdc.bootindexB=xx -global isa-fdc.bootindexA=yy), please also document it separately.

Version-Release number of selected component (if applicable):
qemu-kvm-0.12.1.2-2.144.el6.x86_64

How reproducible:
100%

Steps to Reproduce:
1. $ man qemu-kvm
2. $ /usr/libexec/qemu-kvm --help
3.
  
Actual results:


Expected results:


Additional info:

Comment 2 Gleb Natapov 2011-02-12 13:35:20 UTC
Bootindex is a device property. Device properties are not documented in help string. To see available device properties use qemu-kvm -device  isa-fdc,\? or qemu-kvm -device virtio-blk-pci,\?. Not sure this bug is valid.

Comment 3 Keqin Hong 2011-02-14 02:40:48 UTC
(In reply to comment #2)
> Bootindex is a device property. Device properties are not documented in help
> string.
Agree that device properties are not documented in help string, but can be obtained from "qemu-kvm -device $driver,\?.

Do you think that it's reasonable to document in manpage/help string as mentioned in Comment 0 —— "If both "-boot [order=drives][,once=drives][,menu=on|off]" and bootindex
property of NIC/block devices are provided, the former will be overridden.
" ?

There's no such notice in either manpage or help string. Users may find [order=drives][,once=drives] doesn't work.

Comment 4 Gleb Natapov 2011-02-14 09:01:03 UTC
(In reply to comment #3)
> (In reply to comment #2)
> > Bootindex is a device property. Device properties are not documented in help
> > string.
> Agree that device properties are not documented in help string, but can be
> obtained from "qemu-kvm -device $driver,\?.
> 
> Do you think that it's reasonable to document in manpage/help string as
> mentioned in Comment 0 —— "If both "-boot
> [order=drives][,once=drives][,menu=on|off]" and bootindex
> property of NIC/block devices are provided, the former will be overridden.
> " ?
> 
> There's no such notice in either manpage or help string. Users may find
> [order=drives][,once=drives] doesn't work.

Yes. It is definitely worth mentioning somewhere.


Note You need to log in before you can comment on or make changes to this bug.