Difference between revisions of "Mboot.c32"

From Syslinux Wiki
Jump to: navigation, search
(better match to the syntax (but still not verified))
(Minor formatting clean up. Created some uniformity. Thanks for additions! Removed the FixMe tag)
Line 1: Line 1:
 
[[Category:Comboot]]
 
[[Category:Comboot]]
[[Category:FixMe]]
 
  
= About =  
+
== About ==  
'''mboot.c32''' is a comboot module for Syslinux that loads images using the Multiboot protocol.  A really good use case for this is booting Xen, or any other hypervisor based virtualization pieces that also require an initrd/initramfs.  If your Xen boot doesn't require an initrd then, then it is possible to utilize the existing kernel/append method.
+
'''mboot.c32''' is a comboot module for Syslinux that loads images using the Multiboot protocol.  A really good use case for this is booting [http://xensource.com Xen], or any other hypervisor based virtualization pieces that also require an initrd/initramfs.  If your Xen boot doesn't require an initrd then, then it is possible to utilize the existing kernel/append method.
Another use case for '''mboot.c32''' is to boot '''FreeBSD'''.
+
Another use case for mboot.c32 is to boot [http://freebsd.org FreeBSD] ELF kernels with rootfs.
  
= Requirements =  
+
== Requirements ==  
 
* working Syslinux environment
 
* working Syslinux environment
 
* mboot.c32
 
* mboot.c32
  
= Syntax =  
+
== Syntax ==  
 
  mboot.c32 stage1 stage1_args --- stage2 stage2_args --- stage3 stage3_args [ --- stageX stageX_args ]
 
  mboot.c32 stage1 stage1_args --- stage2 stage2_args --- stage3 stage3_args [ --- stageX stageX_args ]
  
Line 16: Line 15:
  
 
== Example ==
 
== Example ==
 +
 +
 +
=== Xen example===
 
Here is an example pxelinux.cfg file for booting [[Xen]]
 
Here is an example pxelinux.cfg file for booting [[Xen]]
 
<pre>
 
<pre>
Line 23: Line 25:
 
</pre>
 
</pre>
  
Here is an example pxelinux.cfg file for booting [[Xen]] over HTTP, when using gpxelinux.0 (needs testing)
 
<pre>
 
LABEL xen
 
  KERNEL http://fs.local/pxe/mboot.c32
 
  APPEND http://fs.local/pxe/xen-3.2.gz dom0_mem=262144 --- http://fs.local/pxe/vmlinuz-2.6.16-2-xen-686 console=tty0 \
 
root=/dev/md1 ro --- http://fs.local/pxe/initrd.img-2.6.16-2-xen-686
 
</pre>
 
  
Booting '''FreeBSD'''
+
=== FreeBSD example ===
  
 
http://syslinux.zytor.com/archives/2009-April/012124.html
 
http://syslinux.zytor.com/archives/2009-April/012124.html

Revision as of 01:57, 19 April 2009


About

mboot.c32 is a comboot module for Syslinux that loads images using the Multiboot protocol. A really good use case for this is booting Xen, or any other hypervisor based virtualization pieces that also require an initrd/initramfs. If your Xen boot doesn't require an initrd then, then it is possible to utilize the existing kernel/append method. Another use case for mboot.c32 is to boot FreeBSD ELF kernels with rootfs.

Requirements

  • working Syslinux environment
  • mboot.c32

Syntax

mboot.c32 stage1 stage1_args --- stage2 stage2_args --- stage3 stage3_args [ --- stageX stageX_args ]

The use of --- is required!

Example

Xen example

Here is an example pxelinux.cfg file for booting Xen

LABEL xen
  KERNEL mboot.c32
  APPEND xen-3.2.gz dom0_mem=262144 --- vmlinuz-2.6.16-2-xen-686 console=tty0 root=/dev/md1 ro --- initrd.img-2.6.16-2-xen-686


FreeBSD example

http://syslinux.zytor.com/archives/2009-April/012124.html

LABEL freebsd
  KERNEL mboot.c32
  APPEND  freebsd_kernel kernel_option kernel_option --- freebsd_initial_ramdisk