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

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_atfork()

Register fork handlers

Synopsis:

#include <process.h>

int pthread_atfork( void (*prepare)(void),
                    void (*parent)(void),
                    void (*child)(void) );

Arguments:

prepare
NULL, or a pointer to the handler to call before the fork.
parent
NULL, or a pointer to the handler to call after the fork in the parent process.
child
NULL, or a pointer to the handler to call after the fork in the child process.

Library:

libc

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

Description:

The pthread_atfork() function registers fork handler functions to be called before and after a fork(), in the context of the thread that called fork(). You can set one or more of the arguments to NULL to indicate no handler.

You can register multiple prepare, parent, and child fork handlers, by making additional calls to pthread_atfork(). In this case, the parent and child handlers are called in the order they were registered, and the prepare handlers are called in the reverse order.


Note:

You can't use the pthread_atfork() function for useful purposes as the C library doesn't have the necessary handlers. It also implies that Neutrino currently doesn't support fork() in multi-threaded programs.


Returns:

EOK
Success.
ENOMEM
Insufficient memory to record fork handlers.

Classification:

POSIX 1003.1 THR

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

See also:

atexit(), fork()


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