From owner-freebsd-hackers Sun Dec 1 6:37:42 2002 Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AE84237B401; Sun, 1 Dec 2002 06:37:40 -0800 (PST) Received: from angelica.unixdaemons.com (angelica.unixdaemons.com [209.148.64.135]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5703F43EBE; Sun, 1 Dec 2002 06:37:39 -0800 (PST) (envelope-from hiten@unixdaemons.com) Received: from unixdaemons.com (pc3-nfds1-5-cust242.nott-b.cable.ntl.com [80.5.196.242]) (authenticated bits=0) by angelica.unixdaemons.com (8.12.5/8.12.1) with ESMTP id gB1EbTSu081984; Sun, 1 Dec 2002 09:37:30 -0500 (EST) X-Authentication-Warning: angelica.unixdaemons.com: Host pc3-nfds1-5-cust242.nott-b.cable.ntl.com [80.5.196.242] claimed to be unixdaemons.com Message-ID: <3DEA1E80.9060305@unixdaemons.com> Date: Sun, 01 Dec 2002 14:36:48 +0000 From: Hiten Pandya Reply-To: hiten@angelica.unixdaemons.com User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0.1) Gecko/20020823 Netscape/7.0 X-Accept-Language: en-us, en MIME-Version: 1.0 To: Terry Lambert , Robert Watson Cc: Yury Tarasievich , freebsd-hackers@freebsd.org Subject: Re: documentation on kernel locks, mutexes? Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --- Terry Lambert wrote: > I was thinking more in terms of device driver information. All > of the "how to write a driver for newbus", "how to write a CAM > driver", "how to use devfs from the kernel", "what XXX to do in > FreeBSD, given YYY in Linux", "how to port a driver from Linux > to FreeBSD", etc., are missing. Well, there is a chapter, that gives a good introduction to newbus in the Developers Handbook. IMHO, it gives enough pointers to the reader, so he can begin his journey on Newbus Avenue. I will continue documenting it, as I learn more. Once my exams are over, I will start looking into how ACPI affects Newbus etc, and things like that. We lack information on bus_space(9) and bus_dma(9), the latter one is mostly finished, and I will resume on it, as time permits. URL: http://www.FreeBSD.ORG/doc/en/books/developers-handbook/newbus.html on -CURRENT: # apropos 9 | less Indicates that we have a good deal of manual pages, which document kernel interfaces. Its just a matter of someone putting their time in documenting it for the Developers-Handbook. Thanks to Doug Rabson for the excellent set of VFS manual pages and many others! FWIW, there is a doc, somewhere on the net, in which R. Watson has documented the VOP table, which is better than nothing. Regarding "what XXX to do in FreeBSD, given YYY in Linux", is quite a difficult topic to cover, because, documenting each opposite will take us centuries. Although, documenting FreeBSD<->Linux VFS is one of the simple things. No comment on your last one. :-) > While it's true that kernel locks and mutexes are documented for > SMPng, he posted to -hackers, not -current, and so he's probably > not interested in -current primitives that aren't available in > the 4.x -RELEASE and -STABLE branches. Erm. IIRC, there is documentation lockmgr(), lockinit(), lockdestroy() etc. in -STABLE. Also, make sure you read the paper, available at the following URL: http://www.lemis.com/~grog/SMPng/ -- Hiten hiten@unixdaemons.com, hiten@uk.FreeBSD.org, hiten@softweyr.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message