From owner-freebsd-hackers Sat Nov 30 22:28:55 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 61B1237B401; Sat, 30 Nov 2002 22:28:54 -0800 (PST) Received: from pintail.mail.pas.earthlink.net (pintail.mail.pas.earthlink.net [207.217.120.122]) by mx1.FreeBSD.org (Postfix) with ESMTP id F351543ED1; Sat, 30 Nov 2002 22:28:53 -0800 (PST) (envelope-from tlambert2@mindspring.com) Received: from pool0190.cvx22-bradley.dialup.earthlink.net ([209.179.198.190] helo=mindspring.com) by pintail.mail.pas.earthlink.net with esmtp (Exim 3.33 #1) id 18INav-0006E3-00; Sat, 30 Nov 2002 22:28:45 -0800 Message-ID: <3DE9ABCF.80AAAC2F@mindspring.com> Date: Sat, 30 Nov 2002 22:27:27 -0800 From: Terry Lambert X-Mailer: Mozilla 4.79 [en] (Win98; U) X-Accept-Language: en MIME-Version: 1.0 To: Robert Watson Cc: Yury Tarasievich , freebsd-hackers@freebsd.org Subject: Re: documentation on kernel locks, mutexes? References: Content-Type: text/plain; charset=us-ascii 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 Robert Watson wrote: > On Mon, 25 Nov 2002, Terry Lambert wrote: > > Yury Tarasievich wrote: > > > I need to port some driver from linux to freebsd and, somehow, > > > I can't find documentation on kernel locks and mutexes. > > > There are no man pages, links from handbook are broken, and search on > > > freebsd site gives nothing (besides the handbook itself). > > > > > > Where can I find some docs? > > > > Kernel documentation is poor, because interfaces are not as fixed in > > stone as you might expect them to be to encourage third party > > developement and porting efforts like yours. > > Funny, the SMPng primitives seem in general to be fairly well documented. > See my previous e-mail to Yury with a list of man page references. It's > certainly true that the source is a good reference to look at existing > locking strategies, but there certainly do appear to be man pages for the > locking primitives. 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. 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. His points about the handbook are salient, too. -- Terry To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message