DUMMY_CS(4)                                           DUMMY_CS(4)

NAME
       dummy_cs - PCMCIA dummy device driver

SYNOPSIS
       insmod dummy_cs.o [pc_debug=n] [irq_list=i,j,...]

DESCRIPTION
       The dummy_cs module has two purposes.  It is intended as a
       demonstration of how to write the  PCMCIA  interface  code
       for  a  client driver, and the source code is heavily com-
       mented.  It is also written  to  function  as  a  sort  of
       generic  ``point  enabler'':  when  bound to any PCMCIA IO
       card, it will read the  card's  Configuration  Information
       Structure, and configure the card appropriately.  The con-
       figuration includes setting up IO and memory windows, con-
       figuring  the  card  for  interrupts, and initializing the
       card's PCMCIA configuration registers.

       It turns out that many cards report incomplete or  inaccu-
       rate configuration information, due to vendor carelessness
       and the complexity of the data format.   A  vendor  driver
       can generally take for granted many configuration details,
       so there is not much incentive for vendors to ensure  that
       the  on-card  information is complete.  Thus, the dummy_cs
       module is limited by its generality:  since  it  makes  no
       assumptions  about card types, it is forced to rely on the
       card information, for better or worse.

PARAMETERS
       pc_debug=n
              Selects the PCMCIA debugging level.  This parameter
              is  only  available  if the module is compiled with
              debugging enabled.  A non-zero value enables debug-
              ging.

       irq_list=i,j,...
              Specifies  the  set of interrupts that may be allo-
              cated by this driver.

AUTHOR
       David Hinds - dhinds@hyper.stanford.edu

SEE ALSO
       cardmgr(8), pcmcia(5).

pcmcia-cs              1999/02/08 08:02:00                      1