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,
       respectively

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 necessary.

       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 following 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
       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.

       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 following 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 ALSO

       elf(3E), elf_begin(3E), elf_flag(3E), elf_getehdr(3E).

																   elf_getphdr(3E)