Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

__builtin_return_address(3) [netbsd man page]

__BUILTIN_RETURN_ADDRESS(3)				   BSD Library Functions Manual 			       __BUILTIN_RETURN_ADDRESS(3)

NAME

     __builtin_return_address -- the return address of a function

SYNOPSIS

     void *
     __builtin_return_address(unsigned int level);

     void *
     __builtin_frame_address(unsigned int level);

DESCRIPTION

     The __builtin_return_address() is a GNU extension for obtaining the return address of the current function or one of the callers of the cur-
     rent function.

     The parameter level specifies the number of frames that should be scanned up in the call stack.  A value 0 returns the address of the current
     function, a value 1 requests the address of the caller of the current function, a value 2 asks for the address of the caller's caller, and so
     forth.  If the top of the call stack has been reached, the function will return 0.  Note also that on some architectures it is only possible
     to determine the address of the current function.	In such cases a value 0 is returned.  Thus, it is usually safe to only use the value 0 for
     level.

     The __builtin_frame_address() behaves similarly, but returns the address of the function frame rather than the return address of the func-
     tion.

SEE ALSO

     gcc(1), __builtin_object_size(3)

CAVEATS

     These are non-standard, compiler-specific extensions.

BSD
								 December 19, 2010							       BSD

Check Out this Related Man Page

stack_inbounds(3C)					   Standard C Library Functions 					stack_inbounds(3C)

NAME

       stack_inbounds - determine if address is within stack boundaries

SYNOPSIS

       #include <ucontext.h>

       int stack_inbounds(void *addr);

DESCRIPTION

       The  stack_inbounds()  function	returns  a  boolean value indicating whether the address specified by addr is within the boundaries of the
       stack of the calling thread. The address is compared to the stack boundary information returned by a call to stack_getbounds(3C).

RETURN VALUES

       The stack_inbounds() function returns 0 to indicate that addr is not within the current stack bounds, or a non-zero value to indicate  that
       addr is within the stack bounds.

ERRORS

       No errors are defined.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       stack_getbounds(3C), attributes(5)

SunOS 5.10							    18 Jul 2002 						stack_inbounds(3C)
Man Page