NAME¶

gelf_getauxv - Get class-independent information from auxiliary vector at the given index

SYNOPSIS¶

#include <gelf.h>
GElf_auxv_t *gelf_getauxv (Elf_Data *data, int ndx, GElf_auxv_t *dst);

DESCRIPTION¶

Retrieve an auxiliary vector entry from data at index ndx and store it in the class-independent representation pointed to by dst.

data must be an Elf_Data* associated with an ELF note of type NT_AUXV and must have its d_type set to ELF_T_AUXV. elf_getdata_rawchunk(3) can be used to acquire an Elf_Data* with a d_type of ELF_T_AUXV. NT_AUXV notes are normally found in core files. The auxiliary vector can be also be read directly from /proc/PID/auxv.

See getauxval(3) for more information regarding the auxiliary vector.

PARAMETERS¶

data

Pointer to an Elf_Data of a note with type NT_AUXV and must have its d_type set to ELF_T_AUXV. See elf_getdata_rawchunk(3) for more information.

ndx

Index of the requested auxiliary vector entry within data.

dst

Pointer to a caller-provided GElf_auxv_t structure for storing the requested auxiliary vector entry. Must not be NULL.

RETURN VALUE¶

On success, this function updates dst with the requested auxiliary vector entry and returns dst. On failure, it returns NULL and sets elf_errno. If data is NULL, then NULL is returned without setting elf_errno.

SEE ALSO¶

elf_getdata_rawchunk(3), getauxval(3) libelf(3), elf(5)

ATTRIBUTES¶

REPORTING BUGS¶

Report bugs to <elfutils-devel@sourceware.org> or https://sourceware.org/bugzilla/.

HISTORY¶

gelf_getauxv first appeared in elfutils 0.130. This function is an elfutils libelf extension and may not be available in other libelf implementations.