GELF_GETSYM(3)            Libelf Programmer's Manual            GELF_GETSYM(3)



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

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Attribute     | Value   |
       +--------------------------------------------+---------------+---------+
       |gelf_getsym ()                              | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+

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

Libelf                            2025-12-29                    GELF_GETSYM(3)