[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    elf32_getehdr(3E) manual page Table of Contents

Name

elf32_getehdr, elf32_newehdr - retrieve class-dependent object file header

Synopsis

cc [ flag ... ] file ... -lelf [ library ... ]

#include <libelf.h>

Elf32_Ehdr *elf32_getehdr(Elf *elf);

Elf32_Ehdr *elf32_newehdr(Elf *elf);

MT-Level

Unsafe

Description

For a 32-bit class file, elf32_getehdr() returns a pointer to an ELF header, if one is available for the ELF descriptor elf. If no header exists for the descriptor, elf32_newehdr() allocates a ‘‘clean’’ one, but it otherwise behaves the same as elf32_getehdr(). It does not allocate a new header if one exists already. If no header exists (for elf32_getehdr()), one cannot be created (for elf32_newehdr()), a system error occurs, the file is not a 32-bit class file, or elf is null, both functions return a null pointer.

The header includes the following members. 


    unsigned char    e_ident[EI_NIDENT];
    Elf32_Half    e_type;
    Elf32_Half    e_machine;
    Elf32_Word    e_version;
    Elf32_Addr    e_entry;
    Elf32_Off    e_phoff;
    Elf32_Off    e_shoff;
    Elf32_Word    e_flags;
    Elf32_Half    e_ehsize;
    Elf32_Half    e_phentsize;
    Elf32_Half    e_phnum;
    Elf32_Half    e_shentsize;
    Elf32_Half    e_shnum;
    Elf32_Half    e_shstrndx;

elf32_newehdr() automatically sets the ELF_F_DIRTY bit (see elf_flagdata(3E) ). A program may use elf_getident() to inspect the identification bytes from a file.

See Also

elf(3E) , elf_begin(3E) , elf_flagdata(3E) , elf_getident(3E)

Table of Contents