Function safety

Function safety refers to whether or not it's safe to use the Addon Interfaces (AOI) library API functions in certain situations.

All API functions are thread-safe and behave as documented even in a multithreaded environment. However, these functions are neither interrupt-safe nor signal-safe. Consequently, you shouldn't call them in an interrupt handler or signal handler.

For more information on how QNX defines function safety situations outside of the POSIX context, refer to the What's in a Function Description? section in the C Library Reference.

Classification:

QNX Neutrino

Safety
Cancellation point Read the Caveats
Interrupt handler No
Signal handler No
Thread Yes

Caveats:

Any AOI library function may contain a cancellation point. However, cancelling a thread while it's executing an AOI function can cause leaks or leave data structures in a bad state. If you need to call API functions from a thread that might be cancelled during the call or might already have a pending cancellation request, then disable cancellation for the duration of the call.

Page updated: