Dcoument typical debugging options, plus the new CIS device for pccard.

3 files changed, 60 insertions, 2 deletions

diff --git a/share/man/man4/cardbus.4 b/share/man/man4/cardbus.4
index b1b810f..04b3e23 100644
--- a/share/man/man4/cardbus.4
+++ b/share/man/man4/cardbus.4
@@ -39,6 +39,21 @@ driver implements the CardBus bus.
 The
 .Nm
 driver supports all cardbus bridges in the system.
+.Sh TUNABLES
+The driver supports the following tunable parameters, which may be
+added to 
+.Pa /boot/loader.conf
+or set via the
+.Xr sysctl 8
+command:
+.Bl -tag -width ".Cm hw.cardbus.cis_debug" -compact
+.It Cm hw.cardbus.debug
+Non-zero values cause more verbose information to be printed when a
+32-bit CardBus card is inserted or removed.
+.It Cm hw.cardbus.cis_debug
+Non-zero value causes the CIS parsing of the 32-bit CardBus card to be
+much more verbose and include a complete CIS dump.
+.El
 .Sh SEE ALSO
 .Xr pccard 4 ,
 .Xr pccbb 4
diff --git a/share/man/man4/pccard.4 b/share/man/man4/pccard.4
index 01c242e..1fb6ce0 100644
--- a/share/man/man4/pccard.4
+++ b/share/man/man4/pccard.4
@@ -39,9 +39,40 @@ driver implements the PC Card bus.
 The
 .Nm
 driver supports all PC Card bridges in the system.
+.Sh TUNABLES
+The driver supports the following tunable parameters, which may be
+added to 
+.Pa /boot/loader.conf
+or set via the
+.Xr sysctl 8
+command:
+.Bl -tag -width ".Cm hw.pccard.cis_debug" -compact
+.It Cm hw.pccard.debug
+Non-zero values cause more verbose information to be printed when a
+16-bit PC Card is inserted or removed.
+.It Cm hw.pccard.cis_debug
+Non-zero value causes the CIS parsing of the 16-bit PC Card to be much
+more verbose and include a complete CIS dump.
+.El
+.Sh FILES
+.Bl -tag -width ".Pa /dev/pccard0.cis" -compact
+.It Pa /dev/pccard0.cis
+This exclusive-use device will report all the CIS chains present in a
+PC Card, if a 16-bit PC Card is inserted in the slot.
+Only one user at a time may access the CIS.
+The CIS is presented as the relevant byte stream from the PC Card.
+For CIS tuples in Attribute Memory (the default), only the even
+locations are presented (the ODD locations are undefined per the
+standard).
+For CIS tuples in Common Memory, every byte is presented to the user.
+Decoding of the CIS tuples is done via a userland program.
+All tuples are presented to the user.
+.El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
 .\" .Xr mecia 4 ,
-.Xr pccbb 4 ,
-.Xr pcic 4
+.Xr pccbb 4
 .\" .Xr tcic 4
+.Rs
+.%T "PC Card Standard, Release 8"
+.Re
diff --git a/share/man/man4/pccbb.4 b/share/man/man4/pccbb.4
index d256e92..f39546a 100644
--- a/share/man/man4/pccbb.4
+++ b/share/man/man4/pccbb.4
@@ -164,6 +164,18 @@ Toshiba ToPIC97
 .It
 Toshiba ToPIC100
 .El
+.Sh TUNABLES
+The driver supports the following tunable parameters, which may be
+added to 
+.Pa /boot/loader.conf
+or set via the
+.Xr sysctl 8
+command:
+.Bl -tag -width ".Cm hw.cbb.debug" -compact
+.It Cm hw.cbb.debug
+Non-zero values cause more verbose information to be printed to aid in
+debugging problems with the bridge chipset.
+.El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
 .Xr pccard 4