1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2015 Joyent, Inc.
  13 .\"
  14 .Dd May 11, 2016
  15 .Dt PGETAUXVAL 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Pgetauxval
  19 .Nd obtain auxiliary vector value
  20 .Sh LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft int
  25 .Fo Pgetauxval
  26 .Fa "struct ps_prochandle *P"
  27 .Fa "int type"
  28 .Fc
  29 .Sh DESCRIPTION
  30 The
  31 .Fn Pgetauxval
  32 function looks up the entry
  33 .Fa type
  34 in the auxiliary vector of the process handle
  35 .Fa P
  36 and returns its value.
  37 The
  38 .Fa type
  39 argument should be the entry of the auxiliary vector.
  40 The list of such types may be found in
  41 .In sys/auxv.h .
  42 .Sh RETURN VALUES
  43 Upon successful completion, the
  44 .Fn Pgetauxval
  45 function returns the value of the auxiliary vector entry
  46 .Fa type .
  47 Otherwise,
  48 .Sy -1
  49 is returned to indicate that either the auxiliary vector or the
  50 .Fa type
  51 entry could not be found.
  52 .Sh INTERFACE STABILITY
  53 .Sy Uncommitted
  54 .Sh MT-LEVEL
  55 See
  56 .Sy LOCKING
  57 in
  58 .Xr libproc 3LIB .
  59 .Sh SEE ALSO
  60 .Xr libproc 3LIB ,
  61 .Xr Pgetauxvec 3PROC ,
  62 .Xr proc 4