Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 as-
     sociated with descriptor elf and stores it	into the location pointed to
     by	argument phnum.

     This routine allows applications to uniformly process both	normal ELF ob-
     jects 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)

BSD				 July 25, 2018				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=elf_getphdrnum&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help