From owner-freebsd-current@FreeBSD.ORG Sun Mar 18 05:00:07 2007 Return-Path: X-Original-To: freebsd-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 A1CBA16A401 for ; Sun, 18 Mar 2007 05:00:07 +0000 (UTC) (envelope-from julian@elischer.org) Received: from outG.internet-mail-service.net (outG.internet-mail-service.net [216.240.47.230]) by mx1.freebsd.org (Postfix) with ESMTP id 82C5913C46C for ; Sun, 18 Mar 2007 05:00:07 +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; Sat, 17 Mar 2007 21:19:07 -0700 Received: from [192.168.2.4] (home.elischer.org [216.240.48.38]) by idiom.com (Postfix) with ESMTP id 8C4A5125AE3; Sat, 17 Mar 2007 21:46:40 -0700 (PDT) Message-ID: <45FCC430.30901@elischer.org> Date: Sat, 17 Mar 2007 21:46:40 -0700 From: Julian Elischer User-Agent: Thunderbird 1.5.0.10 (Macintosh/20070221) MIME-Version: 1.0 To: Duane Whitty References: <200703092241.l29Mf2Ds062856@repoman.freebsd.org> <200703121535.22140.jhb@freebsd.org> <20070312200345.GB5688@garage.freebsd.pl> <200703121618.41084.jhb@freebsd.org> <45F5E1F9.5090806@elischer.org> <20070313010309.Q25395@fledge.watson.org> <45F73AE7.6010508@elischer.org> <20070317073855.GA58662@dwpc.dwlabs.ca> In-Reply-To: <20070317073855.GA58662@dwpc.dwlabs.ca> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-current@freebsd.org Subject: Re: [RFC] 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Mar 2007 05:00:07 -0000 Duane Whitty wrote: > On Tuesday, 13 March 2007 at 16:59:35 -0700, Julian Elischer wrote: >> resend to the right place with a corrected attachment. >> >> Robert Watson wrote: >>> The idea of a locking(9) has been kicked around for a while, and its >>> time has definitely come. It would summarize the properties and cross >>> reference the man pages of the various primitives, and suggest a >>> preference and strategy for using them in new code vs. existing code, >>> etc. Distinguishing dimensions would include things like whether it is >>> sleepable, supports priority propagation, can be acquired in interrupt >>> context (a result of the prior two properties), whether it is fair, etc, >>> etc. And include stern warnings about not using lockmgr in new code :-). >>> >>> Robert N M Watson >>> Computer Laboratory >>> University of Cambridge >> >> ok so how about I commit this to get us started and the nroff and >> locking experts can take it from there. >> >> > > This is great! Thank you on behalf of newcomers everywhere. > It turns out the man9 page doesn't get installed. I've attached > the patch for /usr/src/share/man/man9/Makefile so that this gets > installed. > > I'm looking forward to reading this and I know I'll learn a lot. > thanks.. actually it's deliberately not in the build yet.. I'd rather not do that until it's had a few more people go through it and take the bugs out. :-) >> ------------------------------------------------------------------------ >> >> --- /usr/src/share/man/man9/Makefile.old Fri Mar 16 20:14:48 2007 >> +++ /usr/src/share/man/man9/Makefile Fri Mar 16 20:09:01 2007 >> @@ -133,6 +133,7 @@ >> kthread.9 \ >> ktr.9 \ >> lock.9 \ >> + locking.9 \ >> LOCK_PROFILING.9 \ >> mac.9 \ >> make_dev.9 \