gelf_getphdr - Man Page

Retrieve class-independent program header table entries for an ELF object file

Synopsis

#include <gelf.h>

GElf_Phdr *gelf_getphdr (Elf *elf, int ndx, GElf_Phdr *dst);

Description

Retrieve the class-independent program header table entry at index ndx for ELF descriptor elf and store it in dst. See elf_getphdrnum(3) for information on how to acquire the number of entries in the program header table.

Parameters

elf

ELF descriptor of kind ELF_K_ELF from which to retrieve the program header table entry.

ndx

The index of the program header table entry to be retrieved.

dst

Pointer to a caller-provided GElf_Phdr that will receive the requested program header table entry.

Return Value

On success, the requested entry is copied into dst and dst is returned. On failure, NULL is returned and elf_errno is set.  If elf is NULL, then NULL is returned and elf_errno is not set.

See Also

elf32_getphdr(3), elf64_getphdr(3), elf_getphdrnum(3), gelf_newphdr(3), gelf_update_phdr(3), libelf(3), elf(5)

Attributes

InterfaceAttributeValue
gelf_getphdr()Thread safetyMT-Safe

Reporting Bugs

Report bugs to <elfutils-devel@sourceware.org> or https://sourceware.org/bugzilla/.

Referenced By

gelf_newphdr(3), gelf_update_phdr(3).

2025-12-23 Libelf Programmer's Manual