DragonFly BSD
DragonFly kernel List (threaded) for 2004-03
[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]

Re: manpages refer to source-code file?

To: Matthew Dillon <dillon@xxxxxxxxxxxxxxxxxxxx>
From: Hiten Pandya <hmp@xxxxxxxxxxxxx>
Date: Wed, 17 Mar 2004 23:38:11 +0000

Matthew Dillon wrote:
:i have been digging through newbus.. and wanted to know more, how it works
:(for educational purpose).
:so, i wanted to know where to find what i want.
:(sys/kern/subr_bus.c, for those interested and who didn't knew)
:do you think a section SOURCE, where the source files in the kernel (or in
:libc for that reason) are, is a good idea?
:i understand, that everyone working on this, should know how to search
:(ctags and such), but it might still be nice to have that in the manpages.

    For man pages regarding kernel functions, specifying the source file
    is probably a good idea.  But, unfortunately, these man pages tend to
    be mostly out of date so the usefullness would be limited.

    Learning how newbus works is a pretty big bite.  I can barely figure it
    out myself, mainly because since everything is so disconnected its
    hard to figure out the chain of command.

Basically there is an API specification for various layers within
newbus, with default function assignments (the .m files you see lying
around), and individual busses/devices declare a subset of functions that they support, with any unspecified elements being automatically
initialized to the default.

[ not a directly reply, but as a followup... ]

For a start, look at the arch-handbook chapter that I and
Jeroen wrote quite some time ago.  Inorder to understand
the fundamentals of Newbus, you need to understand the KObj

I would like to point to: (Newbus tutorial)

and a chapter on Kernel Objects (KObj):

Another hint, that the newbus framework gets pretty easy to understand
if you think in terms of Object Orientation.  Things can be overridden,
new interfaces attached etc etc.

If you have more questions, do not hesitate to ask.

Hope that helps,

	Hiten Pandya
	hmp@xxxxxxxxxxxxx || hmp@xxxxxxxxxxx

[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]