git: 5b9fba1cb0d8 - main - Retire pccard(4)

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Wed, 12 Nov 2025 17:09:28 UTC
The branch main has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=5b9fba1cb0d84ee297908ec4d575c33cf1f68ad5

commit 5b9fba1cb0d84ee297908ec4d575c33cf1f68ad5
Author:     Muhammad Moinur Rahman <bofh@FreeBSD.org>
AuthorDate: 2025-11-12 17:01:18 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2025-11-12 17:09:09 +0000

    Retire pccard(4)
    
    pccard has been declared obsolete for a long time and also the
    support has been removed but the man page still exists. It mentions
    being scheduled to be removed before 13.0 but it still exists in the
    tree.
    
    [Extracted from review D53434]
    
    Reviewed by: emaste
    Fixes: 31b35400c ("pccard: Remove more of the PC Card infrastructure")
---
 ObsoleteFiles.inc                   |  3 ++
 share/man/man4/Makefile             |  1 -
 share/man/man4/cardbus.4            |  1 -
 share/man/man4/pccard.4             | 78 -------------------------------------
 share/man/man4/pccbb.4              |  3 +-
 share/man/man4/xl.4                 |  1 -
 share/man/man9/DEVICE_DETACH.9      |  5 +--
 share/man/man9/bus_alloc_resource.9 |  5 ---
 usr.sbin/dumpcis/dumpcis.8          |  3 +-
 9 files changed, 6 insertions(+), 94 deletions(-)

diff --git a/ObsoleteFiles.inc b/ObsoleteFiles.inc
index e415c2c5f9fe..ad3d1fe955e3 100644
--- a/ObsoleteFiles.inc
+++ b/ObsoleteFiles.inc
@@ -51,6 +51,9 @@
 #   xargs -n1 | sort | uniq -d;
 # done
 
+# 20251112: Remove pccard(4)
+OLD_FILES+=share/man/man4/pccard.4
+
 # 20251028: Remove hifn(4)
 OLD_FILES+=share/man/man4/hifn.4
 
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 31e3d67e93eb..3b64af5fd898 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -459,7 +459,6 @@ MAN=	aac.4 \
 	p9fs.4 \
 	pass.4 \
 	pca954x.4 \
-	pccard.4 \
 	pccbb.4 \
 	pcf.4 \
 	pcf8574.4 \
diff --git a/share/man/man4/cardbus.4 b/share/man/man4/cardbus.4
index 3b422b44c464..fa4bce65e095 100644
--- a/share/man/man4/cardbus.4
+++ b/share/man/man4/cardbus.4
@@ -52,5 +52,4 @@ 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
deleted file mode 100644
index cec07b2336cb..000000000000
--- a/share/man/man4/pccard.4
+++ /dev/null
@@ -1,78 +0,0 @@
-.\"
-.\" Copyright (c) 2002 M. Warner Losh <imp@FreeBSD.org>
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. The name of the author may not be used to endorse or promote products
-.\"    derived from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.Dd August 18, 2020
-.Dt PCCARD 4
-.Os
-.Sh NAME
-.Nm pccard
-.Nd PC Card bus driver
-.Sh SYNOPSIS
-.Cd device pccard
-.Sh DEPRECATION NOTICE
-This driver is scheduled for removal prior to the release of
-.Fx 13.0 .
-.Sh DESCRIPTION
-The
-.Nm
-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 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 3200e8b2d2e2..1c6cb2045033 100644
--- a/share/man/man4/pccbb.4
+++ b/share/man/man4/pccbb.4
@@ -176,5 +176,4 @@ debugging problems with the bridge chipset.
 .El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
-.Xr exca 4 ,
-.Xr pccard 4
+.Xr exca 4
diff --git a/share/man/man4/xl.4 b/share/man/man4/xl.4
index 309434154f4e..591703ac93cb 100644
--- a/share/man/man4/xl.4
+++ b/share/man/man4/xl.4
@@ -253,7 +253,6 @@ It is probably safe to ignore them.
 .Xr miibus 4 ,
 .Xr netintro 4 ,
 .Xr ng_ether 4 ,
-.Xr pccard 4 ,
 .Xr polling 4 ,
 .Xr ifconfig 8
 .Sh HISTORY
diff --git a/share/man/man9/DEVICE_DETACH.9 b/share/man/man9/DEVICE_DETACH.9
index 5f1bf7a3295f..856c6138ed4c 100644
--- a/share/man/man9/DEVICE_DETACH.9
+++ b/share/man/man9/DEVICE_DETACH.9
@@ -41,9 +41,7 @@
 Detach a device.
 This can be called if the user is replacing the
 driver software or if a device is about to be physically removed from
-the system (e.g.\& for
-.Xr pccard 4
-devices).
+the system.
 .Pp
 The method should deallocate any system resources allocated during the
 .Xr DEVICE_ATTACH 9
@@ -52,7 +50,6 @@ etc.)
 .Sh RETURN VALUES
 Zero is returned on success, otherwise an appropriate error is returned.
 .Sh SEE ALSO
-.Xr pccard 4 ,
 .Xr device 9 ,
 .Xr DEVICE_ATTACH 9 ,
 .Xr DEVICE_IDENTIFY 9 ,
diff --git a/share/man/man9/bus_alloc_resource.9 b/share/man/man9/bus_alloc_resource.9
index 5d309229a34e..210abb3074e1 100644
--- a/share/man/man9/bus_alloc_resource.9
+++ b/share/man/man9/bus_alloc_resource.9
@@ -157,11 +157,6 @@ resource permits contemporaneous sharing.
 It should always be set unless you know that the resource cannot be shared.
 It is the bus driver's task to filter out the flag if the bus does not
 support sharing.
-For example,
-.Xr pccard 4
-cannot share IRQs while
-.Xr cardbus 4
-can.
 .It Dv RF_UNMAPPED
 do not establish implicit mapping when activated via
 .Xr bus_activate_resource 9 .
diff --git a/usr.sbin/dumpcis/dumpcis.8 b/usr.sbin/dumpcis/dumpcis.8
index c40e5fe75d40..9da5ed9f3bdf 100644
--- a/usr.sbin/dumpcis/dumpcis.8
+++ b/usr.sbin/dumpcis/dumpcis.8
@@ -38,8 +38,7 @@ The
 utility translates a raw CIS stream into human readable form.
 .Sh SEE ALSO
 .Xr cardbus 4 ,
-.Xr cbb 4 ,
-.Xr pccard 4
+.Xr cbb 4
 .Sh AUTHORS
 The original version was written by
 .An Warner Losh Aq Mt imp@FreeBSD.org .