Difference between revisions of "Doc/mboot"

From Syslinux Wiki
Jump to: navigation, search
(The content of doc/mboot.txt (release 3.72))
 
m (Delete unnecessary style; already stated by default in "MediaWiki:Common.css".)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Release Documentation]][[Category:System Deployment Image (SDI)]]
+
[[Category:Release Documentation]]
''The content of doc/mboot.txt (release 3.72):''
+
[[Category:Modules]]
 +
[[Category:Comboot]]
  
=mboot.c32=
+
''The content of doc/mboot.txt (<!--release -->6.04-pre1, with minor modifications):''
<tt>mboot.c32</tt> is a 32-bit comboot module that allows SYSLINUX and its variants to load and boot kernels that use the Multiboot standard (e.g. the Xen virtual machine monitor, and the Fiasco and GNU Mach microkernels).
+
 
 +
<div style="color: black; background: none; font-weight: normal; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa; font-size: 188%; ">mboot.c32</div>
 +
 
 +
<tt>mboot.c32</tt> is a 32-bit <s><small><del>comboot</del></small></s> ELF module that allows Syslinux and its  
 +
variants to load and boot kernels that use the Multiboot standard  
 +
(e.g. the Xen virtual machine monitor, and the Fiasco and GNU Mach  
 +
microkernels).
 +
 
 +
<!-- The following sentence is not part of the official documentation. -->
 +
{{V|6.04+}}<tt>mboot.c32</tt> supports loading ELF64 for Multiboot1 too.
 +
 
 +
To load a multiboot kernel and modules in Syslinux, put <tt>mboot.c32</tt> (from
 +
<!-- -->
 +
<!-- The <tt>com32/modules/</tt> directory used to contain -->
 +
<!-- a prior version of <tt>mboot.c32</tt>. -->
 +
<!-- A new <tt>mboot.c32</tt> module was created under -->
 +
<!-- the <tt>com32/mboot/</tt> directory, by commit: -->
 +
<!-- "First attempt at a rewritten mboot module" (2009-04-26) -->
 +
<!-- https://git.zytor.com/syslinux/syslinux.git/commit/?id=d7406d5c1233b28554756d533dafd1886a879073 -->
 +
<!-- https://git.kernel.org/pub/scm/boot/syslinux/syslinux.git/commit/?id=d7406d5c1233b28554756d533dafd1886a879073 -->
 +
<!-- https://repo.or.cz/syslinux.git/commit/d7406d5c1233b28554756d533dafd1886a879073 -->
 +
<!-- and the old code that used to be located under <tt>com32/modules</tt> -->
 +
<!-- was deleted, by commit: -->
 +
<!-- "Remove the old mboot module" (2009-04-26) -->
 +
<!-- https://git.zytor.com/syslinux/syslinux.git/commit/?id=26798641567f3057d2a910de2a767bb810815774 -->
 +
<!-- https://git.kernel.org/pub/scm/boot/syslinux/syslinux.git/commit/?id=26798641567f3057d2a910de2a767bb810815774 -->
 +
<!-- https://repo.or.cz/syslinux.git/commit/26798641567f3057d2a910de2a767bb810815774 -->
 +
<!-- -->
 +
<tt><s>com32/modules</s></tt> "<tt>com32/mboot/</tt>") in the boot directory, and load it as the "kernel" in the
 +
configuration file.  The command-line to pass to <tt>mboot.c32</tt> is the kernel
 +
command-line, followed by all the module command lines, separated with
 +
"<tt>---</tt>".  For example, to load a Xen VMM, xenlinux and an initrd:
 +
 
 +
{|
 +
|
 +
<nowiki>DEFAULT mboot.c32 xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/hda1 --- initrd.img</nowiki>
 +
|}
  
To load a multiboot kernel and modules in SYSLINUX, put <tt>mboot.c32</tt> (from <tt>com32/modules</tt>) in the boot directory, and load it as the "kernel" in the configuration file.  The command-line to pass to <tt>mboot.c32</tt> is the kernel command-line, followed by all the module command lines, separated with '---'.  For example, to load a Xen VMM, xenlinux and an initrd:
 
<pre>
 
DEFAULT mboot.c32 xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/hda1 --- initrd.img
 
</pre>
 
 
or, as a choice in a menu:
 
or, as a choice in a menu:
<pre>
 
LABEL Xen
 
  KERNEL mboot.c32
 
  APPEND xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/
 
hda1 --- initrd.img
 
</pre>
 
<tt>mboot.c32</tt> requires version 2.12 or later of SYSLINUX.
 
  
''Tim Deegan, May 2005''
+
{|
 +
|
 +
<nowiki>
 +
LABEL Xen
 +
  KERNEL mboot.c32
 +
  APPEND xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/hda1 --- initrd.img
 +
</nowiki>
 +
|}
 +
 
 +
<tt>mboot.c32</tt> requires version 2.12 or later of Syslinux.
 +
 
 +
<!-- During 2009Apr, the original mboot.c32 module from Tim Deegan -->
 +
<!-- was replaced in official Syslinux archives by a re-write from HPA. -->
 +
<!-- The official documentation was not modified. -->
 +
<!-- [https://www.syslinux.org/archives/2005-May/005136.html <!-- Loading Xen with PXELinux --><!-- Tim Deegan, May 2005] -->

Latest revision as of 20:51, 30 December 2018


The content of doc/mboot.txt (6.04-pre1, with minor modifications):

mboot.c32

mboot.c32 is a 32-bit comboot ELF module that allows Syslinux and its variants to load and boot kernels that use the Multiboot standard (e.g. the Xen virtual machine monitor, and the Fiasco and GNU Mach microkernels).

[6.04+] mboot.c32 supports loading ELF64 for Multiboot1 too.

To load a multiboot kernel and modules in Syslinux, put mboot.c32 (from com32/modules "com32/mboot/") in the boot directory, and load it as the "kernel" in the configuration file. The command-line to pass to mboot.c32 is the kernel command-line, followed by all the module command lines, separated with "---". For example, to load a Xen VMM, xenlinux and an initrd:

DEFAULT mboot.c32 xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/hda1 --- initrd.img

or, as a choice in a menu:

 LABEL Xen
   KERNEL mboot.c32
   APPEND xen.gz dom0_mem=15000 nosmp noacpi --- linux.gz console=tty0 root=/dev/hda1 --- initrd.img

mboot.c32 requires version 2.12 or later of Syslinux.