unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-3.1)
Page:
Section:
Apropos / Subsearch:
optional field

DUMMY_CS(4)                Kernel Interfaces Manual                DUMMY_CS(4)



NAME
       dummy_cs - PCMCIA dummy device driver

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

DESCRIPTION
       The  dummy_cs  module has two purposes.  It is intended as a demonstra-
       tion of how to write the PCMCIA interface code for a client driver, and
       the  source  code is heavily commented.  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 configuration  includes  setting
       up IO and memory windows, configuring the card for interrupts, and ini-
       tializing the card's PCMCIA configuration registers.

       It turns out that many cards report incomplete or inaccurate configura-
       tion  information, due to vendor carelessness and the complexity of the
       data format.  A vendor driver can generally take for granted many  con-
       figuration  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 debugging.

       free_ports=n
              A  flag indicating if the IO ports allocated for the card should
              be freed from the kernel resource maps.  This is useful  if  the
              dummy  driver  is  being used to configure a card in preparation
              for loading a specific PCMCIA-unaware driver.  The default is  0
              (false).

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

WARNING
       This man page describes the standalone PCMCIA drivers provided  by  the
       pcmcia-cs source, not the PCMCIA kernel driver support that is included
       in the 2.4 (and later) linux kernel.  While the kernel PCMCIA code  has
       the  same  functionality  as  the  driver side of the standalone PCMCIA
       package, there are some important differences.  Therefore, some or  all
       of this documentation might not apply to the kernel drivers.

AUTHOR
       David Hinds - dahindsATusers.net

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



pcmcia-cs                     2000/06/12 21:24:47                  DUMMY_CS(4)