NAME    [Toc]    [Back]

     pthread_stackseg_np - return stack size and location

SYNOPSIS    [Toc]    [Back]

     #include <sys/signal.h>
     #include <pthread_np.h>

     int
     pthread_stackseg_np(pthread_t thread, stack_t *sinfo);

DESCRIPTION    [Toc]    [Back]

     The pthread_stackseg_np() function returns information about
the given
     thread's   stack.   A  stack_t  is  the  same  as  a  struct
sigaltstack (see
     sigaltstack(2)) except the ss_sp variable points to the  top
of the stack
     instead of the base.

RETURN VALUES    [Toc]    [Back]

     If  successful,  the pthread_stackseg_np() function will return 0.  Otherwise
 an error number will be returned to indicate the error.

ERRORS    [Toc]    [Back]

     The pthread_stackseg_np() function will fail if:

     [EAGAIN]       Stack information for the given thread is not
currently
                   available.  There is  no  guarantee  that  the
given thread's
                   stack  information will ever become available.

SEE ALSO    [Toc]    [Back]

     sigaltstack(2), pthreads(3)

STANDARDS    [Toc]    [Back]

     pthread_stackseg_np() is a non-portable  extension  to  IEEE
Std 1003.1-2001
     (``POSIX'').

OpenBSD      3.6                         January     15,     2004