PTHREADCLEANUPPUSHDEFERLinux Programmer's PTHREADCLEANUPPUSHDEFERNP(3)

NAME
       pthreadcleanuppushdefernp,  pthreadcleanuppoprestorenp  -  push
       and pop thread cancellation clean-up handlers while saving  cancelabil‐
       ity type

SYNOPSIS
       #include 

       void pthreadcleanuppushdefernp(void (*routine)(void *),
                                          void *arg);
       void pthreadcleanuppoprestorenp(int execute);

       Compile and link with -pthread.

DESCRIPTION
       These   functions   are   the   same   as  pthreadcleanuppush(3)  and
       pthreadcleanuppop(3), except for the differences noted on this page.

       Like  pthreadcleanuppush(3),  pthreadcleanuppushdefernp()  pushes
       routine  onto the thread's stack of cancellation clean-up handlers.  In
       addition, it also saves the thread's current  cancelability  type,  and
       sets  the  cancelability  type  to  "deferred"  (see pthreadsetcancel‐
       type(3)); this ensures that cancellation clean-up will  occur  even  if
       the thread's cancelability type was "asynchronous" before the call.

       Like  pthreadcleanuppop(3), pthreadcleanuppoprestorenp() pops the
       top-most clean-up handler  from  the  thread's  stack  of  cancellation
       clean-up handlers.  In addition, it restores the thread's cancelability
       type   to    its    value    at    the    time    of    the    matching
       pthreadcleanuppushdefernp().

       The  caller must ensure that calls to these functions are paired within
       the same function, and  at  the  same  lexical  nesting  level.   Other
       restrictions apply, as described in pthreadcleanuppush(3).

       This sequence of calls:

           pthreadcleanuppushdefernp(routine, arg);
           pthreadcleanuppoprestorenp(execute);

       is equivalent to (but shorter and more efficient than):

           int oldtype;

           pthreadcleanuppush(routine, arg);
           pthreadsetcanceltype(PTHREADCANCELDEFERRED, &oldtype);
           ...
           pthreadsetcanceltype(oldtype, NULL);
           pthreadcleanuppop(execute);

CONFORMING TO
       These  functions are nonstandard GNU extensions; hence the suffix "np"
       (nonportable) in the names.

SEE ALSO
       pthreadcancel(3), pthreadcleanuppush(3),  pthreadsetcancelstate(3),
       pthreadtestcancel(3), pthreads(7)

COLOPHON
       This  page  is  part of release 3.53 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.



Linux                             2008-12-04  PTHREADCLEANUPPUSHDEFERNP(3)