Standard C Library Functions                  stackgetbounds(3C)



NAME
     stackgetbounds - retrieve stack boundaries

SYNOPSIS
     #include 

     int stackgetbounds(stackt *sp);


DESCRIPTION
     The stackgetbounds() function  retrieves  the  stack  boun-
     daries that the calling thread is currently operating on. If
     the thread is currently operating on  the  alternate  signal
     stack, this function will retrieve the bounds of that stack.


     If successful, stackgetbounds() sets the  sssp  member  of
     the  stackt  structure  pointed to by sp to the base of the
     stack region and the sssize member  to  its  size  (maximum
     extent)  in  bytes. The ssflags member is set to SONSTACK
     if the calling thread is executing on its  alternate  signal
     stack, and zero otherwise.

RETURN VALUES
     Upon successful  completion,  stackgetbounds()  returns  0.
     Otherwise,  -1  is returned and errno is set to indicate the
     error.

ERORS
     The stackgetbounds() function will fail if:

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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     Async-Signal-Safe           
    


SEE ALSO
     getustack(2),         sigaction(2),          sigaltstack(2),
     stacksetbounds(3C), attributes(5)



SunOS 5.11          Last change: 18 Jul 2002                    1