.\" Copyright (c) 1996, 1997 Peter Fox .\" This program is distributed according to the Gnu General Public License. .\" See the file COPYING in the isapnptools source distribution. .\" .\" $Id: pnpdump.8,v 0.2 1997/07/14 22:34:11 fox Exp $ .\" .TH PNPDUMP 8 "14 Jul 1997" "isapnptools" .SH NAME pnpdump \- Dump ISA Plug-And-Play devices resource information .SH SYNOPSIS \fBpnpdump\fP [ [ \fIdevs\fP ] \fIreadport\fP ] .SH DESCRIPTION \fBpnpdump\fP will scan all the ISA PnP cards, dumping their resource data to \fIstdout\fP. The output is in a form that can be used by \fBisapnp\fP, except that the actual configuration statements are commented out. See \fBisapnp.conf(5)\fP for details of the format. By default, \fBpnpdump\fP will reset all the cards into the inactive state, then ISOLATE each one and allocate it a handle (Card Select Number). This process will include trying different \fIreadport\fP addresses until a suitable one is found avoiding conflicts with other hardware. If a single parameter is provided, this will be used as the minimum \fIreadport\fP address to start scanning. This may be chosen to avoid an unfortunate conflict. Resetting the cards may be undesireable, in which case both additional parameters may be supplied: .SS Parameters .TP \fIdevs\fP is the \fInumber of PnP cards\fP that the BIOS has found, ISOLATEd and allocated CSNs to in the system. Note that if this is greater than the actual number of cards in the system, pnpdump will stop scanning when it receives a first serial identifier byte of 0xff (this is what happens when there isn't a card with that CSN). If this parameter is provided, then \fBpnpdump\fP will not ISOLATE each card and assign CSNs, however, the \fIreadport\fP provided must be the same as the one the BIOS used. This could be difficult to determine if it is not assigned via a BIOS setup screen. .TP \fIreadport\fP is the address of the \fIreadport\fP to use for the Plug-And-Play access. The number base is determined by the format: a leading \fI0x\fP implies hex, a leading \fI0\fP implies octal, otherwise decimal is assumed. The address of the \fIreadport\fP must be chosen to avoid any conflicts with existing (non Plug and Play) hardware, and must be in the range 0x203..0x3ff. If the \fIreadport\fP is specified without \fIdevs\fP, then this is the minimum \fIreadport\fP to use when scanning for a suitable one. .PP Note that for the two parameter option to work, you must have a PnP BIOS which has already carried out the ISOLATION process correctly, and you must know what \fIreadport\fP address the BIOS used. .SH FILES .TP \fC/sbin/pnpdump\fR The executable. .TP \fC/etc/isapnp.conf\fR The resting place of the editted output. .SH BUGS None known about. If you think you have found one, please send a report to isapnp@roestock.demon.co.uk. .SH WARNING This program can reset all your Plug-and-Play devices. Use at your own risk. .SH AUTHOR \fBpnpdump\fP has been written by Peter Fox , the creator and maintainer of isapnptools. .SH AVAILABILITY The latest version of the sources may be obtained by ftp from ftp://ftp.demon.co.uk/pub/unix/linux/utils .br Or follow the pointer from my web page at http://www.roestock.demon.co.uk/isapnptools/ .SH REFERENCES Plug and Play ISA Specification, Version 1.0a, May 5, 1994. Available from ftp://ftp.microsoft.com/developer/drg/Plug-and-Play/Pnpspecs .SH "SEE ALSO" isapnp(8), isapnp.conf(5)