diff --git a/lib/libthr/Makefile b/lib/libthr/Makefile index 9a8f40c2fc0d..126fc5e7c52b 100644 --- a/lib/libthr/Makefile +++ b/lib/libthr/Makefile @@ -23,6 +23,8 @@ CFLAGS+=-Winline LDFLAGS= -Wl,--version-script=${.CURDIR}/pthread.map +MAN= libthr.3 + # enable extra internal consistancy checks CFLAGS+=-D_PTHREADS_INVARIANTS -Wall CFLAGS+=-g diff --git a/lib/libthr/libthr.3 b/lib/libthr/libthr.3 new file mode 100644 index 000000000000..685c89b41c55 --- /dev/null +++ b/lib/libthr/libthr.3 @@ -0,0 +1,72 @@ +.\" Copyright (c) 2005 Robert N. M. Watson +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd June 11, 2005 +.Os +.Dt LIBTHR 3 +.Sh NAME +.Nm libthr +.Nd "alternative POSIX threads library" +.Sh LIBRARY +.Lb libthr +.Sh SYNOPSIS +.In pthread.h +.Sh DESCRIPTION +The +.Nm +library provides an alternative 1:1 implementation of the +.Xr pthread 3 +library interfaces for application threading. +While applications may be linked directly against +.Nm , +system administrators are offered maximum flexibility by linking against +.Xr pthread 3 , +as they can then use +.Xr libmap.conf 5 +to select the threading implementation on a per-application basis. +.Pp +.Nm +has been optimized for use by applications expecting system scope thread +semantics, and can provide significant performance improvements. +.Sh SEE ALSO +.Xr pthread 3 , +.Sh AUTHORS +.An -nosplit +.Nm +was originally created by +.An "Jeff Roberson" Aq jeff@FreeBSD.org , +and enhanced by +.An "Jonathan Mini" Aq mini@FreeBSD.org +and +.An "Mike Makonnen" Aq mtm@FreeBSD.org . +It has been substantially rewritten and optimized by +.An "David Xu" Aq davidxu@FreeBSD.org . +.An -split +.Sh BUGS +As +.Nm +is an optimized system scope thread library, it does not offer support for +scheduling threads as process scope threads.