freebsd man page for elf_getphdrnum

ELF_GETPHDRNUM(3)					   BSD 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.

SEE ALSO
     elf(3), elf32_getehdr(3), elf64_getehdr(3), elf_getident(3), elf_getshdrnum(3), elf_getshdrstrndx(3), gelf(3), gelf_getehdr(3)

BSD
								  August 5, 2009							       BSD