elilo/docs/eliloalt.txt

78 lines
2.6 KiB
Plaintext

Information related to the eliloalt Linux tool
---------------------------------------------
(c) 2002-2003 Hewlett Packard Co
Contributed by Stephane Eranian <eranian@hpl.hp.com>
Last updated: March 1st, 2002
The elilo alternate image feature uses an EFI variable called EliloAlt.
The content of this variable is a UNICODE string containing a kernel
image file and its command line options. The variable has a NULL GUID.
To create, read, or modify the variable you need to use the EFI variable
service and the SetVariable() or GetVariable() interface. The service
is available when EFI is in boot service mode, i.e., prior to loading
the kernel but it is also available at runtime when the Linux kernel
has taken over the control of the machine.
In order to modify the variable, you can either write a small EFI applications
or use the Linux/ia64 interface to the EFI variables which use the /proc filesystem.
The elilalt tool included in this package uses the /proc interface to EFI variables
to create, read, or modify the EliloAlt variable. This tool is a Linux/ia64 application
and NOT an EFI application.
Because modiyfing the EliloAlt can influence how the machine is booted, you must
be root to run the program, even when you simply want to read the content of
the variable.
Eliloalt provides the following options:
-h, --help display this help and exit
--version output version information and exit
-s, --set cmdline set elilo alternate variable to cmdline
-p, --print print elilo alternate variable
-d, --delete print elilo alternate variable
1/ Creation of the variable
To create the variable you can type:
# eliloalt -s "vmlinuz-2.4.9 root=/dev/sdb2 hdc=ide-scsi"
It is VERY important to use quotes to make sure that the entire list of arguments is
treated as a single argument to the program. Otherwise only the first element
(here vmlinuz-2.4.9) will be used.
2/ Printing the content of the variable
To print the content of the variable you need to type:
# eliloalt -p
EliloAlt="vmlinuz-2.4.9 root=/dev/sdb2 hdc=ide-scsi"
3/ Modifying the variable
You can simply use the -s option:
# eliloalt -s "vmlinuz-2.4.18 root=/dev/sdb2"
# eliloalt -p
EliloAlt="vmlinuz-2.4.18 root=/dev/sdb2"
3/ Deleting the variable
You must use the -d option:
# eliloalt -p
EliloAlt="vmlinuz-2.4.18 root=/dev/sdb2"
# eliloalt -d
# eliloalt -p
variable not defined
Keep in mind that the variable is automatically deleted by elilo if:
- the checkalt option is specified in the config file
OR
- the -a is used on the command line