elf_getphdrnum(3) on freebsd

Usage

#include <libelf.h>

int

elf_getphdrnum(Elf *elf, size_t *phnum);

Library

library “libelf”

Overview

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.

Releases

38 releases since FreeBSD 7.4-RELEASE; the text changed 14 times.

elf(3) API for manipulating ELF objects elf32_getehdr(3) retrieve the ELF header for a 32-bit ELF descriptor elf64_getehdr(3) retrieve the ELF header for a 64-bit ELF descriptor elf_getident(3) return the ELF identification bytes elf_getshdrnum(3) retrieve the number of section headers in an ELF file elf_getshdrstrndx(3) retrieve the section header string table index gelf(3) a library for accessing and manipulating ELF (Executable and Linkable Format) files gelf_getehdr(3) retrieve the header of an ELF binary as a class-independent structure

Referred to by

elf_getshnum(3) retrieve the number of section headers in an ELF file gelf_getphdr(3) Retrieve class-independent program header table entries for an ELF object file elf32_getphdr(3) retrieve the program header table for a 32-bit or 64-bit ELF object file elf64_getphdr(3) retrieve the program header table for a 32-bit or 64-bit ELF object file elf_getshdrnum(3) retrieve the number of section headers in an ELF file elf_getshstrndx(3) retrieve the section header string table index gelf_update_phdr(3) copy a class-independent program header table entry into an ELF descriptor elf_getshdrstrndx(3) retrieve the section header string table index elf_getphnum(3) return the number of program headers in an ELF file elf_setshstrndx(3) retrieve/update the index of the section name string table