Subject: Re: misc/4543: spl(9) manpage in conflict with reality
To: Mike Long <mikel@shore.net>
From: Jonathan Stone <jonathan@DSG.Stanford.EDU>
List: netbsd-bugs
Date: 11/19/1997 09:34:03
Mike Long writes:
>>Date: Wed, 19 Nov 1997 06:31:39 -0800 (PST)
>>From: Jonathan Stone <jonathan@DSG.Stanford.EDU>
>
>>spl(9) describes the synchronization protocol used inside the kernel.
>>But the description is not correct. The man page begins
[...]
>>where historically, and on at least hte mips and vax ports the
>>converse is actually true: sptty() blocks tty interrupts and _lower_
>>spl levels. For example, spltty() does _not_ block out splsched().
>You are correct, I biffed this.
hi, Mike,
Thanks for the reply. The current manpage had gotten me quie seriously
confused.
I'd like to generate some text that clarifies both that, and the
requirements/invariants that (as far as I understand)
a) MI callers of the spl* code should obey
b) the semantics MD code must provide
in order to guarantee correct synchronization -- somewhat like the
manpage I originally counter-proposed to your draft, except describing
semantics rather than specific implentations. I think that would really help.
Does that sound appropriate for this manpage?