FILO: Difference between revisions

From coreboot
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(41 intermediate revisions by 13 users not shown)
Line 1: Line 1:
[[Image:Qemu filo.png|thumb|right|FILO trying to load menu.lst.]]
[[Image:Qemu filo prompt.png|thumb|right|FILO prompt.]]
'''FILO''' is a bootloader which loads boot images from a local filesystem,
'''FILO''' is a bootloader which loads boot images from a local filesystem,
without help from legacy BIOS services.
without help from legacy BIOS services.
Line 6: Line 9:
== Download FILO ==
== Download FILO ==


Download the latest version of FILO from Subversion with
Download the latest version of FILO from Git with


  $ svn co svn://coreboot.org/filo/trunk/filo-0.5
  $ git clone http://review.coreboot.org/p/filo.git


You can also browse the source code online at
You can also browse the source code online at
http://openbios.org/viewvc/trunk/?root=FILO
http://review.coreboot.org/gitweb?p=filo.git


== Features ==
== Features ==


* Supported boot devices: IDE hard disk, SATA hard disk, CD-ROM, and system memory (ROM)
* Supported boot devices: IDE hard disk, SATA hard disk, CD-ROM, USB Mass Storage, and system memory (ROM)
* Supported filesystems: ext2, fat, jfs, minix, reiserfs, xfs, and iso9660
* Supported filesystems: ext2, fat, jfs, minix, reiserfs, xfs, and iso9660
* Supported image formats: ELF and [b]zImage (a.k.a. /vmlinuz)
* Supported image formats: ELF and [b]zImage (a.k.a. /vmlinuz)
Line 25: Line 28:
* Auxiliary tool to compute checksum of ELF boot images
* Auxiliary tool to compute checksum of ELF boot images
* Full 32-bit code, no BIOS calls
* Full 32-bit code, no BIOS calls
* uses [[libpayload]]


== Requirements ==
== Requirements ==
Line 32: Line 36:
for more information.
for more information.


x64/AMD 64 machines work fine when compiling FILO in 32-bit mode.
Recent version of GNU toolchain is required to build.  
(coreboot uses 32-bit mode and Linux kernel does the transition to 64-bit mode)
 
Recent version of GNU toolchain is required to build.


We have tested with Debian/woody (gcc 2.95.4, binutils 2.12.90.0.1,
We have tested with Debian/woody (gcc 2.95.4, binutils 2.12.90.0.1,
make 3.79.1), Debian/sid (gcc 3.3.2, binutils 2.14.90.0.6,
make 3.79.1), Debian/sid (gcc 3.3.2, binutils 2.14.90.0.6,
make 3.80) and different versions of SUSE Linux from 9.0 to 10.3.
make 3.80) and different versions of SUSE Linux from 9.0 to 11.0.


On AMD64 for Debian install the gcc-multilib package.
FILO will use the coreboot crossgcc if you have it built and it can be found.


== Install ==
FILO uses coreboot's '''libpayload'''. It is easiest to locate and build FILO in the '''coreboot/payloads''' directory.


First invocation of make creates the default Config file.
== Building on 64-bit OS specifics ==
  $ make
Edit this file as you like. It's fairly straightforward (I hope).
  $ vi Config
Then running make again will build filo.elf, the ELF boot image of FILO.
  $ make


Use filo.elf as your payload of coreboot, or a boot image for
If you will be building FILO on AMD64 platform for Debian install the '''gcc-multilib''' package.
[[Etherboot]].


If you enable MULTIBOOT_IMAGE option in Config, you can
x64/AMD64 machines work fine when compiling FILO in 32-bit mode.
also boot filo.elf from GNU GRUB or other Multiboot bootloader.
(coreboot uses 32-bit mode and Linux kernel does the transition to 64-bit mode)
This feature is intended for testing or development purpose.


== Credits ==
== Preparation ==


This software was originally developed by SONE Takeshi <ts1@tsn.or.jp> and is now maintained by [mailto:stepan@coresystems.de Stefan Reinauer].
Before you can build FILO, you have to build libpayload. If your filo directory is located inside the coreboot/payloads directory, you don't have to do anything special. If for some reason you want to compile FILO of the coreboot/payloads directory, you will need to tell the makefile where libpayload is. Open filo/Makefile in your favorite text editor and change this line


== Additional Information ==
  export LIBCONFIG_PATH := $(src)/../libpayload


=== FILO on the ARIMA HDAMA ===
to match the location of the libpayload directory on your system:
This is a quick guide for getting coreboot up and running on the Arima HDAMA dual Opteron mainboard. If there are blanks to be filled in, go ahead and either ask on the [[Mailinglist|coreboot mailing list]] or you can reach me at cro_marmot_at_comcast.net. -- David Hendricks


Quick coreboot install guide for HDAMA,
  export LIBCONFIG_PATH := /home/YOUR_USER_NAME/PATH_TO_COREBOOT/payloads/libpayload
David W. Hendricks, May 13 2004


Requirement: Kernel with framebuffering either in an initrd or compiled
== Configuration ==
statically in. Do not enable the "no BIOS init" option for ATi Mach64
framebuffering. An example .config can be found here:
http://home.comcast.net/~zen_weasel/linuxbios_stuff/hdama/kernel.config
==== Building coreboot ====
1. Grab the latest CVS code from https://sourceforge.net/cvs/?group_id=3206


2. Add the following lines to src/mainboard/arima/hdama/Config.lb for VGA
Configure FILO (and libpayload) using the Kconfig interface:
functionality:
  ## ATI Rage XL framebuffering graphics driver
  dir /drivers/ati/ragexl


3. Edit the targets/arima/hdama/Config.lb file and add this for VGA:
   $ make menuconfig
   uses CONFIG_CONSOLE_BTEXT
  option CONFIG_CONSOLE_BTEXT=1


4. Select a payload. Example:
This will run menuconfig twice -- the first time for libpayload, the second time for FILO.
  payload /usr/src/filo-0.4.1_btext/filo.elf
I'll elaborate on this a little later.


5. Run "buildtarget arima/hdama" from the targets/ directory. cd to the
== Building ==
arima/hdama/hdama directory and run "make"


6. If all went well during the build process, you should have a coreboot.rom
Then running make will build filo.elf, the ELF boot image of FILO.
image in targets/arima/hdama/hdama/ .
  $ make


Back to #4 -- FILO is a file loader for ELF images. It provides
If you are compiling on an AMD64 platform and compiler complains, instead of "make" you need to write
minimal bootloader functionality. To build a FILO payload:
1. Download FILO with BText for optional VGA:
http://home.comcast.net/~zen_weasel/linuxbios_stuff/hdama/filo_0.4.1_btext.tar.bz2


2. Decompress, edit Config. If you're booting off a disk, you can use a
  $ make CC="gcc -m32" LD="ld -b elf32-i386" HOSTCC="gcc" AS="as --32"
LILO-like line to boot a kernel image. Example:
AUTOBOOT_FILE = "hda1:/boot/x86_64 root=/dev/hda2 console=ttyS0,115200 console=tty0 vga=792 video=atyfb:mode:1024x768"


Booting a kernel off of the flash your BIOS is on requires that you know exactly
Use '''build/filo.elf''' as your payload of coreboot, or a boot image for
it's located. If you do know this information, you can use AUTOBOOT_FILE =
[[Etherboot]].
"mem@0x00000000" where 0x00000000 is the actual location in hexadecimal.


Also, make sure you have proper filesystem
Alternatively, you can build libpayload and FILO in one go using the build.sh script, with the drawback that you'll get the default options for both of them:
support for whichever partition has your kernel image. Example: FSYS_EXT2FS = 1
  $ ./build.sh


An example FILO config file can be found here:
Here is the short listing how to build FILO from git
[http://home.comcast.net/~zen_weasel/linuxbios_stuff/hdama/FILO_Config]
cd coreboot/payloads
git clone http://review.coreboot.org/p/filo.git
cd filo
make config
make


3. Run "make" and you should now have a filo.elf ELF image. Use this as your
== Credits ==
payload in step #4 for building coreboot.


==== Troubleshooting ====
* This software was originally developed by SONE Takeshi <ts1@tsn.or.jp>
* It has been significantly enhanced and is now maintained by [mailto:stepan@coresystems.de Stefan Reinauer].
* It uses libpayload from Uwe Hermann and Jordan Crouse


Q: coreboot.strip is too big, image is greater than 64KB
== Troubleshooting ==
A: A good way to reduce image size is simply to reduce the log level. Change
these lines in your targets/arima/hdama/Config.lb file:
option DEFAULT_CONSOLE_LOGLEVEL=9
option MAXIMUM_CONSOLE_LOGLEVEL=9


You can bring them down gradually. I've found that "7" works well with the  
If you experience trouble compiling or using FILO, please report with a build log or detailed error description to the [[Mailinglist|coreboot mailing list]].
freebios source I downloaded before writing this.


=== FILO on AMD64 ===
== Notes ==
 
Installing coreboot + [[Filo]] (0.4.1) on an AMD64 box.
 
==== Configuration ====
 
#define AUTOBOOT_FILE "hda2:/boot/vmlinuz.lb root=/dev/hda2 \
                initrd=/boot/initrd.lb console=ttyS0,115200 console=tty0 video=atyfb:1024x768-16"
#define AUTOBOOT_DELAY 4
#define IDE_DISK 1
#define VGA_CONSOLE 1
#define PC_KEYBOARD 1
#define SERIAL_CONSOLE 1
#define SERIAL_IOBASE 0x3f8
#define SERIAL_SPEED 115200
#define FSYS_EXT2FS 1
#define FSYS_FAT 1
#define FSYS_JFS 1
#define FSYS_MINIX 1
#define FSYS_REISERFS 1
#define FSYS_XFS 1
#define FSYS_ISO9660 1
#define ELTORITO 1
#define SUPPORT_PCI 1
#define LINUX_LOADER 1
#define PCI_CONFIG_1 1
 
==== Installation ====
 
Installing SuSE 9.0 AMD64 on a Solo-System:
 
FILO version 0.4.1 (stepan@prokofjieff) Thu Oct 30 13:29:16 CET 2003
Press <Enter> for default boot, or <Esc> for boot prompt... 
boot: hdc:/boot/loader/linux initrd=/boot/loader/initrd console=ttyS0,115200n8


== Notes ==
=== CD-ROM Booting ===


To boot a CD-ROM or DVD you only need to specify the drive '''without a partition number'''. For example to boot to the primary drive on the secondary IDE channel you would use '''hdc''' and not '''hdc1''' in FILO.
To boot a CD-ROM or DVD you only need to specify the drive '''without a partition number'''. For example to boot to the primary drive on the secondary IDE channel you would use '''hdc''' and not '''hdc1''' in FILO.


If you are using FILO with '''USE_GRUB = 1''', and want to boot to your Linux install disk you have to do a mixture of GRUB and FILO commands.
=== Grub-like Interface ===
If you are using FILO with '''CONFIG_USE_GRUB''', and want to boot to your Linux install disk you have to do a mixture of GRUB and FILO commands.


Like GRUB you have to append a kernel (and parameters), then an initrd, and give a boot command.
Like GRUB you have to append a kernel (and parameters), then an initrd, and give a boot command.
Line 176: Line 116:


Example to boot to a GeeXboX install CD-ROM:
Example to boot to a GeeXboX install CD-ROM:
  grub>kernel hdc:/GEEXBOX/boot/vmlinuz root=/dev/ram0 rw init=linuxrc boot=cdrom installator
  filo> kernel hdc:/GEEXBOX/boot/vmlinuz root=/dev/ram0 rw init=linuxrc boot=cdrom installator
Press <ENTER>
Press <ENTER>
  grub>initrd hdc:/GEEXBOX/boot/initrd.gz
  filo> initrd hdc:/GEEXBOX/boot/initrd.gz
Press <ENTER>
Press <ENTER>
  grub>boot
  filo> boot
Press <ENTER>
Press <ENTER>


Your system will now boot right into the Linux install.
Your system will now boot right into the Linux install.
=== NVRAM Parsing ===
FILO parses the following NVRAM variables:
* 'boot_devices' can contain a list of boot devices seperated by semicolons. FILO will try to load filo.lst / menu.lst from any of these devices.
Example how to set:
nvramtool -w "boot_devices=hda1:/boot/filo;hdc:"
= Contributing =
To be able to contribute you will need a Gerrit account. See [[Git]] on how to get one and how to push new code to the repository. The instructions there are valid also for FILO, just change '''coreboot''' to '''filo''' in ''directory'' names etc. (not hostnames).

Latest revision as of 13:44, 30 August 2013

FILO trying to load menu.lst.
FILO prompt.

FILO is a bootloader which loads boot images from a local filesystem, without help from legacy BIOS services.

Expected usage is to flash it into the BIOS ROM together with coreboot.

Download FILO

Download the latest version of FILO from Git with

$ git clone http://review.coreboot.org/p/filo.git

You can also browse the source code online at http://review.coreboot.org/gitweb?p=filo.git

Features

  • Supported boot devices: IDE hard disk, SATA hard disk, CD-ROM, USB Mass Storage, and system memory (ROM)
  • Supported filesystems: ext2, fat, jfs, minix, reiserfs, xfs, and iso9660
  • Supported image formats: ELF and [b]zImage (a.k.a. /vmlinuz)
  • Supports boot disk image of El Torito bootable CD-ROM. "hdc1" means the boot disk image of the CD-ROM at hdc.
  • Supports loading image from raw device with user-specified offset
  • Console on VGA + keyboard, serial port, or both
  • Line editing with ^H, ^W and ^U keys to type arbitrary filename to boot
  • Full support for the ELF Boot Proposal (where is it btw, Eric)
  • Auxiliary tool to compute checksum of ELF boot images
  • Full 32-bit code, no BIOS calls
  • uses libpayload

Requirements

Only the x86 (x64) architecture is currently supported. Some efforts have been made to get FILO running on PPC. Contact the coreboot mailinglist for more information.

Recent version of GNU toolchain is required to build.

We have tested with Debian/woody (gcc 2.95.4, binutils 2.12.90.0.1, make 3.79.1), Debian/sid (gcc 3.3.2, binutils 2.14.90.0.6, make 3.80) and different versions of SUSE Linux from 9.0 to 11.0.

FILO will use the coreboot crossgcc if you have it built and it can be found.

FILO uses coreboot's libpayload. It is easiest to locate and build FILO in the coreboot/payloads directory.

Building on 64-bit OS specifics

If you will be building FILO on AMD64 platform for Debian install the gcc-multilib package.

x64/AMD64 machines work fine when compiling FILO in 32-bit mode. (coreboot uses 32-bit mode and Linux kernel does the transition to 64-bit mode)

Preparation

Before you can build FILO, you have to build libpayload. If your filo directory is located inside the coreboot/payloads directory, you don't have to do anything special. If for some reason you want to compile FILO of the coreboot/payloads directory, you will need to tell the makefile where libpayload is. Open filo/Makefile in your favorite text editor and change this line

 export LIBCONFIG_PATH := $(src)/../libpayload

to match the location of the libpayload directory on your system:

 export LIBCONFIG_PATH := /home/YOUR_USER_NAME/PATH_TO_COREBOOT/payloads/libpayload 

Configuration

Configure FILO (and libpayload) using the Kconfig interface:

 $ make menuconfig

This will run menuconfig twice -- the first time for libpayload, the second time for FILO.

Building

Then running make will build filo.elf, the ELF boot image of FILO.

 $ make

If you are compiling on an AMD64 platform and compiler complains, instead of "make" you need to write

 $ make CC="gcc -m32" LD="ld -b elf32-i386" HOSTCC="gcc" AS="as --32"

Use build/filo.elf as your payload of coreboot, or a boot image for Etherboot.

Alternatively, you can build libpayload and FILO in one go using the build.sh script, with the drawback that you'll get the default options for both of them:

 $ ./build.sh

Here is the short listing how to build FILO from git

cd coreboot/payloads
git clone http://review.coreboot.org/p/filo.git
cd filo
make config
make

Credits

  • This software was originally developed by SONE Takeshi <ts1@tsn.or.jp>
  • It has been significantly enhanced and is now maintained by Stefan Reinauer.
  • It uses libpayload from Uwe Hermann and Jordan Crouse

Troubleshooting

If you experience trouble compiling or using FILO, please report with a build log or detailed error description to the coreboot mailing list.

Notes

CD-ROM Booting

To boot a CD-ROM or DVD you only need to specify the drive without a partition number. For example to boot to the primary drive on the secondary IDE channel you would use hdc and not hdc1 in FILO.

Grub-like Interface

If you are using FILO with CONFIG_USE_GRUB, and want to boot to your Linux install disk you have to do a mixture of GRUB and FILO commands.

Like GRUB you have to append a kernel (and parameters), then an initrd, and give a boot command. Like FILO you have to give absolute paths.

Example to boot to a GeeXboX install CD-ROM:

filo> kernel hdc:/GEEXBOX/boot/vmlinuz root=/dev/ram0 rw init=linuxrc boot=cdrom installator

Press <ENTER>

filo> initrd hdc:/GEEXBOX/boot/initrd.gz

Press <ENTER>

filo> boot

Press <ENTER>

Your system will now boot right into the Linux install.

NVRAM Parsing

FILO parses the following NVRAM variables:

  • 'boot_devices' can contain a list of boot devices seperated by semicolons. FILO will try to load filo.lst / menu.lst from any of these devices.

Example how to set:

nvramtool -w "boot_devices=hda1:/boot/filo;hdc:"

Contributing

To be able to contribute you will need a Gerrit account. See Git on how to get one and how to push new code to the repository. The instructions there are valid also for FILO, just change coreboot to filo in directory names etc. (not hostnames).