lkml.org 
[lkml]   [2007]   [Jul]   [30]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    Subject[PATCH 5/5] x86_64 EFI support -v3: EFI document
    From
    Date
    This patch adds document for EFI x86_64 support. The boot parameters
    added are documented in Documentation/i386/zero-page.txt. The setup
    and operation guide of EFI based system is documented in
    Documentation/x86_64/uefi.txt.

    Signed-off-by: Chandramouli Narayanan <mouli@linux.intel.com>
    Signed-off-by: Huang Ying <ying.huang@intel.com>

    ---

    i386/zero-page.txt | 18 ++++++++++++++----
    x86_64/uefi.txt | 42 ++++++++++++++++++++++++++++++++++++++++++
    2 files changed, 56 insertions(+), 4 deletions(-)

    Index: linux-2.6.23-rc1/Documentation/i386/zero-page.txt
    ===================================================================
    --- linux-2.6.23-rc1.orig/Documentation/i386/zero-page.txt 2007-07-30 11:28:45.000000000 +0800
    +++ linux-2.6.23-rc1/Documentation/i386/zero-page.txt 2007-07-30 11:29:28.000000000 +0800
    @@ -31,11 +31,11 @@
    0xb0 - 0x13f Free. Add more parameters here if you really need them.
    0x140- 0x1be EDID_INFO Video mode setup

    -0x1c4 unsigned long EFI system table pointer
    -0x1c8 unsigned long EFI memory descriptor size
    -0x1cc unsigned long EFI memory descriptor version
    +0x1c4 unsigned long EFI system table pointer*
    +0x1c8 unsigned long EFI memory descriptor size*
    +0x1cc unsigned long EFI memory descriptor version*
    0x1d0 unsigned long EFI memory descriptor map pointer
    -0x1d4 unsigned long EFI memory descriptor map size
    +0x1d4 unsigned long EFI memory descriptor map size*
    0x1e0 unsigned long ALT_MEM_K, alternative mem check, in Kb
    0x1e4 unsigned long Scratch field for the kernel setup code
    0x1e8 char number of entries in E820MAP (below)
    @@ -87,3 +87,13 @@
    0x2d0 - 0xd00 E820MAP
    0xd00 - 0xeff EDDBUF (edd.S) for disk signature read sector
    0xd00 - 0xeeb EDDBUF (edd.S) for edd data
    +
    +Changes for x86_64 implementation:
    +---------------------------------
    +For alignment purposes, the following parameters are rearranged.
    +
    +0x1b8 unsigned long EFI system table pointer
    +0x1c0 unsigned long EFI Loader signature
    +0x1c4 unsigned long EFI memory descriptor size
    +0x1c8 unsigned long EFI memory descriptor version
    +0x1cc unsigned long EFI memory descriptor map size
    Index: linux-2.6.23-rc1/Documentation/x86_64/uefi.txt
    ===================================================================
    --- /dev/null 1970-01-01 00:00:00.000000000 +0000
    +++ linux-2.6.23-rc1/Documentation/x86_64/uefi.txt 2007-07-30 11:29:28.000000000 +0800
    @@ -0,0 +1,42 @@
    +General note on [U]EFI x86_64 support
    +-------------------------------------
    +
    +This provides documentation on [U]EFI support for x86_64 architecture.
    +The nomenclature EFI and UEFI are used intechangeably in this document.
    +
    +Although the tools below are _not_ needed for building the kernel,
    +the needed bootloader support and associated tools for x86_64 platforms
    +with EFI firmware and specifications are listed below.
    +
    +1. UEFI specification: http://www.uefi.org
    +
    +2. Booting EFI64 enabled kernel requires boot loader support.
    +Patches to elilo and gnu-efi library with x86_64 support and documentation
    +have been submitted to respective project maintainers.
    + elilo: http://sourceforge.net/projects/elilo
    + gnu-efi library: http://sourceforge.net/projects/gnu-efi/
    + gnu-efi-3.0d release now supports [U]EFI x86_64.
    +
    +3. The tool to convert ELF to PE-COFF image:
    + binutils-2.17.50.0.14 supports Intel64 EFI.
    + see http://www.kernel.org/pub/linux/devel/binutils/
    + [ elilo/gnu-efi with x86_64 support need this binutils support ]
    +
    +4. x86_64 platform with EFI/UEFI firmware.
    +
    +Mechanics:
    +---------
    +- Apply the EFI64 kernel patches and build with the following configuration.
    + CONFIG_EFI=y
    + EFI_FB=y
    + CONFIG_FRAMEBUFFER_CONSOLE=y
    + CONFIG_EFI_VARS=y
    +
    +- Create a VFAT partition on the disk
    +- Copy the following to the VFAT partition:
    + elilo bootloader with x86_64 support and elilo configuration file
    + efi64 kernel image and initrd. Instructions on building elilo
    + and its dependencies can be found in the elilo sourceforge project.
    +- Boot to EFI shell and invoke elilo choosing efi64 kernel image
    +- On UEFI2.0 firmware systems, pass vga=normal for boot messages to show up
    + console. You can pass along the 'resume' boot option to test suspend/resume.
    -
    To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
    the body of a message to majordomo@vger.kernel.org
    More majordomo info at http://vger.kernel.org/majordomo-info.html
    Please read the FAQ at http://www.tux.org/lkml/
    \
     
     \ /
      Last update: 2007-07-31 05:17    [W:0.033 / U:1.228 seconds]
    ©2003-2016 Jasper Spaans. hosted at Digital OceanAdvertise on this site