ELF_GETPHDRNUM(3) |
FreeBSD Library Functions Manual |
ELF_GETPHDRNUM(3) |
NAME
elf_getphdrnum —
return the number of program headers in an ELF file
LIBRARY
ELF Access Library (libelf, -lelf)
SYNOPSIS
#include < libelf.h>
int
elf_getphdrnum( Elf *elf, size_t *phnum);
DESCRIPTION
Function
elf_getphdrnum() 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_getphdrnum() returns a zero value if successful, or -1 in case of an error.
ERRORS
Function
elf_getphnum() can fail with the following errors:
-
[
ELF_E_ARGUMENT]
-
A NULL value was passed in for argument
elf.
-
[
ELF_E_ARGUMENT]
-
Argument
elf was not for an ELF file.
-
[
ELF_E_ARGUMENT]
-
Argument
elf lacks an ELF Executable Header.
-
[
ELF_E_HEADER]
-
The ELF Executable Header associated with argument
elf was corrupt.
-
[
ELF_E_SECTION]
-
The section header at index
SHN_UNDEF was corrupt.