Difference between revisions of "GRUB2"

From coreboot
Jump to: navigation, search
(How to build GRUB2 as a payload)
m
Line 1: Line 1:
 +
'''[http://grub.enbug.org/ GRUB2]''' is a modular, multiboot-capable bootloader for many operating systems.
 +
 
GRUB2 is an ideal payload for coreboot. It's modular, extensible, supports booting off filesystems, and it has a scriptable shell. Our goal is to replace the common coreboot payload [[FILO]] with a coreboot-capable version of GRUB2.
 
GRUB2 is an ideal payload for coreboot. It's modular, extensible, supports booting off filesystems, and it has a scriptable shell. Our goal is to replace the common coreboot payload [[FILO]] with a coreboot-capable version of GRUB2.
 
== History ==
 
 
[[User:PatrickGeorgi|Patrick Georgi]] has been working on GRUB2 for coreboot during the Google Summer of Code 2007. He made an [http://coreboot.org/~oxygene/lbgrub2-20070820-1.tar.bz2 original code submission] on August 20th 2007. Please read [http://coreboot.org/~oxygene/lbgrub2-instructions.txt GRUB2 on coreboot instructions] for information on how to use it.
 
 
This work was subsequently rejected by the GRUB project, and was eventually re-implemented by Robert Millan, one of the GRUB project members. The re-implementation lacks a couple of fundamental features. From this new base, more work was done.
 
  
 
== Status ==
 
== Status ==
Line 11: Line 7:
 
As of the time of this writing, the official GRUB2 can not be loaded in coreboot v2 without a small patch. It works fine with coreboot v3.
 
As of the time of this writing, the official GRUB2 can not be loaded in coreboot v2 without a small patch. It works fine with coreboot v3.
  
* A significant amount of work has been put into GRUB2 in our [[MonotoneRepository]], which also provides snapshots.
+
* A significant amount of work has been put into GRUB2 in our [[MonotoneRepository|monotone repository]], which also provides snapshots.
 
* The mainline version of GRUB2 has a [http://grub.enbug.org/CoreBoot wiki page on the coreboot port].
 
* The mainline version of GRUB2 has a [http://grub.enbug.org/CoreBoot wiki page on the coreboot port].
 
== TODO ==
 
 
* Mainstream GRUB2's grub-mkimage needs to put the program headers right after the elf header ([http://www.mail-archive.com/grub-devel@gnu.org/msg03547.html Fix available]).
 
* USB stack integration (in progress).
 
* See more information in the "[http://tracker.coreboot.org/trac/coreboot/milestone/Port%20GRUB2%20to%20coreboot Porting GRUB2 to coreboot]" milestone in the coreboot issue tracker.
 
  
 
== How to build GRUB2 as a payload ==
 
== How to build GRUB2 as a payload ==
  
First, get a recent snapshot of the [[http://www.coreboot.org/MonotoneRepository GRUB2 monotone repository]] ('''allpatches''' branch):
+
It's recommended to use a recent snapshot of the '''allpatches''' branch in the [[MonotoneRepository|GRUB2 monotone repository]]
 
+
(you can also just download http://coreboot.org:8889/branch/head/tar/org.coreboot.grub2.allpatches - which resolves to the latest revision on that branch; the top level directory in the resulting tarball represents the revision ID, which is a SHA-1 value over revision data, and thus varies wildly).
(you can also just download http://coreboot.org:8889/branch/head/tar/org.coreboot.grub2.allpatches - which resolves to the latest revision on that branch. the top level directory in the resulting tar ball represents the revision id, which is a SHA1 value over revision data, and thus varies wildly)
+
  
 
  $ wget 'http://coreboot.org:8889/revision/tar/dfb745863916f6f022db54421bf07a6c19ba053e' -O grub2.tar
 
  $ wget 'http://coreboot.org:8889/revision/tar/dfb745863916f6f022db54421bf07a6c19ba053e' -O grub2.tar
Line 35: Line 24:
 
  $ make install
 
  $ make install
 
  $ $PWD/installed/bin/grub-mkimage -o core.img normal fat iso9660 pc ata memdisk lar ls cat cmp hello help serial terminal test configfile multiboot boot loopback
 
  $ $PWD/installed/bin/grub-mkimage -o core.img normal fat iso9660 pc ata memdisk lar ls cat cmp hello help serial terminal test configfile multiboot boot loopback
 +
 +
== TODO ==
 +
 +
* Mainstream GRUB2's grub-mkimage needs to put the program headers right after the ELF header ([http://www.mail-archive.com/grub-devel@gnu.org/msg03547.html Fix available]).
 +
* USB stack integration (in progress).
 +
* See more information in the "[http://tracker.coreboot.org/trac/coreboot/milestone/Port%20GRUB2%20to%20coreboot Porting GRUB2 to coreboot]" milestone in the coreboot issue tracker.
 +
 +
== History ==
 +
 +
[[User:PatrickGeorgi|Patrick Georgi]] has been working on GRUB2 for coreboot during the Google Summer of Code 2007. He made an [http://coreboot.org/~oxygene/lbgrub2-20070820-1.tar.bz2 original code submission] on August 20th 2007. Please read [http://coreboot.org/~oxygene/lbgrub2-instructions.txt GRUB2 on coreboot instructions] for information on how to use it.
 +
 +
This work was subsequently rejected by the GRUB project, and was eventually re-implemented by Robert Millan, one of the GRUB project members. The re-implementation lacks a couple of fundamental features. From this new base, more work was done.
  
 
== How to help? ==
 
== How to help? ==
  
 
Contact [mailto:stepan@coresystems.de Stefan Reinauer], [mailto:oxygene@coresystems.de Patrick Georgi] or the [[Mailinglist|coreboot mailing list]] for more information.
 
Contact [mailto:stepan@coresystems.de Stefan Reinauer], [mailto:oxygene@coresystems.de Patrick Georgi] or the [[Mailinglist|coreboot mailing list]] for more information.

Revision as of 14:01, 19 April 2008

GRUB2 is a modular, multiboot-capable bootloader for many operating systems.

GRUB2 is an ideal payload for coreboot. It's modular, extensible, supports booting off filesystems, and it has a scriptable shell. Our goal is to replace the common coreboot payload FILO with a coreboot-capable version of GRUB2.

Status

As of the time of this writing, the official GRUB2 can not be loaded in coreboot v2 without a small patch. It works fine with coreboot v3.

How to build GRUB2 as a payload

It's recommended to use a recent snapshot of the allpatches branch in the GRUB2 monotone repository (you can also just download http://coreboot.org:8889/branch/head/tar/org.coreboot.grub2.allpatches - which resolves to the latest revision on that branch; the top level directory in the resulting tarball represents the revision ID, which is a SHA-1 value over revision data, and thus varies wildly).

$ wget 'http://coreboot.org:8889/revision/tar/dfb745863916f6f022db54421bf07a6c19ba053e' -O grub2.tar
$ tar xfv grub2.tar
$ cd dfb745863916f6f022db54421bf07a6c19ba053e
$ sh autogen.sh
$ ./configure --with-platform=linuxbios --prefix=$PWD/installed
$ make
$ chmod 755 mkinstalldirs
$ make install
$ $PWD/installed/bin/grub-mkimage -o core.img normal fat iso9660 pc ata memdisk lar ls cat cmp hello help serial terminal test configfile multiboot boot loopback

TODO

  • Mainstream GRUB2's grub-mkimage needs to put the program headers right after the ELF header (Fix available).
  • USB stack integration (in progress).
  • See more information in the "Porting GRUB2 to coreboot" milestone in the coreboot issue tracker.

History

Patrick Georgi has been working on GRUB2 for coreboot during the Google Summer of Code 2007. He made an original code submission on August 20th 2007. Please read GRUB2 on coreboot instructions for information on how to use it.

This work was subsequently rejected by the GRUB project, and was eventually re-implemented by Robert Millan, one of the GRUB project members. The re-implementation lacks a couple of fundamental features. From this new base, more work was done.

How to help?

Contact Stefan Reinauer, Patrick Georgi or the coreboot mailing list for more information.