diff options
| author | Philip Guenther <guenther@cvs.openbsd.org> | 2015-05-12 20:13:16 +0000 |
|---|---|---|
| committer | Philip Guenther <guenther@cvs.openbsd.org> | 2015-05-12 20:13:16 +0000 |
| commit | f7fb3be634a4347fbb45d9a119dd5bea16d12424 (patch) | |
| tree | 5bcf125d9b117934d08196c8034305e9d19d4689 | |
| parent | 8c5bcebe4adae4f3e9ddbaf4527db67a9800ca39 (diff) | |
Document pthread_atfork(3)'s interaction with dlclose(3)
Use Xr instead of Fn for functions documented on other manpages
ok millert@ jmc@ schwarze@
| -rw-r--r-- | lib/libpthread/man/pthread_atfork.3 | 29 |
1 files changed, 21 insertions, 8 deletions
diff --git a/lib/libpthread/man/pthread_atfork.3 b/lib/libpthread/man/pthread_atfork.3 index 7e9f962a4c7..0161b66d81a 100644 --- a/lib/libpthread/man/pthread_atfork.3 +++ b/lib/libpthread/man/pthread_atfork.3 @@ -1,8 +1,8 @@ -.\" $OpenBSD: pthread_atfork.3,v 1.10 2013/06/05 03:44:50 tedu Exp $ +.\" $OpenBSD: pthread_atfork.3,v 1.11 2015/05/12 20:13:15 guenther Exp $ .\" .\" David Leonard <d@openbsd.org>, 1999. Public domain. .\" -.Dd $Mdocdate: June 5 2013 $ +.Dd $Mdocdate: May 12 2015 $ .Dt PTHREAD_ATFORK 3 .Os .Sh NAME @@ -16,23 +16,23 @@ The .Fn pthread_atfork function declares fork handlers to be called before and after -.Fn fork , +.Xr fork 2 , in the context of the thread that called -.Fn fork . +.Xr fork 2 . The .Fa prepare fork handler will be called before -.Fn fork +.Xr fork 2 processing commences. The .Fa parent fork handler will be called after -.Fn fork +.Xr fork 2 processing completes in the parent process. The .Fa child fork handler will be called after -.Fn fork +.Xr fork 2 processing completes in the child process. If no handling is desired at one or more of these three points, @@ -53,6 +53,15 @@ by calls to The .Fa prepare fork handlers will be called in the opposite order. +.Pp +If a shared object is unloaded from process memory using +.Xr dlclose 3 , +then any functions registered by calling +.Fn pthread_atfork +from that shared object will be unregistered without being invoked. +Note that it is the source of the call to +.Fn pthread_atfork +that matters, not the source of the functions that were registered. .Sh RETURN VALUES Upon successful completion, .Fn pthread_atfork @@ -69,8 +78,12 @@ None of the handler lists are modified. .El .Sh SEE ALSO .Xr fork 2 , -.Xr atexit 3 +.Xr atexit 3 , +.Xr dlclose 3 .Sh STANDARDS .Fn pthread_atfork conforms to .St -p1003.1-2004 . +.Pp +The behavior when a shared object is unloaded is an extension to +that standard. |