gelf_getsymshndx(3) [freebsd 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

Check Out this Related Man Page

GELF_GETSYMINFO(3)					   BSD Library Functions Manual 					GELF_GETSYMINFO(3)

NAME

     gelf_getsyminfo, gelf_update_syminfo -- read and update symbol information

LIBRARY

     ELF Access Library (libelf, -lelf)

SYNOPSIS

     #include <gelf.h>

     GElf_Syminfo *
     gelf_getsyminfo(Elf_Data *data, int ndx, GElf_Syminfo *syminfo);

     int
     gelf_update_syminfo(Elf_Data *data, int ndx, GElf_Syminfo *syminfo);

DESCRIPTION

     These convenience functions are used to retrieve and update class-dependent Elf32_Syminfo and Elf64_Syminfo records in an ELF object.

     Argument data is an Elf_Data descriptor associated with a section of type SHT_SUNW_syminfo.  Argument ndx is the index of the record being
     retrieved or updated.  The class-independent GElf_Syminfo structure is described in gelf(3).

     Function gelf_getsyminfo() retrieves class-dependent record at index ndx in data buffer data and copies it to the destination pointed to by
     argument syminfo after translation to class-independent form.

     Function gelf_update_syminfo() converts the class-independent record pointed to by argument syminfo to class-dependent form, and writes it to
     the record at index ndx in the data buffer described by argument data.

RETURN VALUES

     Function gelf_getsyminfo() returns the value of argument syminfo if successful, or NULL in case of an error.  Function gelf_update_syminfo()
     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 syminfo 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.

SEE ALSO

     elf(3), elf_getdata(3), elf_getscn(3), gelf(3), gelf_getsym(3), gelf_update_sym(3)

BSD
								  August 29, 2006							       BSD

Linux and UNIX Man Pages

gelf_getsymshndx(3) [freebsd man page]

Check Out this Related Man Page