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-inde-
     pendent 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 sym-
     bol 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_get-
     symshndx 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
     allbox; lbx lb lb l l l.  Interface Attribute Value T{ gelf_getsym()
     T}	  Thread safety	  MT-Safe


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

Libelf				   2025-12-29			  GELF_GETSYM(3)