:man| Alphabetical   Categories   About us 
 
PTHREAD_ATFORK (3) | C library functions | Unix Manual Pages | :man▋

NAME

pthread_atfork - register fork handlers

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
Standards
Authors

LIBRARY


.Lb libpthread

SYNOPSIS


.In pthread.h int
.Fo pthread_atfork "void lp]*preparerp]lp]voidrp]" "void lp]*parentrp]lp]voidrp]" "void lp]*childrp]lp]voidrp]"
.Fc

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

AUTHORS

 
Created by Blin Media, 2008-2013