From owner-svn-src-all@FreeBSD.ORG Thu Jan 28 21:14:13 2010 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3C1B81065670; Thu, 28 Jan 2010 21:14:13 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 2AB638FC17; Thu, 28 Jan 2010 21:14:13 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id o0SLED7J055049; Thu, 28 Jan 2010 21:14:13 GMT (envelope-from trasz@svn.freebsd.org) Received: (from trasz@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id o0SLEDki055047; Thu, 28 Jan 2010 21:14:13 GMT (envelope-from trasz@svn.freebsd.org) Message-Id: <201001282114.o0SLEDki055047@svn.freebsd.org> From: Edward Tomasz Napierala Date: Thu, 28 Jan 2010 21:14:13 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r203131 - head/share/man/man9 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 28 Jan 2010 21:14:13 -0000 Author: trasz Date: Thu Jan 28 21:14:12 2010 New Revision: 203131 URL: http://svn.freebsd.org/changeset/base/203131 Log: Cosmetic fixes. Modified: head/share/man/man9/locking.9 Modified: head/share/man/man9/locking.9 ============================================================================== --- head/share/man/man9/locking.9 Thu Jan 28 20:46:40 2010 (r203130) +++ head/share/man/man9/locking.9 Thu Jan 28 21:14:12 2010 (r203131) @@ -76,9 +76,9 @@ threads (including interrupt threads), a If the mutex cannot be acquired, the thread requesting it will sleep. Mutexes fully support priority propagation. .Pp -See the +See .Xr mutex 9 -page for more information. +for details. .Ss Spin mutexes Spin mutexes are variation of basic mutexes; the main difference between the two is that spin mutexes never sleep - instead, they spin, waiting @@ -100,9 +100,9 @@ a pool mutex, one uses address of the st not the mutex itself. Pool mutexes are seldom used. .Pp -See the +See .Xr mtx_pool 9 -page for more information. +for details. .Ss Reader/writer locks Reader/writer locks allow shared access to protected data by multiple threads, or exclusive access by a single thread. @@ -131,9 +131,9 @@ can recurse, but exclusive locks are not This ability should not be used lightly and .Em may go away. .Pp -See the +See .Xr rwlock 9 -page for more information. +for details. .Ss Read-mostly locks Mostly reader locks are similar to .Em reader/writer @@ -144,9 +144,9 @@ using a lock user supplied .Em tracker data structure. .Pp -See the +See .Xr rmlock 9 -page for more information. +for details. .Ss Shared/exclusive locks Shared/exclusive locks are similar to reader/writer locks; the main difference between them is that shared/exclusive locks may be held during unbounded sleep @@ -158,9 +158,9 @@ They should be considered to be closely In fact it could in some cases be considered a conditional sleep. .Pp -See the +See .Xr sx 9 -page for more information. +for details. .Ss Counting semaphores Counting semaphores provide a mechanism for synchronizing access to a pool of resources. @@ -169,9 +169,9 @@ so they can be useful in situations wher to acquire a resource, and another thread needs to release it. They are largely deprecated. .Pp -See the +See .Xr sema 9 -page for more information. +for details. .Ss Condition variables Condition variables are used in conjunction with mutexes to wait for conditions to occur. @@ -182,9 +182,9 @@ When a thread waits on a condition, the is atomically released before the thread is blocked, then reacquired before the function call returns. .Pp -See the +See .Xr condvar 9 -page for more information. +for details. .Ss Giant Giant is an instance of a mutex, with some special characteristics: .Bl -enum @@ -262,9 +262,9 @@ while the thread is suspended and will r .Va Giant mutex before the function returns. .Pp -See the +See .Xr sleep 9 -page for more information. +for details. .Pp .Ss Lockmanager locks Shared/exclusive locks, used mostly in @@ -276,9 +276,9 @@ They have features other lock types don' writer starvation avoidance, draining, and interlock mutex, but this makes them complicated to implement; for this reason, they are deprecated. .Pp -See the +See .Xr lock 9 -page for more information. +for details. .Sh INTERACTIONS .Ss Bounded vs. unbounded sleep The following primitives perform bounded sleep: mutexes, pool mutexes, @@ -325,7 +325,7 @@ one of the synchronization primitives di .Xc .It Ic spin mtx Ta \&ok-1 Ta \&no Ta \&no Ta \&no Ta \&no Ta \&no-3 .It Ic mutex Ta \&ok Ta \&ok-1 Ta \&no Ta \&ok Ta \&ok Ta \&no-3 -.It Ic sxlock Ta \&ok Ta \&ok Ta \&ok-2 Ta \&ok Ta \&ok Ta \&ok-4 +.It Ic sx Ta \&ok Ta \&ok Ta \&ok-2 Ta \&ok Ta \&ok Ta \&ok-4 .It Ic rwlock Ta \&ok Ta \&ok Ta \&no Ta \&ok-2 Ta \&ok Ta \&no-3 .It Ic rmlock Ta \&ok Ta \&ok Ta \&no Ta \&ok Ta \&ok-2 Ta \&no .El