NAME¶

gelf_getsym - Retrieve class-independent symbol information from the symbol table at the given index

SYNOPSIS¶

#include <gelf.h>
GElf_Sym *gelf_getsym (Elf_Data *data, int ndx, GElf_Sym *dst);

DESCRIPTION¶

Translate the symbol table entry at index ndx from data into a class-independent representation stored in *dst.

data must be the Elf_Data of a section with type SHT_SYMTAB or SHT_DYNSYM.

The number of symbols in the symbol table can be calculated by dividing the size of the corresponding section (sh_size or d_size) by the size of a symbol table entry. The size of a symbol table entry can be obtained from sh_entsize or gelf_fsize(3).

If the corresponding elf contains more than 64K sections then gelf_getsymshndx should be used to retrieve a symbol's section index. See gelf_getsymshndx(3) for more information.

PARAMETERS¶

data

Pointer to an Elf_Data of a SHT_SYMTAB or SHT_DYNSYM section.

ndx

Zero-based index of the symbol table entry within data.

dst

Pointer to a caller-provided structure for storing the symbol table entry. dst must not be NULL.

RETURN VALUE¶

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

SEE ALSO¶

gelf_getdyn(3), gelf_getsymshndx(3), gelf_update_sym(3), libelf(3), elf(5)

ATTRIBUTES¶

REPORTING BUGS¶

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