From owner-cvs-all@FreeBSD.ORG  Tue Sep 13 15:16:50 2005
Return-Path: <owner-cvs-all@FreeBSD.ORG>
X-Original-To: cvs-all@FreeBSD.org
Delivered-To: cvs-all@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id A75B116A41F;
	Tue, 13 Sep 2005 15:16:50 +0000 (GMT) (envelope-from jhb@FreeBSD.org)
Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7948143D45;
	Tue, 13 Sep 2005 15:16:50 +0000 (GMT) (envelope-from jhb@FreeBSD.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.13.1/8.13.1) with ESMTP id j8DFGovu058486;
	Tue, 13 Sep 2005 15:16:50 GMT (envelope-from jhb@repoman.freebsd.org)
Received: (from jhb@localhost)
	by repoman.freebsd.org (8.13.1/8.13.1/Submit) id j8DFGoW3058485;
	Tue, 13 Sep 2005 15:16:50 GMT (envelope-from jhb)
Message-Id: <200509131516.j8DFGoW3058485@repoman.freebsd.org>
From: John Baldwin <jhb@FreeBSD.org>
Date: Tue, 13 Sep 2005 15:16:50 +0000 (UTC)
To: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org
X-FreeBSD-CVS-Branch: HEAD
Cc: 
Subject: cvs commit: src/share/man/man9 mutex.9
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 13 Sep 2005 15:16:50 -0000

jhb         2005-09-13 15:16:50 UTC

  FreeBSD src repository

  Modified files:
    share/man/man9       mutex.9 
  Log:
  Various and sundry improvements:
  - Replace 'process' with 'thread' everywhere.
  - Update several places to note that that the fact that default mutexes
    may adaptively spin isn't necessarily MD, but is just part of the
    implementation as a whole.
  - Clarify the text about MTX_SPIN mutexes only being appropriate for
    INTR_FAST interrupts or other low level scheduler code to make the
    jargon more FreeBSD-ish rather than BSD/OS-ish.
  - Also, note that it is possible that interrupts aren't blocked but just
    deferred when a spin lock is held (the whole blocked vs. deferred bit is
    an MD implementation detail).
  - Remove statements saying that spin locks must be released in the exact
    opposite order that they were acquired.  This stopped being true several
    years ago when we first added critical sections that stored their state
    in the current thread rather than in struct mtx.
  - Note that a mutex must be initialized before it is passed to any other
    mutex function, not just mtx_lock.
  - Clarify that mtx_trylock() only operates on MTX_DEF mutexes.
  - Simplify the text about possible preemption during a mtx_unlock().
  - Use complete English sentences in place of phrases in a few places.
  - Clarify that it isn't ever safe to sleep with a mutex held.  The kernel
    tends to panic when you do that.
  
  Requested by:   scottl (7)
  MFC after:      3 days
  
  Revision  Changes    Path
  1.48      +46 -49    src/share/man/man9/mutex.9