aboutsummaryrefslogtreecommitdiff
path: root/lib/libthr
diff options
context:
space:
mode:
authorRobert Watson <rwatson@FreeBSD.org>2005-06-11 15:27:56 +0000
committerRobert Watson <rwatson@FreeBSD.org>2005-06-11 15:27:56 +0000
commit5335c6bc6a05e3d8277436ef64d7ed9fabed839d (patch)
tree9e77036d7545cfbf860899972459a049af25d3bc /lib/libthr
parent3a996d6e91dcb08764bedce43f373668aa591860 (diff)
Notes
Diffstat (limited to 'lib/libthr')
-rw-r--r--lib/libthr/Makefile2
-rw-r--r--lib/libthr/libthr.372
2 files changed, 74 insertions, 0 deletions
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.