Description

For a 32-bit class file, elf32_getphdr() returns a pointer to the program execution header table, if one is available for the ELF descriptor elf.

elf32_newphdr() allocates a new table with count entries, regardless of whether one existed previously, and sets the ELF_F_DIRTY bit for the table. See elf_flagdata(3ELF). Specifying a zero count deletes an existing table. Note this behavior differs from that of elf32_newehdr() allowing a program to replace or delete the program
header table, changing its size if necessary. See elf32_getehdr(3ELF).

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, elf32_newphdr() returns a null pointer if count is
0.

The table is an array of Elf32_Phdr structures, each of which includes the following members:

The ELF header's e_phnum member tells how many entries the program header table has. See elf32_getehdr(3ELF).
A program may inspect this value to determine the size of an existing table; elf32_newphdr() 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.