Reference

gelf_getversym(3)

retrieve GNU symbol versioning entries

NAME

gelf_getversym, gelf_getverdef, gelf_getverdaux, gelf_getverneed, gelf_getvernaux - retrieve GNU symbol versioning entries

SYNOPSIS

#include <gelf.h>
GElf_Versym  *gelf_getversym (Elf_Data *data, int ndx, GElf_Versym  *dst);
GElf_Verdef  *gelf_getverdef (Elf_Data *data, int offset, GElf_Verdef  *dst);
GElf_Verdaux *gelf_getverdaux(Elf_Data *data, int offset, GElf_Verdaux *dst);
GElf_Verneed *gelf_getverneed(Elf_Data *data, int offset, GElf_Verneed *dst);
GElf_Vernaux *gelf_getvernaux(Elf_Data *data, int offset, GElf_Vernaux *dst);

DESCRIPTION

These functions provide class-independent access to GNU ELF symbol version information. The requested entry is retrieved from data and stored in the caller-supplied dst.

gelf_getversym()

Retrieves the symbol version index at index ndx from the SHT_GNU_versym section associated with data.

gelf_getverdef()

Retrieves the version definition entry at section offset offset from the SHT_GNU_verdef section associated with data.

gelf_getverdaux()

Retrieves the version definition auxiliary entry at section offset offset from the SHT_GNU_verdef section associated with data.

gelf_getverneed()

Retrieves the version needed entry at section offset offset from the SHT_GNU_verneed section associated with data.

gelf_getvernaux()

Retrieves the version needed auxiliary entry at section offset offset from the SHT_GNU_verneed section associated with data.

PARAMETERS

data

Pointer to an Elf_Data corresponding to the appropriate GNU versioning section.

ndx

(For gelf_getversym() only.) Zero-based index of the entry within data.

offset

(For gelf_getverdef(), gelf_getverdaux(), gelf_getverneed(), and gelf_getvernaux().) Section-relative byte offset of the entry within data.

dst

Pointer to a caller-provided entry of the appropriate type: GElf_Versym, GElf_Verdef, GElf_Verdaux, GElf_Verneed, or GElf_Vernaux. This argument must not be NULL.

RETURN VALUE

On success, these functions store the requested entry in dst and return dst. On failure, these functions return NULL and set elf_errno. If data is NULL, then NULL is returned without setting elf_errno.

SEE ALSO

gelf_update_verdaux(3), gelf_update_verdef(3), gelf_update_vernaux(3), gelf_update_verneed(3), gelf_update_versym(3), libelf(3), elf(5)

ATTRIBUTES

InterfaceAttributeValue
gelf_getversym(),
gelf_getverdef(),
gelf_getverdaux(),
gelf_getverneed(),
gelf_getvernaux()
Thread safetyMT-Safe

REPORTING BUGS

Report bugs to <[email protected]> or https://sourceware.org/bugzilla/.