Standard C Library Functions              pthreadcleanuppop(3C)



NAME
     pthreadcleanuppop -  pop  a  thread  cancellation  cleanup
     handler

SYNOPSIS
     cc -mt [ flag... ] file... -lpthread [ library... ]
     #include 

     void pthreadcleanuppop(int execute);


DESCRIPTION
     The  pthreadcleanuppop()  function  removes  the   cleanup
     handler routine at the top of the cancellation cleanup stack
     of the calling thread and executes it  if  execute  is  non-
     zero.


     When the thread calls pthreadcleanuppop() with a  non-zero
     execute  argument,  the  argument at the top of the stack is
     popped and executed. An argument  of   0  pops  the  handler
     without executing it.


     The pthreadcleanuppush(3C) and pthreadcleanuppop() func-
     tions  can  be  implemented  as macros. The application must
     ensure that they appear as statements, and in  pairs  within
     the  same lexical scope (that is, the pthreadcleanuppush()
     macro can be thought to expand to a token list  whose  first
     token is '{' with pthreadcleanuppop() expanding to a token
     list whose last token is the corresponding '}').


     The effect of the use of return, break, continue,  and  goto
     to  prematurely  leave  a  code block described by a pair of
     pthreadcleanuppush()  and  pthreadcleanuppop()  function
     calls is undefined.


     Using longjmp() or siglongjmp() to jump into  or  out  of  a
     push/pop  pair can result in either the matching push or the
     matching pop statement not getting executed.

RETURN VALUES
     The pthreadcleanuppop() function returns no value.

ERORS
     No errors are defined.


     The pthreadcleanuppop() function will not return an  error
     code of EINTR.



SunOS 5.11           Last change: 4 Oct 2005                    1






Standard C Library Functions              pthreadcleanuppop(3C)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     pthreadcancel(3C),                pthreadcleanuppush(3C),
     pthreadexit(3C),                          pthreadjoin(3C),
     pthreadsetcancelstate(3C),       pthreadsetcanceltype(3C),
     pthreadtestcancel(3C), setjmp(3C), attributes(5), cancella-
     tion(5), condition(5), standards(5)

NOTES
     See cancellation(5) for a discussion  of  cancellation  con-
     cepts.






























SunOS 5.11           Last change: 4 Oct 2005                    2