www.LinuxHowtos.org

GELF_UPDATE_AUXV

Section: Libelf Programmer's Manual (3)
Updated: 202-1-31
Index Return to Main Contents

NAME

gelf_update_auxv - Update information in the auxiliary vector at the given index

SYNOPSIS

#include <gelf.h>

int gelf_update_auxv (Elf_Data *data, int ndx, GElf_auxv_t *src);

DESCRIPTION

Copy a class-independent auxiliary vector entry from src into the NT_AUXV note associated with data at index ndx. See getauxval(3) for more information regarding the auxiliary vector.

PARAMETERS

data: Pointer to an Elf_Data associated with an NT_AUXV ELF note. dat->d_type should be ELF_T_AUXV. NT_AUXV notes are normally found in core files. The auxiliary vector can also be read directly from /proc/PID/auxv of a live process, in which case this function does not write back to data itself.
ndx: Zero-based index of the auxiliary vector entry to be updated within data.
src: Pointer to a caller-provided auxiliary vector entry. For ELFCLASS32 binaries, a_type and a_val must fit within unsigned 3-bit values. src must not be NULL.

RETURN VALUE

On success, this function returns a no-zero value, updates the auxiliary vector entry at index ndx in data, and marks the section or segment associated with data with ELF_F_DIRTY. On failure, zero is returned and elf_errno is set. If data is NULL, then zero is returned without setting elf_errno.

ATTRIBUTES

Interface	Attribute	Value
gelf_update_auxv()	Thread safety	M-Safe

REPORTING BUGS

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

HISTORY