pthread_atfork(3t) [hpux man page]

pthread_atfork(3T)														pthread_atfork(3T)

NAME

       pthread_atfork() - register fork handlers.

SYNOPSIS

PARAMETERS

	      prepare	This function is called before performing the

	      parent	This function is called in the parent process after performing the

	      child	This function is called in the child process after performing the

DESCRIPTION

       The  function allows an application to install fork handlers.  These fork handlers will be called before and after a operation.	These han-
       dlers will be called in the context of the thread calling Similar to the handlers, the application does not need to do anything special for
       these fork handlers to be called.  They will be invoked by the system when a operation occurs.

       The  function is called before the operation in the parent process.  The function is called after the operation in the parent process.  The
       function is called after the operation in the child process.

       If a fork handler is not needed in one or more of these three places, the appropriate fork handler parameter may be set to NULL.

       A process may install multiple fork handling functions.	The and fork handlers will be called in the order in  which  they  were  installed
       (i.e., The fork handlers will be called in the opposite order (i.e.,

RETURN VALUE

       Upon successful completion, returns zero. Otherwise, an error number is returned to indicate the error (the variable is not set).

ERRORS

       If any of the following occur, the function returns the corresponding error number:

	      [ENOMEM]	     There is insufficient table space to install the fork handlers.

AUTHOR

       was derived from the IEEE POSIX P1003.1c standard.

SEE ALSO

       fork(2), atexit(3).

STANDARDS CONFORMANCE

								  Pthread Library						pthread_atfork(3T)

PTHREAD_ATFORK(3)					     Library Functions Manual						 PTHREAD_ATFORK(3)

NAME

       pthread_atfork - register handlers to be called at fork(2) time

SYNOPSIS

       #include <pthread.h>

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

DESCRIPTION

       pthread_atfork  registers handler functions to be called just before and just after a new process is created with fork(2). The prepare han-
       dler will be called from the parent process, just before the new process is created. The parent handler will  be  called  from  the  parent
       process, just before fork(2) returns. The child handler will be called from the child process, just before fork(2) returns.

       One or several of the three handlers prepare, parent and child can be given as NULL, meaning that no handler needs to be called at the cor-
       responding point.

       pthread_atfork can be called several times to install several sets of handlers. At fork(2) time, the prepare handlers are  called  in  LIFO
       order  (last  added  with  pthread_atfork,  first  called before fork), while the parent and child handlers are called in FIFO order (first
       added, first called).

       To understand the purpose of pthread_atfork, recall that fork(2) duplicates the whole memory space,  including  mutexes	in  their  current
       locking	state, but only the calling thread: other threads are not running in the child process.  The mutexes are not usable after the fork
       and must be initialized with pthread_mutex_init in the child process.  This is a limitation of the  current  implementation  and  might	or
       might not be present in future versions.

RETURN VALUE

       pthread_atfork returns 0 on success and a non-zero error code on error.

ERRORS

       ENOMEM insufficient memory available to register the handlers.

AUTHOR

       Xavier Leroy <Xavier.Leroy@inria.fr>

SEE ALSO

       fork(2), pthread_mutex_lock(3), pthread_mutex_unlock(3).

								   LinuxThreads 						 PTHREAD_ATFORK(3)