Copyright Digital Equipment Corp. All rights reserved.

Description

   This routine removes the cleanup handler routine established by
   the matching call to pthread_cleanup_push() from the calling
   thread's cleanup handler stack, then executes it if the value
   specified in this routine's execute argument is nonzero.

   A cleanup handler routine can be used to clean up from a block
   of code whether exited by normal completion, cancelation, or the
   raising (or reraising) of an exception. The routine is popped
   from the calling thread's cleanup handler stack and is called
   with the arg argument (see the description for pthread_cleanup_
   push()) when any of the following actions occur:

   o  The thread calls pthread_cleanup_pop() and specifies a nonzero
      value for the execute argument.

   o  The thread calls pthread_exit().

   o  The thread is canceled.

   o  An exception is raised and is caught when the Threads Library
      unwinds the calling thread's stack to the lexical scope of the
      pthread_cleanup_push() and pthread_cleanup_pop()  pair.

   This routine and pthread_cleanup_push() are implemented as
   macros and must appear 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 corresponding right brace (}). This routine and
   pthread_cleanup_push() are implemented as exceptions, and may not
   work in a C++ environment. (See <REFERENCE>(exceptions_chap) for
   more information.)