GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GELF_UPDATE_SYM (3)

NAME

gelf_getsym, gelf_update_sym - read and update symbol information

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also

LIBRARY


.Lb libelf

SYNOPSIS


.In 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
.Vt Elf32_Sym and
.Vt Elf64_Sym structures in an ELF object.

Argument data is an
.Vt 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
.Vt 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)
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.