sunos man page for getustack

getustack(2)							   System Calls 						      getustack(2)

NAME
       getustack, setustack - retrieve or change the address of per-LWP stack boundary information

SYNOPSIS
       #include <ucontext.h>

       int getustack(stack_t **spp);

       int setustack(stack_t *sp);

DESCRIPTION
       The  getustack() function retrieves the address of per-LWP stack boundary information.  The address is stored at the location pointed to by
       spp. If this address has not been defined using a previous call to setustack(), NULL is stored at the location pointed to by spp.

       The setustack() function changes the address of the current thread's stack boundary information to the value of sp.

RETURN VALUES
       Upon successful completion, these functions return 0. Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS
       These functions will fail if:

       EFAULT	       The spp or sp argument does not refer to a valid address.

USAGE
       Only implementors of custom threading libraries should use these functions to get and set the address of the stack  bound  to  an  internal
       per-thread data structure. Other users should use stack_getbounds(3C) and stack_setbounds(3C).

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_grow(3C), stack_getbounds(3C), stack_inbounds(3C), stack_setbounds(3C), stack_violation(3C), attributes(5)

SunOS 5.10							    2 Nov 2004							      getustack(2)