gelf_getsym3

Usage

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

Overview

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.

Attributes