From owner-freebsd-hackers@FreeBSD.ORG  Fri Oct 19 18:09:07 2007
Return-Path: <owner-freebsd-hackers@FreeBSD.ORG>
Delivered-To: freebsd-hackers@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id D196116A417;
	Fri, 19 Oct 2007 18:09:07 +0000 (UTC) (envelope-from jhb@freebsd.org)
Received: from speedfactory.net (mail6.speedfactory.net [66.23.216.219])
	by mx1.freebsd.org (Postfix) with ESMTP id 5F4E813C467;
	Fri, 19 Oct 2007 18:09:06 +0000 (UTC) (envelope-from jhb@freebsd.org)
Received: from server.baldwin.cx (unverified [66.23.211.162]) 
	by speedfactory.net (SurgeMail 3.8p) with ESMTP id 215186663-1834499 
	for multiple; Fri, 19 Oct 2007 14:11:20 -0400
Received: from localhost.corp.yahoo.com (john@localhost [127.0.0.1])
	(authenticated bits=0)
	by server.baldwin.cx (8.13.8/8.13.8) with ESMTP id l9JI8pIb032709;
	Fri, 19 Oct 2007 14:09:00 -0400 (EDT) (envelope-from jhb@freebsd.org)
From: John Baldwin <jhb@freebsd.org>
To: "Attilio Rao" <attilio@freebsd.org>
Date: Fri, 19 Oct 2007 14:05:26 -0400
User-Agent: KMail/1.9.6
References: <20071016094118.GE5411@hoeg.nl>
	<200710190842.34286.jhb@freebsd.org>
	<3bbf2fe10710191008r6dc1939em85f8574e107af48b@mail.gmail.com>
In-Reply-To: <3bbf2fe10710191008r6dc1939em85f8574e107af48b@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="utf-8"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200710191405.26488.jhb@freebsd.org>
X-Greylist: Sender succeeded SMTP AUTH authentication, not delayed by
	milter-greylist-2.0.2 (server.baldwin.cx [127.0.0.1]);
	Fri, 19 Oct 2007 14:09:01 -0400 (EDT)
X-Virus-Scanned: ClamAV 0.88.3/4545/Wed Oct 17 17:05:57 2007 on
	server.baldwin.cx
X-Virus-Status: Clean
X-Spam-Status: No, score=-4.4 required=4.2 tests=ALL_TRUSTED,AWL,BAYES_00 
	autolearn=ham version=3.1.3
X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on server.baldwin.cx
Cc: FreeBSD Hackers <freebsd-hackers@freebsd.org>, Ed Schouten <ed@fxq.nl>
Subject: Re: Inner workings of turnstiles and sleepqueues
X-BeenThere: freebsd-hackers@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Technical Discussions relating to FreeBSD
	<freebsd-hackers.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-hackers>, 
	<mailto:freebsd-hackers-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-hackers>
List-Post: <mailto:freebsd-hackers@freebsd.org>
List-Help: <mailto:freebsd-hackers-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-hackers>,
	<mailto:freebsd-hackers-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 19 Oct 2007 18:09:07 -0000

On Friday 19 October 2007 01:08:27 pm Attilio Rao wrote:
> 2007/10/19, John Baldwin <jhb@freebsd.org>:
> > On Friday 19 October 2007 12:56:54 am Ed Schouten wrote:
> > > * John Baldwin <jhb@freebsd.org> wrote:
> > > > The best option right now is to read the code.  There are some 
comments in
> > > > both the headers and implementation.
> > >
> > > Would it be useful to write manpages for these interfaces, or do we
> > > assume that only godlike people can use them anyway? I am willing to
> > > write manpages for them.
> >
> > They already exist, but they really are only used to implement 
higher-level
> > primitives like locks and condition variables.  The rest of the kernel 
should
> > use the higher-level primitives anyway.
> 
> Well, really turnstiles don't have manpages, but this is still OK as
> they are only used in mutex while the "real" sleeping primitive should
> be identified by sleepqueues.

Ah, there is a sleepqueue(9), but not a turnstile(9).

-- 
John Baldwin