Visit The New, Modern Unix Linux Community

Linux and UNIX Man Pages

Test Your Knowledge in Computers #408
Difficulty: Medium
The Cygwin distribution contains thousands of packages from the Open Source world including most GNU tools, many BSD tools, an X server and a full set of X applications.
True or False?
Linux & Unix Commands - Search Man Pages

gelf_getsym(3) [freebsd man page]

GELF_GETSYM(3)						   BSD Library Functions Manual 					    GELF_GETSYM(3)

NAME
gelf_getsym, gelf_update_sym -- read and update symbol information LIBRARY
ELF Access Library (libelf, -lelf) SYNOPSIS
#include <gelf.h> GElf_Sym * gelf_getsym(Elf_Data *data, int ndx, GElf_Sym *sym); int gelf_update_sym(Elf_Data *data, int ndx, GElf_Sym *sym); DESCRIPTION
These convenience functions are used to retrieve and update class-dependent Elf32_Sym and Elf64_Sym structures in an ELF object. Argument data is an Elf_Data descriptor associated with a section of type SHT_SYMTAB, SHT_DYNSYM or SHT_GNU_versym. Argument ndx is the index of the symbol being retrieved or updated. The class-independent GElf_Sym structure is described in gelf(3). Function gelf_getsym() retrieves class-dependent symbol information at index ndx in data buffer data and copies it to the destination pointed to by argument sym after translation to class-independent form. Function gelf_update_sym() converts the class-independent symbol information pointed to by argument sym to class-dependent form, and writes it to the symbol entry at index ndx in the data buffer described by argument data. Function gelf_update_sym() signals an error if any of the values in the class-independent representation exceeds the representable limits of the target type. RETURN VALUES
Function gelf_getsym() returns the value of argument sym if successful, or NULL in case of an error. Function gelf_update_sym() returns a non-zero value if successful, or zero in case of an error. ERRORS
These functions may fail with the following errors: [ELF_E_ARGUMENT] Arguments data or sym were NULL. [ELF_E_ARGUMENT] Argument ndx was less than zero or larger than the number of symbols in the data descriptor. [ELF_E_ARGUMENT] Data descriptor data was not associated with a section containing symbol information. [ELF_E_RANGE] A value was not representable in the target type. SEE ALSO
elf(3), elf_getdata(3), elf_getscn(3), gelf(3), gelf_getsyminfo(3), gelf_update_syminfo(3) BSD
August 29, 2006 BSD

Check Out this Related Man Page

GELF_GETSYMSHNDX(3)					   BSD Library Functions Manual 				       GELF_GETSYMSHNDX(3)

NAME
gelf_getsymshndx, gelf_update_symshndx -- read and update symbol information using extended section indices LIBRARY
ELF Access Library (libelf, -lelf) SYNOPSIS
#include <gelf.h> GElf_Sym * gelf_getsymshndx(Elf_Data *symdata, Elf_Data *xndxdata, int ndx, GElf_Sym *sym, Elf32_Word *xndxptr); int gelf_update_symshndx(Elf_Data *symdata, Elf_Data *xndxdata, int ndx, GElf_Sym *sym, Elf32_Word xndx); DESCRIPTION
These functions are analogous to gelf_getsym() and gelf_update_sym() respectively, but are capable of handling symbol tables using extended section numbering. Argument symdata is an Elf_Data descriptor associated with a section of type SHT_SYMTAB. Argument xndxdata is an Elf_Data descriptor associ- ated with a section of type SHT_SYMTAB_SHNDX. Argument ndx is the index of the symbol table entry being retrieved or updated. Argument sym is a pointer to a class-independent GElf_Sym structure. GElf_Sym structures are described in detail in gelf(3). Function gelf_getsymshndx() retrieves symbol information at index ndx from the data descriptor specified by argument symdata and stores in class-independent form in argument sym. In addition it retrieves the extended section index for the symbol from data buffer xndxdata and stores it into the location pointed to by argument xndxptr. Function gelf_update_symshndx() updates the underlying symbol table entry in data descriptor symdata with the information in argument sym. In addition it sets the extended section index in data buffer xndxdata to the value of argument xndx. RETURN VALUES
Function gelf_getsymshndx() returns the value of argument sym if successful, or NULL in case of an error. Function gelf_update_symshndx() returns a non-zero value if successful, or zero in case of an error. ERRORS
These functions may fail with the following errors: [ELF_E_ARGUMENT] Arguments symdata, xndxdata, xndxptr or sym were NULL. [ELF_E_ARGUMENT] Argument ndx was less than zero, or too large for either of descriptors symdata or xndxdata. [ELF_E_ARGUMENT] Data descriptor symdata was not associated with a section of type SHT_SYMTAB. [ELF_E_ARGUMENT] Data descriptor xndxdata was not associated with a section of type SHT_SYMTAB_SHNDX. [ELF_E_ARGUMENT] Data descriptor symdata and xndxdata were associated with different ELF objects. SEE ALSO
elf(3), elf_getdata(3), elf_getscn(3), gelf(3), gelf_getsym(3), gelf_update_sym(3) BSD
November 5, 2006 BSD

Featured Tech Videos