about summary refs log tree commit diff
path: root/manual
diff options
context:
space:
mode:
authorBrooks Moses <bmoses@google.com>2013-12-11 16:58:12 -0800
committerBrooks Moses <bmoses@google.com>2013-12-18 10:52:37 -0800
commitb9ab448f980e296eac21ac65f53783967cc6037b (patch)
tree7e145e47823b6f960a5b4e47559122b265567d12 /manual
parentf889953b44da50bf8a7824c97d09dbe03fd11b83 (diff)
downloadglibc-b9ab448f980e296eac21ac65f53783967cc6037b.tar.gz
glibc-b9ab448f980e296eac21ac65f53783967cc6037b.tar.xz
glibc-b9ab448f980e296eac21ac65f53783967cc6037b.zip
Add error reporting (via errno) to getauxval().
[BZ 15846] As discussed in the recent thread on my $EXEC_ORIGIN patch
and in BZ 15846, getauxval() presently has no unambiguous way of
reporting an error condition.  It currently returns zero on error, but
this may also be a valid result for some auxv entries.  As there is no
clear invalid result for all current and future auxv entries, this patch
sets errno (following a suggestion in the BZ entry).

This version of the patch also adds documentation and tests for the
value-not-found conditions in getauxval().
Diffstat (limited to 'manual')
-rw-r--r--manual/startup.texi3
1 files changed, 2 insertions, 1 deletions
diff --git a/manual/startup.texi b/manual/startup.texi
index a2777141c2..edd1de47be 100644
--- a/manual/startup.texi
+++ b/manual/startup.texi
@@ -625,7 +625,8 @@ basis there may be information that is not available any other way.
 This function is used to inquire about the entries in the auxiliary
 vector.  The @var{type} argument should be one of the @samp{AT_} symbols
 defined in @file{elf.h}.  If a matching entry is found, the value is
-returned; if the entry is not found, zero is returned.
+returned; if the entry is not found, zero is returned and @code{errno} is
+set to @code{ENOENT}.
 @end deftypefun
 
 For some platforms, the key @code{AT_HWCAP} is the easiest way to inquire