From owner-freebsd-hackers@FreeBSD.ORG Fri Oct 19 18:34:39 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 DBC5D16A417 for ; Fri, 19 Oct 2007 18:34:38 +0000 (UTC) (envelope-from asmrookie@gmail.com) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.171]) by mx1.freebsd.org (Postfix) with ESMTP id 8451613C468 for ; Fri, 19 Oct 2007 18:34:37 +0000 (UTC) (envelope-from asmrookie@gmail.com) Received: by ug-out-1314.google.com with SMTP id y2so822466uge for ; Fri, 19 Oct 2007 11:34:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth; bh=wwrDTEYCHOnX8qm7oXBj/7RAD9zB3DYmuzZNVo1DG6w=; b=SJwxcSbUldFfyavGAOOIiU/5Fw5GzL1LWgjRLOh+gooGDT7hO1SPs0Ue788TG1LNsx2iGQVMnCFoNVi/phuvcfjcQ2ZkZfH7QJMhqN2e1GiTum1tZqy18iSIK3cbOedOV7cijJmWv8d7ydzKPa8qeGahsvDQ5TojTfs6s6SR+Aw= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth; b=eYmcAMbhNPpAHCW/cr5V+gqqqmNnhqR/e3MkI7LYu06n1gLuko/8mh2+w9fw1EYolKfsQo0zysGYjXdOjgsJh1KB8m/HSy6JgLxMlBqZDDx4kRw7LWt2tNMezdC18qcJ+AmfFUpb5L8fKBaZlfmqTQi7WercmLVbkPIp6qzFew8= Received: by 10.78.170.6 with SMTP id s6mr1463311hue.1192813707906; Fri, 19 Oct 2007 10:08:27 -0700 (PDT) Received: by 10.78.97.18 with HTTP; Fri, 19 Oct 2007 10:08:27 -0700 (PDT) Message-ID: <3bbf2fe10710191008r6dc1939em85f8574e107af48b@mail.gmail.com> Date: Fri, 19 Oct 2007 19:08:27 +0200 From: "Attilio Rao" Sender: asmrookie@gmail.com To: "John Baldwin" In-Reply-To: <200710190842.34286.jhb@freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <20071016094118.GE5411@hoeg.nl> <200710170916.18788.jhb@freebsd.org> <20071019045654.GF5411@hoeg.nl> <200710190842.34286.jhb@freebsd.org> X-Google-Sender-Auth: 5e7273eb9a32802a Cc: FreeBSD Hackers , Ed Schouten 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 18:34:40 -0000 2007/10/19, John Baldwin : > 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. 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. Attilio -- Peace can only be achieved by understanding - A. Einstein