diff options
| author | H.J. Lu <hjl@gnu.org> | 2001-07-23 21:20:35 +0000 |
|---|---|---|
| committer | H.J. Lu <hjl@gcc.gnu.org> | 2001-07-23 14:20:35 -0700 |
| commit | dd96fbc585ec1ccec16f92a63f0e0580eba2be47 (patch) | |
| tree | d41a81baa437c4e1c570daa22ef2507b41492629 | |
| parent | c50e5bc0abd1531bdc12772fe236b1053001a22a (diff) | |
| download | gcc-dd96fbc585ec1ccec16f92a63f0e0580eba2be47.zip gcc-dd96fbc585ec1ccec16f92a63f0e0580eba2be47.tar.gz gcc-dd96fbc585ec1ccec16f92a63f0e0580eba2be47.tar.bz2 | |
extend.texi: Update __builtin_return_address and __builtin_frame_address.
2001-07-23 H.J. Lu (hjl@gnu.org)
* doc/extend.texi: Update __builtin_return_address and
__builtin_frame_address.
From-SVN: r44281
| -rw-r--r-- | gcc/ChangeLog | 5 | ||||
| -rw-r--r-- | gcc/doc/extend.texi | 13 |
2 files changed, 15 insertions, 3 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index e2437a2..c7c0c76 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2001-07-23 H.J. Lu (hjl@gnu.org) + + * doc/extend.texi: Update __builtin_return_address and + __builtin_frame_address. + 2001-07-23 Richard Henderson <rth@redhat.com> * config/i386/i386.c (ix86_expand_setcc): Don't use method 0 diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index 74dd33e..787b722 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -3703,7 +3703,9 @@ The @var{level} argument must be a constant integer. On some machines it may be impossible to determine the return address of any function other than the current one; in such cases, or when the top -of the stack has been reached, this function will return @code{0}. +of the stack has been reached, this function will return @code{0} or a +random value. In addition, @code{__builtin_frame_address} may be used +to determine if the top of the stack has been reached. This function should only be used with a non-zero argument for debugging purposes. @@ -3725,8 +3727,13 @@ has a dedicated frame pointer register, and the function has a frame, then @code{__builtin_frame_address} will return the value of the frame pointer register. -The caveats that apply to @code{__builtin_return_address} apply to this -function as well. +On some machines it may be impossible to determine the frame address of +any function other than the current one; in such cases, or when the top +of the stack has been reached, this function will return @code{0} if +the first frame pointer is properly initialized by the startup code. + +This function should only be used with a non-zero argument for debugging +purposes. @end deftypefn @node Other Builtins |