xref: /freebsd/share/man/man4/pccard.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
103fd39aaSWarner Losh.\"
2f86e6000SWarner Losh.\" Copyright (c) 2002 M. Warner Losh <imp@FreeBSD.org>
303fd39aaSWarner Losh.\"
403fd39aaSWarner Losh.\" Redistribution and use in source and binary forms, with or without
503fd39aaSWarner Losh.\" modification, are permitted provided that the following conditions
603fd39aaSWarner Losh.\" are met:
703fd39aaSWarner Losh.\" 1. Redistributions of source code must retain the above copyright
803fd39aaSWarner Losh.\"    notice, this list of conditions and the following disclaimer.
903fd39aaSWarner Losh.\" 2. The name of the author may not be used to endorse or promote products
1003fd39aaSWarner Losh.\"    derived from this software without specific prior written permission.
1103fd39aaSWarner Losh.\"
1203fd39aaSWarner Losh.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1303fd39aaSWarner Losh.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1403fd39aaSWarner Losh.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1503fd39aaSWarner Losh.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1603fd39aaSWarner Losh.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1703fd39aaSWarner Losh.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
1803fd39aaSWarner Losh.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1903fd39aaSWarner Losh.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2003fd39aaSWarner Losh.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2103fd39aaSWarner Losh.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2203fd39aaSWarner Losh.\" SUCH DAMAGE.
2303fd39aaSWarner Losh.\"
24c9234752SWarner Losh.Dd August 18, 2020
2503fd39aaSWarner Losh.Dt PCCARD 4
2603fd39aaSWarner Losh.Os
2703fd39aaSWarner Losh.Sh NAME
2803fd39aaSWarner Losh.Nm pccard
2943d16a0eSWarner Losh.Nd PC Card bus driver
3003fd39aaSWarner Losh.Sh SYNOPSIS
3103fd39aaSWarner Losh.Cd device pccard
32c9234752SWarner Losh.Sh DEPRECATION NOTICE
33c9234752SWarner LoshThis driver is scheduled for removal prior to the release of
34*e0d14216SWarner Losh.Fx 13.0 .
3503fd39aaSWarner Losh.Sh DESCRIPTION
3603fd39aaSWarner LoshThe
3703fd39aaSWarner Losh.Nm
3803fd39aaSWarner Loshdriver implements the PC Card bus.
3903fd39aaSWarner LoshThe
4003fd39aaSWarner Losh.Nm
4143d16a0eSWarner Loshdriver supports all PC Card bridges in the system.
42c6babc37SWarner Losh.Sh TUNABLES
43c6babc37SWarner LoshThe driver supports the following tunable parameters, which may be
44c6babc37SWarner Loshadded to
45c6babc37SWarner Losh.Pa /boot/loader.conf
46c6babc37SWarner Loshor set via the
47c6babc37SWarner Losh.Xr sysctl 8
48c6babc37SWarner Loshcommand:
49c6babc37SWarner Losh.Bl -tag -width ".Cm hw.pccard.cis_debug" -compact
50c6babc37SWarner Losh.It Cm hw.pccard.debug
51c6babc37SWarner LoshNon-zero values cause more verbose information to be printed when a
52c6babc37SWarner Losh16-bit PC Card is inserted or removed.
53c6babc37SWarner Losh.It Cm hw.pccard.cis_debug
54c6babc37SWarner LoshNon-zero value causes the CIS parsing of the 16-bit PC Card to be much
55c6babc37SWarner Loshmore verbose and include a complete CIS dump.
56c6babc37SWarner Losh.El
57c6babc37SWarner Losh.Sh FILES
58c6babc37SWarner Losh.Bl -tag -width ".Pa /dev/pccard0.cis" -compact
59c6babc37SWarner Losh.It Pa /dev/pccard0.cis
60c6babc37SWarner LoshThis exclusive-use device will report all the CIS chains present in a
61c6babc37SWarner LoshPC Card, if a 16-bit PC Card is inserted in the slot.
62c6babc37SWarner LoshOnly one user at a time may access the CIS.
63c6babc37SWarner LoshThe CIS is presented as the relevant byte stream from the PC Card.
64c6babc37SWarner LoshFor CIS tuples in Attribute Memory (the default), only the even
65c6babc37SWarner Loshlocations are presented (the ODD locations are undefined per the
66c6babc37SWarner Loshstandard).
67c6babc37SWarner LoshFor CIS tuples in Common Memory, every byte is presented to the user.
68c6babc37SWarner LoshDecoding of the CIS tuples is done via a userland program.
69c6babc37SWarner LoshAll tuples are presented to the user.
70c6babc37SWarner Losh.El
7103fd39aaSWarner Losh.Sh SEE ALSO
7203fd39aaSWarner Losh.Xr cardbus 4 ,
7303fd39aaSWarner Losh.\" .Xr mecia 4 ,
74c6babc37SWarner Losh.Xr pccbb 4
75f17c7afdSRuslan Ermilov.\" .Xr tcic 4
76c6babc37SWarner Losh.Rs
77c6babc37SWarner Losh.%T "PC Card Standard, Release 8"
78c6babc37SWarner Losh.Re
79