This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
[COMMITTED PATCH] docs for info auxv
- From: Roland McGrath <roland at redhat dot com>
- To: gdb-patches at sources dot redhat dot com
- Date: Wed, 4 Feb 2004 15:25:49 -0800
- Subject: [COMMITTED PATCH] docs for info auxv
Daniel asked me to commit this when I committed the code, but I forgot til now.
I've just committed the following.
Thanks,
Roland
2004-02-04 Roland McGrath <roland@redhat.com>
* gdb.texinfo (Auxiliary Vector): New node (section).
(Data): Add it to the menu.
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.191
diff -u -b -p -r1.191 gdb.texinfo
--- gdb.texinfo 2 Feb 2004 21:07:53 -0000 1.191
+++ gdb.texinfo 4 Feb 2004 23:23:13 -0000
@@ -4716,6 +4716,7 @@ Table}.
* Registers:: Registers
* Floating Point Hardware:: Floating point hardware
* Vector Unit:: Vector Unit
+* Auxiliary Vector:: Auxiliary data provided by operating system
* Memory Region Attributes:: Memory region attributes
* Dump/Restore Files:: Copy between memory and a file
* Character Sets:: Debugging programs that use a different
@@ -5896,6 +5897,32 @@ Display information about the vector uni
layout vary depending on the hardware.
@end table
+@node Auxiliary Vector
+@section Operating system auxiliary vector
+@cindex auxiliary vector
+@cindex vector, auxiliary
+
+Some operating systems supply an @dfn{auxiliary vector} to programs at
+startup. This is akin to the arguments and environment that you
+specify for a program, but contains a system-dependent variety of
+binary values that tell system libraries important details about the
+hardware, operating system, and process. Each value's purpose is
+identified by an integer tag; the meanings are well-known but system-specific.
+Depending on the configuration and operating system facilities,
+@value{GDBN} may be able to show you this information.
+
+@table @code
+@kindex info auxv
+@item info auxv
+Display the auxiliary vector of the inferior, which can be either a
+live process or a core dump file. @{GDBN} prints each tag value
+numerically, and also shows names and text descriptions for recognized
+tags. Some values in the vector are numbers, some bit masks, and some
+pointers to strings or other data. @{GDBN} displays each value in the
+most appropriate form for a recognized tag, and in hexadecimal for
+an unrecognized tag.
+@end table
+
@node Memory Region Attributes
@section Memory region attributes
@cindex memory region attributes