xref: /freebsd/share/man/man4/pccard.4 (revision 9768746b)
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.\" $FreeBSD$
25.\"
26.Dd August 18, 2020
27.Dt PCCARD 4
28.Os
29.Sh NAME
30.Nm pccard
31.Nd PC Card bus driver
32.Sh SYNOPSIS
33.Cd device pccard
34.Sh DEPRECATION NOTICE
35This driver is scheduled for removal prior to the release of
36.Fx 13.0 .
37.Sh DESCRIPTION
38The
39.Nm
40driver implements the PC Card bus.
41The
42.Nm
43driver supports all PC Card bridges in the system.
44.Sh TUNABLES
45The driver supports the following tunable parameters, which may be
46added to
47.Pa /boot/loader.conf
48or set via the
49.Xr sysctl 8
50command:
51.Bl -tag -width ".Cm hw.pccard.cis_debug" -compact
52.It Cm hw.pccard.debug
53Non-zero values cause more verbose information to be printed when a
5416-bit PC Card is inserted or removed.
55.It Cm hw.pccard.cis_debug
56Non-zero value causes the CIS parsing of the 16-bit PC Card to be much
57more verbose and include a complete CIS dump.
58.El
59.Sh FILES
60.Bl -tag -width ".Pa /dev/pccard0.cis" -compact
61.It Pa /dev/pccard0.cis
62This exclusive-use device will report all the CIS chains present in a
63PC Card, if a 16-bit PC Card is inserted in the slot.
64Only one user at a time may access the CIS.
65The CIS is presented as the relevant byte stream from the PC Card.
66For CIS tuples in Attribute Memory (the default), only the even
67locations are presented (the ODD locations are undefined per the
68standard).
69For CIS tuples in Common Memory, every byte is presented to the user.
70Decoding of the CIS tuples is done via a userland program.
71All tuples are presented to the user.
72.El
73.Sh SEE ALSO
74.Xr cardbus 4 ,
75.\" .Xr mecia 4 ,
76.Xr pccbb 4
77.\" .Xr tcic 4
78.Rs
79.%T "PC Card Standard, Release 8"
80.Re
81