Bug 757659

Summary: [general operation] As qemu-kvm don't support multiboot the relevant info should be removed from help.
Product: Red Hat Enterprise Linux 6 Reporter: Min Deng <mdeng>
Component: qemu-kvmAssignee: Miroslav Rezanina <mrezanin>
Status: CLOSED NOTABUG QA Contact: Virtualization Bugs <virt-bugs>
Severity: medium Docs Contact:
Priority: low    
Version: 6.3CC: acathrow, amit.shah, armbru, bcao, bsarathy, juzhang, knoel, michen, mkenneth, mrezanin, pbonzini, qzhang, sluo, tburke, virt-maint, vrozenfe
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: 2012-03-13 16:19:50 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 Min Deng 2011-11-28 10:09:35 UTC
Description of problem:
  qemu-kvm don't support multiboot but help describes that it is supported.It should be removed from help document.
Version-Release number of selected component (if applicable):
qemu-kvm-0.12.1.2-2.209.el6.x86_64
How reproducible:
always 
Steps to Reproduce:
1.install qemu-kvm
2.man qemu-kvm and find "Linux/Multiboot boot specific:"
   Linux/Multiboot boot specific:

       When using these options, you can use a given Linux or Multiboot kernel without installing it in the
       disk image. It can be useful for easier testing of various kernels.

    ...

       -initrd "file1 arg=foo,file2"
           This syntax is only available with multiboot.

           Use file1 and file2 as modules and pass arg=foo as parameter to the first module.
  
  
Actual results:It shows that the multiboot is supported here.Communicated with developer and be told that it don't supported.

Expected results:
qemu-kvm don't support this option so please remove it from help. 


Additional info:

Comment 2 Markus Armbruster 2011-12-09 10:59:53 UTC
Re "Communicated with developer and be told that it don't supported."  Does "not supported" mean that qemu-kvm doesn't do multiboot, or that use of multiboot is not supported in RHEL-6?

Comment 4 Min Deng 2011-12-15 08:33:16 UTC
Hi Markus,
  
   I attached the mail as the followingm,which was sent by developer.And a sample was also provided in it and hope it can help you.Thanks.
   > Just only one parameter follow *"-initrd"* option.
> > 
> > But I learn from qemu-kvm's help (man qemu-kvm) ,the help describes the
> > option as the following.
> > -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
> > 
> > -initrd "file1 arg=foo,file2"
> >             This syntax is only available with multiboot.
> > 
> >             Use file1 and file2 as modules and pass arg=foo as
> > parameter to the
> >             first module.
I wasn't aware of this.  As far as I know we don't support multiboot,
so this help text should be modified in the man page.

FWIW the --help output lists only:

Linux/Multiboot boot specific:
-kernel bzImage use 'bzImage' as kernel image
-append cmdline use 'cmdline' as kernel command line
-initrd file    use 'file' as initial ram disk

so we should be fine there.

Any issues please let me know.

Best regards,
Min

Comment 5 Markus Armbruster 2011-12-19 09:29:42 UTC
Upstream QEMU has quite a few features we don't support in RHEL.

Some of them we make unavailable in RHEL.  This should be done consistently in code and documentation.  In particular, the unavailable feature should be removed from the RHEL man page as well.

Others are still available, but their use is unsupported.  We generally do *not* hide them.  In particular, we generally don't remove them from man pages.

As far as I can tell, the multiboot feature is of the second kind: it's available, but its use is unsupported.  If that's correct, this bug should be CLOSED/NOTABUG.