manpagez: man(ual) pages & more
man pthread_atfork(3)
Home | html | info | man
pthread_atfork(3)        BSD Library Functions Manual        pthread_atfork(3)


NAME

     pthread_atfork -- register handlers to be called before and after fork()


SYNOPSIS

     #include <pthread.h>

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


DESCRIPTION

     The pthread_atfork() function is used to register functions to be called
     before and after fork().  The prepare handler is called before fork(),
     while the parent and child handlers are called after fork() in the parent
     and child process respectively.  The prepare handlers are called in
     reverse order of their registration, while parent and child handlers are
     called in the order in which they were registered.  Any of the handlers
     may be NULL.

     Important: only async-signal-safe functions are allowed on the child side
     of fork().  See sigaction(2) for details.


RETURN VALUES

     If successful, the pthread_atfork() function will return zero; otherwise
     an error number will be returned to indicate the error.


ERRORS

     pthread_atfork() will fail if:

     [ENOMEM]           The system lacked the necessary resources to add
                        another handler to the list.


SEE ALSO

     fork(2)


STANDARDS

     pthread_atfork() conforms to ISO/IEC 9945-1:1996 (``POSIX.1'').

BSD                             August 12, 2004                            BSD

Mac OS X 10.9.1 - Generated Thu Jan 9 05:39:22 CST 2014
© manpagez.com 2000-2017
Individual documents may contain additional copyright information.