NAME

    pthread_cleanup_pop - Removes the cleanup handler at the top of the
                          cleanup stack and optionally executes it

 SYNOPSIS

     #include <pthread.h>

     void pthread_cleanup_pop(int execute);

 PARAMETERS

     execute              Integer that specifies whether the cleanup
                          routine that is popped should be executed or
                          just discarded.  If the value is nonzero, the
                          cleanup routine is executed.

 DESCRIPTION

 The pthread_cleanup_pop()  routine removes the routine specified in
 pthread_cleanup_push() from the top of the calling thread's cleanup
 stack and executes it if the value specified in execute is nonzero.

 This routine and pthread_cleanup_push() are implemented as macros and
 must be displayed as statements and in pairs within the same lexical
 scope.  You can think of the pthread_cleanup_push() macro as expanding
 to a string whose first character is a { (left brace) and
 pthread_cleanup_pop as expanding to a string containing the correspond-
 ing } (right brace).

 RETURN VALUES

 This routine must be used as a statement.

 RELATED INFORMATION

      FUNCTIONS: pthread_cleanup_push