elf.h File Reference

ELF image format. More...

#include <stdint.h>
#include <ipxe/image.h>
#include <elf.h>

Go to the source code of this file.

Macros
#define	ELFCLASS   ELFCLASS32

Typedefs
typedef Elf32_Ehdr	Elf_Ehdr
typedef Elf32_Phdr	Elf_Phdr
typedef Elf32_Off	Elf_Off

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
int	elf_segments (struct image *image, const Elf_Ehdr *ehdr, int(*process)(struct image *image, const Elf_Phdr *phdr, physaddr_t dest), physaddr_t *entry, physaddr_t *max)
	Process ELF segments. More...
int	elf_load (struct image *image, physaddr_t *entry, physaddr_t *max)
	Load ELF image into memory. More...

Detailed Description

ELF image format.

Definition in file elf.h.

Macro Definition Documentation

ELFCLASS

#define ELFCLASS   ELFCLASS32

Definition at line 20 of file elf.h.

Typedef Documentation

Elf_Ehdr

typedef Elf32_Ehdr Elf_Ehdr

Definition at line 17 of file elf.h.

Elf_Phdr

typedef Elf32_Phdr Elf_Phdr

Definition at line 18 of file elf.h.

Elf_Off

typedef Elf32_Off Elf_Off

Definition at line 19 of file elf.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

elf_segments()

int elf_segments	(	struct image *	image,
		const Elf_Ehdr *	ehdr,
		int(*)(struct image *image, const Elf_Phdr *phdr, physaddr_t dest)	process,
		physaddr_t *	entry,
		physaddr_t *	max
	)

Process ELF segments.

Parameters

image	ELF file
ehdr	ELF executable header
process	Segment processor

Return values

entry	Entry point, if found
max	Maximum used address
rc	Return status code

Definition at line 157 of file elf.c.

                                                        {
        const Elf_Phdr *phdr;
        Elf_Off phoff;
        unsigned int phnum;
        int rc;

        /* Initialise maximum used address */
        *max = 0;

        /* Invalidate entry point */
        *entry = 0;

        /* Read and process ELF program headers */
        for ( phoff = ehdr->e_phoff , phnum = ehdr->e_phnum ; phnum ;
              phoff += ehdr->e_phentsize, phnum-- ) {
                if ( ( image->len < phoff ) ||
                     ( ( image->len - phoff ) < sizeof ( *phdr ) ) ) {
                        DBGC ( image, "ELF %s program header %d outside "
                               "image\n", image->name, phnum );
                        return -ENOEXEC;
                }
                phdr = ( image->data + phoff );
                if ( ( rc = elf_segment ( image, ehdr, phdr, process,
                                          entry, max ) ) != 0 )
                        return rc;
        }

        /* Check for a valid execution address */
        if ( ! *entry ) {
                DBGC ( image, "ELF %s entry point %lx outside image\n",
                       image->name, ( ( unsigned long ) ehdr->e_entry ) );
                return -ENOEXEC;
        }

        return 0;
}

References image::data, DBGC, Elf32_Ehdr::e_entry, Elf32_Ehdr::e_phentsize, Elf32_Ehdr::e_phnum, Elf32_Ehdr::e_phoff, elf_segment(), ENOEXEC, image::len, max, image::name, and rc.

Referenced by elf_load(), and elfboot_probe().

elf_load()

int elf_load	(	struct image *	image,
		physaddr_t *	entry,
		physaddr_t *	max
	)

Load ELF image into memory.

Parameters

image

ELF file

Return values

entry	Entry point
max	Maximum used address
rc	Return status code

Definition at line 206 of file elf.c.

                                                                         {
        static const uint8_t e_ident[] = {
                [EI_MAG0]       = ELFMAG0,
                [EI_MAG1]       = ELFMAG1,
                [EI_MAG2]       = ELFMAG2,
                [EI_MAG3]       = ELFMAG3,
                [EI_CLASS]      = ELFCLASS,
        };
        const Elf_Ehdr *ehdr;
        int rc;

        /* Read ELF header */
        if ( image->len < sizeof ( *ehdr ) ) {
                DBGC ( image, "ELF %s too short for ELF header\n",
                       image->name );
                return -ENOEXEC;
        }
        ehdr = image->data;
        if ( memcmp ( ehdr->e_ident, e_ident, sizeof ( e_ident ) ) != 0 ) {
                DBGC ( image, "ELF %s has invalid signature\n", image->name );
                return -ENOEXEC;
        }

        /* Load ELF segments into memory */
        if ( ( rc = elf_segments ( image, ehdr, elf_load_segment,
                                   entry, max ) ) != 0 )
                return rc;

        return 0;
}

References image::data, DBGC, Elf32_Ehdr::e_ident, EI_CLASS, EI_MAG0, EI_MAG1, EI_MAG2, EI_MAG3, elf_load_segment(), elf_segments(), ELFCLASS, ELFMAG0, ELFMAG1, ELFMAG2, ELFMAG3, ENOEXEC, image::len, max, memcmp(), image::name, and rc.

Referenced by elfboot_exec(), and multiboot_load_elf().