Date: Tue, 27 Jun 2000 04:29:00 -0500 From: Mike Pritchard <mpp@mppsystems.com> To: Guido van Rooij <guido@gvr.org> Cc: Peter Wemm <peter@netplex.com.au>, current@FreeBSD.ORG Subject: Re: HEADS UP!: config changes... Message-ID: <20000627042900.A22797@mppsystems.com> In-Reply-To: <20000626212537.A51266@gvr.gvr.org>; from guido@gvr.org on Mon, Jun 26, 2000 at 09:25:37PM %2B0200 References: <20000613231829.2F4BF1CD7@overcee.netplex.com.au> <20000624183247.A9232@mppsystems.com> <20000626212537.A51266@gvr.gvr.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Jun 26, 2000 at 09:25:37PM +0200, Guido van Rooij wrote:
>
> How about adding a hint to the hint driver itself. E.g.
>
> SYNOPSIS
> device isa
> device ata
> hint "hintsfile" # see hint(4)
I don't think this is enough. If I botch my hints file enough (and
lets say I fat finger some other files in /usr/src/sys/i386/conf. Been
there, done that, so lets just assume that it will happen to other
people), I should be able to figure out what I need to configure a device
from the on-line man-pages.
How about something like this:
SYNOPSIS
device isa
device ata
hints "hintsfile" # see hints(4)
For ata devices on the isa bus, the hint file must contain: the
bus that the device resides on (isa), the I/O port and IRQ.
For the primary controller, port IO_WD1 and IRQ 14 are used.
For the secondary controller, port IO_WD2 and IRQ 15 are used.
Maybe the descriptive text could be replaced with something like:
See the main text for a description of bus/port/IRQ/flag assignments.
And then the main text would include something similar to what I typed
above.
Then hints(4) could tell the user the syntax they actually have
to use and how to use it. If the syntax changes, then we only have to
update the generic hints(4).
From looking at "NOTES", mostly ISA devices are affected.
ppc/scsi/miibus seem to be the other devices (plus another
oddball or two).
I think as long as we can decide how to provide the needed information
in the device specific man pages, this shouldn't be too hard
to actually sit down and do.
Then someone also has to sit down and write hints(4) to back
it all up :-).
-Mike
--
Mike Pritchard
mpp@FreeBSD.org or mpp@mppsystems.com
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-current" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000627042900.A22797>