Using the WHATADAP.EXE Utility
==============================
                                              CSS 1.0(0), January 1997
                                              ------------------------                       

Introduction
------------

**********************************************************************
NOTE: WHATADAP.EXE does not support the CardBus Adapter.
**********************************************************************


The WHATADAP program interrogates any PCI, EISA, MCA, PCMCIA, or 'Plug 
and Play' adapters that  it  finds  in  a  computer,  and  prints  out 
information about each one. It tells you an adapter's bus type and bus 
identifier  (plus  other information, depending on the type of bus the 
adapter is for).  And you can include these two pieces of  information 
on  the  IFADAP  command  line when you specify the particular adapter 
that IFADAP is to search for. In other words, if you are using  IFADAP 
to  load  drivers  selectively,  then  WHATADAP  gives  you  two  more 
selection  criteria  to  use:  bus  type  (BUS=<bus  type>)  and   bus 
identifier (BID=<an identificatory code number>). 

WHATADAP can detect any PCI, EISA, MCA, PCMCIA, CardBus, or  Plug  and 
Play cards, not just those produced by Madge. You must run the program 
from the DOS command-line or from a batch file. 

The WHATADAP Options
--------------------
The only option supported by WHATADAP.EXE is /? which displays a short 
description of WHATADAP's function. 

When  you  run  WHATADAP.EXE  without  the  /?  option,  it displays a 
one-line description for every adapter card it finds in the  computer.  
The  amount  of detail depends on the adapter's bus type. However, the 
description will always  include  at  least  a  bus  type  and  a  bus 
identifier. 



Information provided by WHATADAP
--------------------------------
The  output that WHATADAP.EXE displays for each adapter depends on the 
adapter's bus type. The general format is as follows,  but  note  that 
the  description  is  not  always  available:  

BUS=<bus type> BID=<bus identifier> [description]

where:

<bus type>  <bus identifier>
----------  ----------------
  MCA        AAAA/B          AAAA is the MCA POS ID data
                             B is a 1 digit MCA slot number

  EISA       AAAA/BBB/CC     AAAA is the EISA manufacturer's code
                             BBB is the product code number
                             CC is the EISA slot number 

  PCI        AAAA/BBBB       AAAA is the Vendor ID number
                             BBBB is the Device ID number

  PNP        AAAA/BBBB/C     AAAA is the manufacturer's code
                             BBBB is the logical device ID
                             C is the Card Select Number

  PCMCIA     AAAA/BBBB/CCCC  AAAA is the manufacturers ID
                             BBBB is the manufacturers info 
                             CCCC is the logical socket number

With some devices (for example, Plug  And  Play  and  PCMCIA  devices) 
WHATADAP.EXE  tries  to  provide the user with descriptive information 
about the adapter. It will, for example, try to make  it  clear  which 
bus  identifier  belongs  to  which adapter. However, its success will 
depend on how closely the manufacturer has followed the  specification 
for making available this type of information. 

Example 1
---------
On a computer with an internal PCI/ISA bus, WHATADAP.EXE reported: 

BUS=PCI BID=8086/122d Class:Bridge Device, Subtype:Host/PCI bridge
BUS=PCI BID=8086/122e Class:Bridge Device, Subtype:PCI/ISA bridge
BUS=PCI BID=8086/1230 Class:Mass Storage, Subtype:IDE controller
BUS=PCI BID=5333/8811 Class:Display Adapter, Subtype:VGA/8514
BUS=PCI BID=10b6/2 Class:Network Adapter, Subtype:Token Ring 
BUS=PNP BID=101/8734/1 Madge Smart 16/4 ISA Clnt. PnP Ringnode
BUS=PNP BID=0/4d24/2 IBM Auto 16/4 Token-Ring ISA Adapter
BUS=PNP BID=9550/6d50/3 3Com 3C509B EtherLink III

Lines 1, 2, and 3 all describe a  multifunction  PCI/ISA  bridge  chip 
with  an  embedded IDE disk controller. 

Line 4 describes the VGA video adapter.

Line  5  describes  the  Madge  Token  Ring  network  adapter.  

Line  6 describes a Plug and Play Madge Ringnode on the ISA bus. 

Line 7 describes an IBM Auto Plug and Play adapter  on  the  ISA  bus.  

Line 8 describes the  motherboard-embedded,  ethernet  Plug  and  Play 
adapter from 3Com. 

Example2
--------

On a portable computer with a PCMCIA socket:

BUS=PCMCIA BID=141/1/0 MADGE SMART 16/4 PCMCIA RINGNODE 

The  description  ("MADGE  SMART  16/4 PCMCIA RINGNODE") of line 1 was 
read from the PCMCIA card's configuration memory. 

Example3
--------

On a Microchannel bus machine:

BUS=MCA BID=74/1
BUS=MCA BID=74/2
BUS=MCA BID=eee7/5

Line 1 describes a Madge MC Ringnode in slot 1. 

Line 2 describes another MC Ringnode in slot 2. 

Line 3 describes an IBM video adapter in slot 5. Note that the MCA bus 
does not provide any extra descriptive information: such detail is not 
part  of  the  MCA  specification. If you are in any doubt about which 
line refers to which card on the MCA bus, then remove and replace  the 
cards  running  WHATADAP.EXE  each time, and noting the information it 
reports.

The extra descriptive data that WHATADAP provides  about  PCMCIA,  PCI 
and  Plug  And  Play buses and adapters is for purposes of information 
only: you cannot use any of as an argument to IFADAP. 

Example of how to use WHATADAP to find out  which  arguments  to  give 
----------------------------------------------------------------------
IFADAP
------

Thiss example concerns a  portable  computer  that  uses  one  of  two 
different  network  cards  depending  on  whether it is in its docking 
station or not.  The user needs to run WHATADAP.EXE twice:  once  with 
the PC in its docking station, and once with it outside of its docking 
station. 

If  the computer displays the following information when it is powered 
up in its docking station:

BUS=PCI BID=8086/122d Class:Bridge Device, Subtype:Host/PCI bridge
BUS=PCI BID=8086/122e Class:Bridge Device, Subtype:PCI/ISA bridge
BUS=PCI BID=8086/1230 Class:Mass Storage, Subtype:IDE controller
BUS=PCI BID=5333/8811 Class:Display Adapter, Subtype:VGA/8514
BUS=PCI BID=10b6/2 Class:Network Adapter, Subtype:Token Ring 

and  it  displays  the  following  information  when  it is powered up 
outside its docking station: 

BUS=PCMCIA BID=141/1/0 MADGE SMART 16/4 PCMCIA RINGNODE 

then the  user  needs  to  put  the  following  lines  into  the  PC's 
CONFIG.SYS: 

IFADAP BUS=PCI BID=10b6/2 DD=<PCI device driver arguments>
IFADAP BUS=PCMCIA BID=141/1/0 DD=<PCMCIA device driver arguments> 

In this way, the correct device driver is loaded for whichever adapter 
the PC is using. 

                *********** End of WHATADAP.TXT ***********