15335c6bcSRobert Watson.\" Copyright (c) 2005 Robert N. M. Watson 25335c6bcSRobert Watson.\" All rights reserved. 35335c6bcSRobert Watson.\" 45335c6bcSRobert Watson.\" Redistribution and use in source and binary forms, with or without 55335c6bcSRobert Watson.\" modification, are permitted provided that the following conditions 65335c6bcSRobert Watson.\" are met: 75335c6bcSRobert Watson.\" 1. Redistributions of source code must retain the above copyright 85335c6bcSRobert Watson.\" notice, this list of conditions and the following disclaimer. 95335c6bcSRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright 105335c6bcSRobert Watson.\" notice, this list of conditions and the following disclaimer in the 115335c6bcSRobert Watson.\" documentation and/or other materials provided with the distribution. 125335c6bcSRobert Watson.\" 135335c6bcSRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND 145335c6bcSRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 155335c6bcSRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 165335c6bcSRobert Watson.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE 175335c6bcSRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 185335c6bcSRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 195335c6bcSRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 205335c6bcSRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 215335c6bcSRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 225335c6bcSRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 235335c6bcSRobert Watson.\" SUCH DAMAGE. 245335c6bcSRobert Watson.\" 255335c6bcSRobert Watson.\" $FreeBSD$ 265335c6bcSRobert Watson.\" 275335c6bcSRobert Watson.Dd June 11, 2005 285335c6bcSRobert Watson.Os 295335c6bcSRobert Watson.Dt LIBTHR 3 305335c6bcSRobert Watson.Sh NAME 315335c6bcSRobert Watson.Nm libthr 325335c6bcSRobert Watson.Nd "alternative POSIX threads library" 335335c6bcSRobert Watson.Sh LIBRARY 345335c6bcSRobert Watson.Lb libthr 355335c6bcSRobert Watson.Sh SYNOPSIS 365335c6bcSRobert Watson.In pthread.h 375335c6bcSRobert Watson.Sh DESCRIPTION 385335c6bcSRobert WatsonThe 395335c6bcSRobert Watson.Nm 405335c6bcSRobert Watsonlibrary provides an alternative 1:1 implementation of the 415335c6bcSRobert Watson.Xr pthread 3 425335c6bcSRobert Watsonlibrary interfaces for application threading. 435335c6bcSRobert WatsonWhile applications may be linked directly against 445335c6bcSRobert Watson.Nm , 455335c6bcSRobert Watsonsystem administrators are offered maximum flexibility by linking against 465335c6bcSRobert Watson.Xr pthread 3 , 475335c6bcSRobert Watsonas they can then use 485335c6bcSRobert Watson.Xr libmap.conf 5 495335c6bcSRobert Watsonto select the threading implementation on a per-application basis. 505335c6bcSRobert Watson.Pp 515335c6bcSRobert Watson.Nm 525335c6bcSRobert Watsonhas been optimized for use by applications expecting system scope thread 535335c6bcSRobert Watsonsemantics, and can provide significant performance improvements. 545335c6bcSRobert Watson.Sh SEE ALSO 555335c6bcSRobert Watson.Xr pthread 3 , 565335c6bcSRobert Watson.Sh AUTHORS 575335c6bcSRobert Watson.An -nosplit 585335c6bcSRobert Watson.Nm 595335c6bcSRobert Watsonwas originally created by 605335c6bcSRobert Watson.An "Jeff Roberson" Aq jeff@FreeBSD.org , 615335c6bcSRobert Watsonand enhanced by 625335c6bcSRobert Watson.An "Jonathan Mini" Aq mini@FreeBSD.org 635335c6bcSRobert Watsonand 645335c6bcSRobert Watson.An "Mike Makonnen" Aq mtm@FreeBSD.org . 655335c6bcSRobert WatsonIt has been substantially rewritten and optimized by 665335c6bcSRobert Watson.An "David Xu" Aq davidxu@FreeBSD.org . 675335c6bcSRobert Watson.An -split 685335c6bcSRobert Watson.Sh BUGS 695335c6bcSRobert WatsonAs 705335c6bcSRobert Watson.Nm 715335c6bcSRobert Watsonis an optimized system scope thread library, it does not offer support for 725335c6bcSRobert Watsonscheduling threads as process scope threads. 73