From owner-freebsd-current@FreeBSD.ORG  Wed Mar 14 04:54:06 2007
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
X-Original-To: current@freebsd.org
Delivered-To: freebsd-current@FreeBSD.ORG
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id AD04416A400
	for <current@freebsd.org>; Wed, 14 Mar 2007 04:54:06 +0000 (UTC)
	(envelope-from julian@elischer.org)
Received: from outU.internet-mail-service.net (outU.internet-mail-service.net
	[216.240.47.244])
	by mx1.freebsd.org (Postfix) with ESMTP id 9917013C484
	for <current@freebsd.org>; Wed, 14 Mar 2007 04:54:06 +0000 (UTC)
	(envelope-from julian@elischer.org)
Received: from mx0.idiom.com (HELO idiom.com) (216.240.32.160)
	by out.internet-mail-service.net (qpsmtpd/0.32) with ESMTP;
	Tue, 13 Mar 2007 21:27:03 -0700
Received: from [192.168.2.5] (home.elischer.org [216.240.48.38])
	by idiom.com (Postfix) with ESMTP id 7142B125DF2
	for <current@freebsd.org>; Tue, 13 Mar 2007 21:54:05 -0700 (PDT)
Message-ID: <45F77FED.1030601@elischer.org>
Date: Tue, 13 Mar 2007 21:54:05 -0700
From: Julian Elischer <julian@elischer.org>
User-Agent: Thunderbird 1.5.0.10 (Macintosh/20070221)
MIME-Version: 1.0
To: FreeBSD Current <current@freebsd.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: 
Subject: locking(9)
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 14 Mar 2007 04:54:06 -0000

I've committed a skeleton locking (9) man page.
Stolen some paragraphs from related man pages and made up some from whole cloth.
I'm hoping that it at least gives those who know about locking,  a place where
they can write in a quick 2 sentence not on something, rather than having
to do all the work of starting a new man page from scratch.

The object of this page is to document the overall strategy for freeBSD locking,
and the interactions between the various techniques.

Come to think of it I should put in a section on Netgraph locking.

If you know ANYTHING about lockin in the current kernel, check out 
share/man/man9/locking.9 and add your 10 cents worth. PLEASE!

julian