xref: /freebsd/share/man/man4/pccard.4 (revision 2e3f49888ec8851bafb22011533217487764fdb0)
1.\"
2.\" Copyright (c) 2002 M. Warner Losh <imp@FreeBSD.org>
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. The name of the author may not be used to endorse or promote products
10.\"    derived from this software without specific prior written permission.
11.\"
12.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
13.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22.\" SUCH DAMAGE.
23.\"
24.Dd August 18, 2020
25.Dt PCCARD 4
26.Os
27.Sh NAME
28.Nm pccard
29.Nd PC Card bus driver
30.Sh SYNOPSIS
31.Cd device pccard
32.Sh DEPRECATION NOTICE
33This driver is scheduled for removal prior to the release of
34.Fx 13.0 .
35.Sh DESCRIPTION
36The
37.Nm
38driver implements the PC Card bus.
39The
40.Nm
41driver supports all PC Card bridges in the system.
42.Sh TUNABLES
43The driver supports the following tunable parameters, which may be
44added to
45.Pa /boot/loader.conf
46or set via the
47.Xr sysctl 8
48command:
49.Bl -tag -width ".Cm hw.pccard.cis_debug" -compact
50.It Cm hw.pccard.debug
51Non-zero values cause more verbose information to be printed when a
5216-bit PC Card is inserted or removed.
53.It Cm hw.pccard.cis_debug
54Non-zero value causes the CIS parsing of the 16-bit PC Card to be much
55more verbose and include a complete CIS dump.
56.El
57.Sh FILES
58.Bl -tag -width ".Pa /dev/pccard0.cis" -compact
59.It Pa /dev/pccard0.cis
60This exclusive-use device will report all the CIS chains present in a
61PC Card, if a 16-bit PC Card is inserted in the slot.
62Only one user at a time may access the CIS.
63The CIS is presented as the relevant byte stream from the PC Card.
64For CIS tuples in Attribute Memory (the default), only the even
65locations are presented (the ODD locations are undefined per the
66standard).
67For CIS tuples in Common Memory, every byte is presented to the user.
68Decoding of the CIS tuples is done via a userland program.
69All tuples are presented to the user.
70.El
71.Sh SEE ALSO
72.Xr cardbus 4 ,
73.\" .Xr mecia 4 ,
74.Xr pccbb 4
75.\" .Xr tcic 4
76.Rs
77.%T "PC Card Standard, Release 8"
78.Re
79