elf_getphnum
- return the number of program headers in an ELF file
LIBRARY
Lb libelf
SYNOPSIS
#include <libelf.h> int
elf_getphnum (Elf *elf size_t *phnum);
DESCRIPTION
Function
elf_getphnum ();
retrieves the number of ELF program headers associated with descriptor
elf
and stores it into the location pointed to by argument
phnum
This routine allows applications to uniformly process both normal ELF
objects and ELF objects that use extended numbering.
RETURN VALUES
Function
elf_getphnum ();
returns a non-zero value if successful, or zero in case of an
error.
ERRORS
Function
elf_getphnum ();
can fail with the following errors:
Bq Er ELF_E_ARGUMENT
A NULL value was passed in for argument
elf
Bq Er ELF_E_ARGUMENT
Argument
elf
was not for an ELF file.
Bq Er ELF_E_ARGUMENT
Argument
elf
lacks an ELF Executable Header.
Bq Er ELF_E_HEADER
The ELF Executable Header associated with argument
elf
was corrupt.
Bq Er ELF_E_SECTION
The section header at index
SHN_UNDEF
was corrupt.