From owner-freebsd-hackers@FreeBSD.ORG Fri Oct 19 13:51:05 2007 Return-Path: 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 DBB7416A421 for ; Fri, 19 Oct 2007 13:51:05 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from elvis.mu.org (elvis.mu.org [192.203.228.196]) by mx1.freebsd.org (Postfix) with ESMTP id CE76113C49D for ; Fri, 19 Oct 2007 13:51:05 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from zion.baldwin.cx (66-23-211-162.clients.speedfactory.net [66.23.211.162]) by elvis.mu.org (Postfix) with ESMTP id B0E541A4D8E; Fri, 19 Oct 2007 06:51:04 -0700 (PDT) From: John Baldwin To: Ed Schouten Date: Fri, 19 Oct 2007 08:42:33 -0400 User-Agent: KMail/1.9.7 References: <20071016094118.GE5411@hoeg.nl> <200710170916.18788.jhb@freebsd.org> <20071019045654.GF5411@hoeg.nl> In-Reply-To: <20071019045654.GF5411@hoeg.nl> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-15" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200710190842.34286.jhb@freebsd.org> Cc: FreeBSD Hackers 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Oct 2007 13:51:05 -0000 On Friday 19 October 2007 12:56:54 am Ed Schouten wrote: > * John Baldwin 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. -- John Baldwin