PTHREAD_ATFORK(3)      FreeBSD Library Functions Manual      PTHREAD_ATFORK(3)

NAME
     pthread_atfork - register fork handlers

LIBRARY
     POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS
     #include <pthread.h>

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

DESCRIPTION
     The pthread_atfork() function declares fork handlers to be called before
     and after fork(2), in the context of the thread that called fork(2).

     The handlers registered with pthread_atfork() are called at the moments
     in time described below:

     prepare      Before fork(2) processing commences in the parent process.
                  If more than one prepare handler is registered they will be
                  called in the opposite order they were registered.

     parent       After fork(2) completes in the parent process.  If more than
                  one parent handler is registered they will be called in the
                  same order they were registered.

     child        After fork(2) processing completes in the child process.  If
                  more than one child handler is registered they will be
                  called in the same order they were registered.

     If no handling is desired at one or more of these three points, a null
     pointer may be passed as the corresponding fork handler.

RETURN VALUES
     If successful, the pthread_atfork() function will return zero.  Otherwise
     an error number will be returned to indicate the error.

ERRORS
     The pthread_atfork() function will fail if:

     [ENOMEM]           Insufficient table space exists to record the fork
                        handler addresses.

SEE ALSO
     fork(2), pthread(3)

STANDARDS
     The pthread_atfork() function is expected to conform to IEEE Std 1003.1
     ("POSIX.1").

AUTHORS
     This manpage was written by Alex Vasylenko <lxv@omut.org>.

FreeBSD 13.1-RELEASE-p6          June 21, 2004         FreeBSD 13.1-RELEASE-p6