From owner-freebsd-arch@FreeBSD.ORG Sun Aug 29 21:08:11 2004 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4EEDC16A4CE for ; Sun, 29 Aug 2004 21:08:11 +0000 (GMT) Received: from carver.gumbysoft.com (carver.gumbysoft.com [66.220.23.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4076143D55 for ; Sun, 29 Aug 2004 21:08:11 +0000 (GMT) (envelope-from dwhite@gumbysoft.com) Received: by carver.gumbysoft.com (Postfix, from userid 1000) id 2FA7572DD4; Sun, 29 Aug 2004 14:08:11 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by carver.gumbysoft.com (Postfix) with ESMTP id 26F8E72DCB; Sun, 29 Aug 2004 14:08:11 -0700 (PDT) Date: Sun, 29 Aug 2004 14:08:11 -0700 (PDT) From: Doug White To: necro In-Reply-To: <20040828225815.A695@digital-security.org> Message-ID: <20040829135920.T69068@carver.gumbysoft.com> References: <20040828225815.A695@digital-security.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: freebsd-arch@freebsd.org Subject: Re: Documentation X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Aug 2004 21:08:11 -0000 On Sat, 28 Aug 2004, necro wrote: > I was looking around for some type of resource that goes through /sys/kern > and explains what each *.c file there is, lists functions in them, goes > through the functions and explains what the function does / how it does it > and may be lists where these functions are called and for what purpose. > > Is there such a beast? If not, would it help if I tried to write it? > And how fast would it get obsolete? :) I strongly suggest you run, not walk, to your favorite bookseller and buy "The Design & Implementation of the FreeBSD Operating System." It works at a higher level than individual functions and lines of code, but gives fantastic insight into, suprisingly, design and implementation concerns in the current kernel. Pretty much required bookshelf material for any aspiring kernel hacker. That being said -- if you can write such detailed documentation, then you probably deserve a case of beer and a commit bit since you'll know more about the system than most people :) -- Doug White | FreeBSD: The Power to Serve dwhite@gumbysoft.com | www.FreeBSD.org