From owner-freebsd-new-bus  Wed Jan 26  0:40:54 2000
Delivered-To: freebsd-new-bus@freebsd.org
Received: from smtp03.wxs.nl (smtp03.wxs.nl [195.121.6.37])
	by hub.freebsd.org (Postfix) with ESMTP id 3F4E115167
	for <new-bus@freebsd.org>; Wed, 26 Jan 2000 00:40:51 -0800 (PST)
	(envelope-from asmodai@wxs.nl)
Received: from daemon.ninth-circle.org ([195.121.196.103]) by smtp03.wxs.nl
          (Netscape Messaging Server 3.61)  with ESMTP id AAA649C
          for <new-bus@freebsd.org>; Wed, 26 Jan 2000 09:40:45 +0100
Received: (from asmodai@localhost)
	by daemon.ninth-circle.org (8.9.3/8.9.3) id JAA09497
	for new-bus@freebsd.org; Wed, 26 Jan 2000 09:40:20 +0100 (CET)
	(envelope-from asmodai)
Date: Wed, 26 Jan 2000 09:40:20 +0100
From: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl>
To: new-bus@freebsd.org
Subject: newbus from a documentation view
Message-ID: <20000126094020.G290@daemon.ninth-circle.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
Organisation: Ninth-Circle Enterprises
Sender: owner-freebsd-new-bus@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.ORG

Hi guys,

most of you know I am working on the documentation for newbus/busspace
and consequently device drivers.  (Heaven knows how Bill Paul,
Poul-Henning, Peter and Matthew already have grey hairs by now *g*.)

What I haven't been able to define is a discription for newbus.  Sure,
it is the new bus structure, but how is it best to be described?

``As a system that allows for a very structured device and bus
architecture by means of interconnecting busses and devices in a logical
way.''

Also, did I miss important files functions in this list:

machine/bus.h <which maps to sys/alpha/include/bus.h or
	sys/i386/include/bus.h depending on which hardware we run)

machine/bus_memio.h <also in alpha and i386 version>
	I see that this one is basically an empty header, deprecated in
	usage?

machine/bus_pio.h <also in alpha and i386 version>
	I see that this one is also an empty header, also deprecated in
	usage?

machine/resource.h <alpha/i386>

sys/bus.h <machine independant>

sys/bus_private.h <machine independant>

sys/module.h <machine independant>

The function houdeholding is for later today. =)

-- 
Jeroen Ruigrok vd W/Asmodai         asmodai@[wxs.nl|bart.nl|freebsd.org]
Documentation nutter/B-rated Coder BSD: Technical excellence at its best  
The BSD Programmer's Documentation Project <http://home.wxs.nl/~asmodai>
How the gods kill...


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-new-bus" in the body of the message