FreeBSD manual
download PDF document: elf_getphdrnum.3.pdf
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_getphdrnum() 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.
SEE ALSO
elf(3), elf32_getehdr(3), elf64_getehdr(3), elf_getident(3),
elf_getshdrnum(3), elf_getshdrstrndx(3), gelf(3), gelf_getehdr(3)
FreeBSD 14.0-RELEASE-p11 July 25, 2018 FreeBSD 14.0-RELEASE-p11