Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
Developer Support
QNX Documentation Library
QNX Developer Support

QNX Developer Support

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

[Previous] [Contents] [Index] [Next]

pthread_cleanup_pop()

Pop a function off of a thread's cancellation-cleanup stack

Synopsis:

#include <pthread.h>

void pthread_cleanup_pop( int execute );

Arguments:

execute
Zero if you don't want to execute the handler; nonzero if you do.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_cleanup_pop() macro pops the top cancellation-cleanup handler from the calling thread's cancellation-cleanup stack and invokes the handler if execute is nonzero.


Note: The pthread_cleanup_pop() macro expands to a few lines of code that end with a closing brace (}), but don't have a matching opening brace ({). You must pair pthread_cleanup_pop() with pthread_cleanup_push() within the same lexical scope.

Examples:

See pthread_cleanup_push().

Classification:

POSIX 1003.1 THR

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

pthread_cleanup_push(), pthread_cancel(), pthread_exit()


[Previous] [Contents] [Index] [Next]