[RFC] locking.9

[Julian Elischer]

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 \