From coreboot
Revision as of 12:41, 25 October 2007 by Phs (talk | contribs) (Don't forget to apply the patches ;))
Jump to: navigation, search

The wiki is being retired!

Documentation is now handled by the same processes we use for code: Add something to the Documentation/ directory in the coreboot repo, and it will be rendered to Contributions welcome!

This article describes how to build LinuxBIOS v2 on FreeBSD and boot FreeBSD using LinuxBIOS and ADLO inside Qemu.


All steps outlined in this article have been performed using FreeBSD 7.0-BETA1. Other versions of FreeBSD might work, too, but have not been tested. The patches mentioned in this article have been created against LinuxBIOSv2, Revision 2897.

In order to build ADLO on FreeBSD, you need the following ports installed:

To build LinuxBIOS on FreeBSD, you need

  • devel/gmake
  • lang/python. At the time of writing this article, that port installs Python 2.4. Possibly other version of Python also work but haven't been tried.

To boot FreeBSD in QEMU you need

Obtaining LinuxBIOS

See this page on how to download LinuxBIOS. I recomment you checkout the latest Version of LinuxBIOS v2 using Subversion.

Applying the required patches

The LinuxBIOS build process assumes that the make utility is GNU make. This isn't true on FreeBSD (or the other BSDs for that matter), where GNU make is installed as gmake.

A patch which addresses this can be found here. To download and apply this patch, run the following commands from the top-level directory of your LinuxBIOS source tree (e.g. /home/phs/LinuxBIOSv2):

$ ftp
$ tar xzf LinuxBIOS_ADLO_FreeBSD.tgz
$ patch -p0 < LinuxBIOS_ADLO_FreeBSD.diff

Building ADLO

In order to boot FreeBSD using LinuxBIOS, ADLO is used as a payload. Therefore, it must be build before the LinuxBIOS image can be built. Building ADLO on FreeBSD requires that the 8086 development environment is installed. See the following section for details.

ADLO is part of the LinuxBIOS v2 source tree. Assuming you have applied the required patches, it can be build by issuing the following commands from the top-level directory of your LinuxBIOS v2 source tree:

$ cd util/ADLO
$ gmake

You will now find the ADLO payload at util/ADLO/payload.

Building the 8086 development environment

ADLO requires the devel/dev86 port which installs the 8086 development environment. This is a new port not yet included in the FreeBSD Ports tree, see Problem Report ports/117480. To build the port, download and extract the shell archive attached to the problem report.

$ ftp -o devel_dev.shar
$ sh devel_dev.shar
$ cd dev86
$ su
# make install

This has to be done only once, before building ADLO. You don't have to reinstall the port if you rebuild ADLO.

Building LinuxBIOS

The QEMU build tutorial covers all steps required to build LinuxBIOS for QEMU. As a quick reference, assuming you have applied the required patches do:

$ cd targets
$ ./buildtarget emulation/qemu-i386
$ cd emulation/qemu-i386/qemu-i386
$ gmake

Make sure you use the gmake utility on FreeBSD!

Booting FreeBSD inside QEMU