man pages section 3: Extended Library Functions, Volume 3

Pgetauxval (3PROC)

Name

Pgetauxval, Pgetauxvec - examine the aux vector of a victim process

Synopsis

#include <libproc.h>

long Pgetauxval(ps_prochandle_t *Pr, int type);

const auxv_t *Pgetauxvec(ps_prochandle_t *Pr);

Description

The Pr argument identifies a victim process or core file attached to the controlling process by the create and grab interfaces. For more information, see the Pcreate(3PROC) and Pgrab(3PROC) man pages.

The Pgetauxval() function returns the value of the aux vector entry in the victim process named by the type argument. The type argument must be one of the AT_* values defined in the <sys/auxv.h> header file.

The Pgetauxvec() function returns a pointer to the complete array of aux vector entries for the victim process, terminated by an all-zero aux vector entry.

Return Values

If successful, the Pgetauxval() function returns the value from the victim process corresponding to the aux vector entry named by the type argument. It returns -1 if no such aux vector entry is found.

The Pgetauxval() and Pgetauxvec() functions have no failure return.

The errno value is not set by these functions.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Unsafe

See Also

libproc.h(3HEAD), libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), proc(5)