Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	bound-
       ary  information.   The address is stored at the	location pointed to by
       spp. If this address has	not been defined using a previous call to  se-
       tustack(), 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 ad-
		       dress.

USAGE
       Only implementors of custom threading libraries should use these	 func-
       tions 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_set-
       bounds(3C), stack_violation(3C),	attributes(5)

SunOS 5.10			  2 Nov	2004			  getustack(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getustack&sektion=2&manpath=SunOS+5.10>

home | help