gelf_getrel - Man Page

retrieve relocation entries as class-independent structures

Synopsis

#include <gelf.h>

GElf_Rel  *gelf_getrel (Elf_Data *data, int ndx, GElf_Rel  *dst);
GElf_Rela *gelf_getrela(Elf_Data *data, int ndx, GElf_Rela *dst);

Description

The gelf_getrel() and gelf_getrela() functions translate the REL or RELA relocation entry at index ndx from data into a class-independent representation stored in *dst.

data must be the Elf_Data of a section whose type matches the function being called: SHT_REL for gelf_getrel() and SHT_RELA for gelf_getrela().

Parameters

data

Pointer to an Elf_Data for a SHT_REL or SHT_RELA relocation section.

ndx

Zero-based index of the relocation entry within data.

dst

Pointer to a caller-provided structure for storing the relocation: GElf_Rel for gelf_getrel() and GElf_Rela for gelf_getrela(). dst must not be NULL.

Return Value

On success, returns dst. On failure, returns NULL and sets elf_errno.  If data is NULL, then NULL is returned without setting elf_errno.

See Also

elf_getdata(3), gelf_update_rel(3), gelf_update_rela(3), libelf(3), elf(5)

Attributes

InterfaceAttributeValue
gelf_getrel(), gelf_getrela()Thread safetyMT-Safe

Reporting Bugs

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

Referenced By

gelf_update_rel(3).

2025-09-24 Libelf Programmer's Manual