elilo.txt

来自「EFI（Extensible Firmware Interface)是下一代BI」· 文本 代码 · 共 479 行 · 第 1/2 页

	--------------------------------------------------------------------
	ELILO.EFI: Linux boot loader for EFI/IA-64 and EFI/IA-32 based systems
	--------------------------------------------------------------------
	               Stephane Eranian <[e-mail]>

		                 August 2003

	           Copyright (C) 2000-2003 Hewlett-Packard Co.


I/ Introduction
   ------------

This document describes how to use ELILO on for both IA-64 and IA-32 EFI-based platforms.
This document describes ELILO version 3.4. 

II/ Command line options
    --------------------

	elilo [-hDpPVvaE] [-d nsec] [-C config] [-i initrd] [-c chooser] [kernel [kernel options...]]

	-h	Display a list of all possible command line options.

	-V	Print the version number and exit.

	-d nsec Specify the number of 10th of seconds before loading the
		kernel.

	-C file Specify the config file to use. The default is elilo.conf in the directory
		that elilo.efi was loaded from.

	-P	Verify config file syntax only. this option causes ELILO to 
		parse the config file and generate a report on the console.
		No kernel is loaded.

	-v	Turn on verbose mode. ELILO prints more message about what it 
		is doing. For each occurrence of this option the verbosity level
		is increased by one. The maximum level is 5.

	-a	Always check for alternate kernel image. The default behavior
		of ELILO is to NOT look for an alternate image. This 
		option overrides this behavior and ELILO is checking for 
		alternate images no matter what. Alternate images are
		specified using the EliloAlt EFI variable.

	-p      force interactive prompt mode. Valid when no kernel image is 
		specified on the command line.

	-D	print debug output.

	-E	don't force EDD30 variable to TRUE when FALSE.

	-i file Use file as the initial ramdisk (initrd).

	-c name	Specify which kernel chooser to use.  Default is 'simple', and
		the only other choice at present is 'textmenu'.

	In addition, elilo supports platform specific options:

	For IA-64:
	----------
		-r	the kernel image can be relocated if initial load address is not
			available. This options requires a special version of the kernel.

		-F file will try to load the FPSWA driver indicated by 'file'. Only this file
		        will be attempted. When no specific file is given, elilo will try
			loading \efi\intel firmware\fpswa.efi from all accessible EFI system
			partitions.
	For IA-32:
	----------
		no option defined.

	All file names (including the kernel file) can include a device name using the 
	following syntax:

		dev_name:/path/to/my/kernel

	The 'dev_name' component depends on the naming scheme selected and the detected
	devices for your system.  Some choosers may print the information automatically
	or on demand, see chooser specific documentation for more on this. See README.devschemes 
	for more information on device naming schemes. The slash character '/' can be used as 
	a directory separator on any file systems including the EFI file system (FAT32).


III/ Configuration File
     ------------------

     ELILO supports a config file with options similar to the LILO/x86 boot loader.

     Elilo will use the following sequence (shown in order) when looking for its config 
     file when none is specified on the command line:

	1/ AABBCCDD.conf (netbooting with regular DHCP)
	   where AABBCCDD is the hexadecimal representation
	   of the IP address assigned during the DHCP phase.

	2/ elilo-ia64.conf or elilo-ia32.conf
	   The choice depends on the client platform. This step allows
	   the same DHCP/PXE server to provide files for both types of clients.

	3/ elilo.conf

     Unless explicitly specified on the command line, elilo looks for its config file
     in the filesystem and directory it was loaded from. For instance, if elilo.efi
     is invoked as:

     fs0:\> \efi\debian\elilo.efi

     Then elilo will look for its configuration file in fs0:\efi\debian and not
     in the root directory of fs0:. The prefix fs0:\efi\debian will be used for
     all other files that elilo needs to download when their paths are specified 
     as being relative.

     IMPORTANT:
     This rule also applies when a specific config file is passed via the -C 
     option. For example:

     fs0:\> \efi\debian\elilo.efi -C elilo.conf

     This will look for elilo.conf in fs0:\efi\debian and not in fs0:\.
     To get to the elilo.conf in fs0:\, you need to specify the absolute
     path:

     fs0:\> \efi\debian\elilo.efi -C \elilo.conf


     The configuration file is an ASCII file and not a UNICODE file.

     The config file contains additional options to change the behavior of the loader. 
     If the same option is specified in the config file AND on the command line, the
     latter takes precedence. Not all options available in the config file have an 
     equivalent on command line.

     When elilo is invoked with the -h option, it prints the list of support command line
     options but also the list of config file options. For each option it also prints
     the type of data expected.

     The config file options are divided in 2 groups:


	- image options which are specific to a particular kernel image. Each kernel image
   	  must be identified with a logical name called a label. 

     	- global options which affect the behavior of ELILO and apply to all images.

     The ELILO config file follows the LILO/x86 syntax. First come the global
     options, then the list of images and options for each of them, if
     necessary. At least one image MUST be defined and it is possible to have
     an empty list of global options.

     Options have types. Three types are defined:
     	- boolean: set or not set
	- string : a string of characters which can be quoted if necessary
	- number (in decimal) 
	- filename: a string interpreted as a file name

    
    The config file supports the following options:

    Global Options:
    ---------------
    default=value	Name the default image to boot. If not defined ELILO
    		 	will boot the first defined image.

    timeout=number	The number of 10th of seconds to wait while in
    			interactive mode before auto booting default kernel.
			Default is infinity.

    delay=number	The number of 10th of seconds to wait before
    			auto booting when not in interactive mode. 
			Default is 0.
   
    prompt		Force interactive mode

    verbose=number	Set level of verbosity [0-5]. Default 0 (no verbose)

    root=filename	Set global root filesystem for Linux/ia64

    read-only		Force root filesystem to be mounted read-only

    append=string	Append a string of options to kernel command line

    initrd=filename	Name of initrd file

    image=filename	Define a new image

    chooser=name	Specify kernel chooser to use: 'simple' or 'textmenu'.

    message=filename	a message that is printed on the main screen if supported by 
    			the chooser.

    fX=filename		Some choosers may take advantage of this option to
    			display the content of a file when a certain function
			key X is pressed. X can vary from 1-12 to cover 
			function keys F1 to F12.

    noedd30		do not force the EDD30 EFI variable to TRUE when FALSE. In other
    			words, don't force the EDD30 mode if not set.

    Image options:
    --------------
    root=filename	Set root filesystem for kernel

    read-only		Force root filesystem to be mounted read-only

    append=string	Append a string of options to kernel command line

    initrd=filename	Name of initrd file

    label=string	Logical name of image (used in interactive mode)

    description=string	One line text description of the image.

    IA-64 specific options:
    -----------------------

    Global options:
    ---------------
    fpswa=file          Specify the filename for a specific FPSWA to load. 
			If this option is used then no other file will be tried.

    relocatable		In case of memory allocation error at initial load point of
    			kernel, allow attempt to relocate (assume kernels is relocatable)

    Image options:
    --------------
    relocatable		In case of memory allocation error at initial load point of
    			kernel, allow attempt to relocate (assume this kernel is relocatable)

    IA-32 specific options:
    -----------------------
    legacy-free		Indicate that the host machine does not have a legacy BIOS at all.


    The user can specify a kernel and related kernel options using the image label. Alternatively,
    the user can also specify a kernel file that is not specified in the config file. In any case,
    some of the global options (such as append) are always concatenated to whatever the user type.


IV/ Booting from the local system