Bug 676981

Summary:	Update qemu-kvm bootorder/bootindex documentation
Product:	Red Hat Enterprise Linux 6	Reporter:	Keqin Hong <khong>
Component:	qemu-kvm	Assignee:	Gleb Natapov <gleb>
Status:	CLOSED WONTFIX	QA Contact:	Virtualization Bugs <virt-bugs>
Severity:	low	Docs Contact:
Priority:	low
Version:	6.1	CC:	gcosta, gleb, juzhang, knoel, michen, mkenneth, tburke, virt-maint
Target Milestone:	rc
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-12-12 18:31:41 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

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.