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_GETSYMSHNDX (3)

NAME

gelf_getsymshndx, gelf_update_symshndx - read and update symbol information using extended section indices

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also

LIBRARY


.Lb libelf

SYNOPSIS


.In gelf.h GElf_Sym *
.Fo gelf_getsymshndx Elf_Data *symdata Elf_Data *xndxdata int ndx GElf_Sym *sym Elf32_Word *xndxptr
.Fc int
.Fo gelf_update_symshndx Elf_Data *symdata Elf_Data *xndxdata int ndx GElf_Sym *sym Elf32_Word xndx
.Fc

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
.Vt Elf_Data descriptor associated with a section of type SHT_SYMTAB. Argument xndxdata is an
.Vt Elf_Data descriptor associated 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
.Vt GElf_Sym structure.
.Vt 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)
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.