Removed outdated text about libc_r replacing libc (it now provides

just libc functions wrappers), and updated text to match reality:
there are three threading libraries in FreeBSD these days.

Removed instructions of how not to build libc_r, it's documented in
the make.conf(5) manpage already.

Removed description of the FreeBSD-specific gcc(1) option, -pthread.
While it's still provided (for backwards compatibility reasons),
its usefulness is questionable.
This commit is contained in:
ru 2004-01-15 17:58:26 +00:00
parent e9c21488d8
commit 77dbab5171

View File

@ -30,7 +30,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd September 10, 1998 .Dd January 15, 2004
.Dt PTHREAD 3 .Dt PTHREAD 3
.Os .Os
.Sh NAME .Sh NAME
@ -458,30 +458,15 @@ cancellation stack.
.Sh INSTALLATION .Sh INSTALLATION
The current The current
.Fx .Fx
POSIX thread implementation is built in the library POSIX thread implementation is built in three libraries,
.Fa libc_r .Lb libc_r ,
which contains both thread-safe libc functions and the thread functions. .Lb libpthread ,
This library replaces and
.Fa libc .Lb libthr .
for threaded applications. They contain both thread-safe versions of
.Pp .Lb libc
By default, functions and the thread functions.
.Fa libc_r Threaded applications are linked with one of these libraries.
is built as part of a 'make world'.
To disable the build of
.Fa libc_r
you must supply the '-DNOLIBC_R' option to
.Xr make 1 .
.Pp
A
.Fx
specific option has been added to gcc to make linking
threaded processes simple.
.Fa gcc -pthread
links a threaded process against
.Fa libc_r
instead of
.Fa libc .
.Sh SEE ALSO .Sh SEE ALSO
.Xr pthread_cleanup_pop 3 , .Xr pthread_cleanup_pop 3 ,
.Xr pthread_cleanup_push 3 , .Xr pthread_cleanup_push 3 ,
@ -530,24 +515,22 @@ instead of
.Xr pthread_setspecific 3 , .Xr pthread_setspecific 3 ,
.Xr pthread_testcancel 3 .Xr pthread_testcancel 3
.Sh STANDARDS .Sh STANDARDS
The functions in The functions with the
.Fa libc_r .Nm pthread_
with the
.Fa pthread_
prefix and not prefix and not
.Fa _np .Nm _np
suffix or suffix or
.Fa pthread_rwlock .Nm pthread_rwlock
prefix conform to prefix conform to
.St -p1003.1-96 . .St -p1003.1-96 .
.Pp .Pp
The functions in libc_r with the The functions with the
.Fa pthread_ .Nm pthread_
prefix and prefix and
.Fa _np .Nm _np
suffix are non-portable extensions to POSIX threads. suffix are non-portable extensions to POSIX threads.
.Pp .Pp
The functions in libc_r with the The functions with the
.Fa pthread_rwlock .Nm pthread_rwlock
prefix are extensions created by The Open Group as part of the prefix are extensions created by The Open Group as part of the
.St -susv2 . .St -susv2 .