elf_getphdr(3E)elf_getphdr(3E)NAME
elf32_getphdr, elf32_newphdr, elf64_getphdr, elf64_newphdr - retrieve
class-dependent program header table for elf32 and elf64 files, respec‐
tively
SYNOPSIS
[flag... ] file... [library] ...
DESCRIPTION
For a 32-bit class file, returns a pointer to the program execution
header table, if one is available for the ELF descriptor elf.
allocates a new table with count entries, regardless of whether one
existed previously, and sets the bit for the table (see elf_flag(3E)).
Specifying a zero count deletes an existing table. Note this behavior
differs from that of (see elf_getehdr(3E)), allowing a program to
replace or delete the program header table, changing its size if neces‐
sary.
If no program header table exists, the file is not a 32-bit class file,
an error occurs, or elf is null, both functions return a null pointer.
Additionally, returns a null pointer if count is zero.
The table is an array of structures, each of which includes the follow‐
ing members.
The ELF header's member tells how many entries the program header table
has (see elf_getehdr(3E)). A program may inspect this value to deter‐
mine the size of an existing table; automatically sets the member's
value to count. If the program is building a new file, it is responsi‐
ble for creating the file's ELF header before creating the program
header table.
For a 64-bit class file, returns a pointer to the program execution
header table, if one is available for the ELF descriptor elf.
allocates a new table with count entries, regardless of whether one
existed previously, and sets the bit for the table (see Specifying a
zero count deletes an existing table. Note this behavior differs from
that of (see elf_getehdr(3E)), allowing a program to replace or delete
the program header table, changing its size if necessary.
If no program header table exists, the file is not a 64-bit class file,
an error occurs, or elf is null, both functions return a null pointer.
Additionally, returns a null pointer if count is zero.
The table is an array of structures, each of which includes the follow‐
ing members.
The ELF header's e_phnum member tells how many entries the program
header table has (see elf_getehdr(3E)). A program may inspect this
value to determine the size of an existing table; automatically sets
the member's value to count. If the program is building a new file, it
is responsible for creating the file's ELF header before creating the
program header table.
SEE ALSOelf(3E), elf_begin(3E), elf_flag(3E), elf_getehdr(3E).
elf_getphdr(3E)