git: e39ec8933be4 - main - Add deprecation notices to ISA sound cards

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Sat, 19 Mar 2022 19:07:03 UTC
The branch main has been updated by emaste:

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

commit e39ec8933be4d6e74cfb32680fb3e67469e66bb7
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2022-03-18 15:50:23 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2022-03-19 18:57:26 +0000

    Add deprecation notices to ISA sound cards
    
    ISA sound cards (and ISA itself) are long obsolete.  NYCBUG dmesgd has
    no entries for any of these devices after 2005.
    
    Add deprecation notices to device attach routines and man pages for:
    
    snd_ad1816  Analog Devices AD1816 SoundPort
    snd_ess     Ensoniq ESS
    snd_gusc    Gravis UltraSound
    snd_mss     Microsoft Sound System
    snd_sbc     Creative Sound Blaster
    
    Reviewed by:    cy, mav
    MFC after:      3 days
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D34604
---
 share/man/man4/snd_ad1816.4 | 5 ++++-
 share/man/man4/snd_ess.4    | 5 ++++-
 share/man/man4/snd_gusc.4   | 5 ++++-
 share/man/man4/snd_mss.4    | 5 ++++-
 share/man/man4/snd_sbc.4    | 5 ++++-
 sys/dev/sound/isa/ad1816.c  | 1 +
 sys/dev/sound/isa/ess.c     | 1 +
 sys/dev/sound/isa/gusc.c    | 1 +
 sys/dev/sound/isa/mss.c     | 1 +
 sys/dev/sound/isa/sb16.c    | 1 +
 sys/dev/sound/isa/sb8.c     | 1 +
 sys/dev/sound/isa/sbc.c     | 1 +
 12 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/share/man/man4/snd_ad1816.4 b/share/man/man4/snd_ad1816.4
index 2bc5a46aa560..9ebc6ce3488a 100644
--- a/share/man/man4/snd_ad1816.4
+++ b/share/man/man4/snd_ad1816.4
@@ -24,12 +24,15 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 15, 2005
+.Dd March 19, 2022
 .Dt SND_AD1816 4
 .Os
 .Sh NAME
 .Nm snd_ad1816
 .Nd "Analog Devices AD1816 ISA bridge device driver"
+.Sh DEPRECATION NOTICE
+This driver is scheduled for removal prior to the release of
+.Fx 14.0 .
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following lines in your
 kernel configuration file:
diff --git a/share/man/man4/snd_ess.4 b/share/man/man4/snd_ess.4
index 2b0333130084..d4ac1520becf 100644
--- a/share/man/man4/snd_ess.4
+++ b/share/man/man4/snd_ess.4
@@ -24,12 +24,15 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 15, 2005
+.Dd March 19, 2022
 .Dt SND_ESS 4
 .Os
 .Sh NAME
 .Nm snd_ess
 .Nd "Ensoniq ESS ISA PnP/non-PnP bridge device driver"
+.Sh DEPRECATION NOTICE
+This driver is scheduled for removal prior to the release of
+.Fx 14.0 .
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following lines in your
 kernel configuration file:
diff --git a/share/man/man4/snd_gusc.4 b/share/man/man4/snd_gusc.4
index 1ad73cfef4b2..86dd53b2d79a 100644
--- a/share/man/man4/snd_gusc.4
+++ b/share/man/man4/snd_gusc.4
@@ -25,12 +25,15 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 15, 2005
+.Dd March 19, 2022
 .Dt SND_GUSC 4
 .Os
 .Sh NAME
 .Nm snd_gusc
 .Nd Gravis UltraSound ISA bridge device driver
+.Sh DEPRECATION NOTICE
+This driver is scheduled for removal prior to the release of
+.Fx 14.0 .
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following lines in your
 kernel configuration file:
diff --git a/share/man/man4/snd_mss.4 b/share/man/man4/snd_mss.4
index 1baf1989d23a..10e0985d04b9 100644
--- a/share/man/man4/snd_mss.4
+++ b/share/man/man4/snd_mss.4
@@ -24,12 +24,15 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 1, 2005
+.Dd March 19, 2022
 .Dt SND_MSS 4
 .Os
 .Sh NAME
 .Nm snd_mss
 .Nd "Microsoft Sound System ISA PnP/non-PnP bridge device driver"
+.Sh DEPRECATION NOTICE
+This driver is scheduled for removal prior to the release of
+.Fx 14.0 .
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following lines in your
 kernel configuration file:
diff --git a/share/man/man4/snd_sbc.4 b/share/man/man4/snd_sbc.4
index 227080c65beb..e15d23081fb7 100644
--- a/share/man/man4/snd_sbc.4
+++ b/share/man/man4/snd_sbc.4
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 17, 2007
+.Dd March 19, 2022
 .Dt SND_SBC 4
 .Os
 .Sh NAME
@@ -33,6 +33,9 @@
 .Nm snd_sb16 ,
 .Nm snd_sb8
 .Nd Creative Sound Blaster ISA and compatible bridge device driver
+.Sh DEPRECATION NOTICE
+This driver is scheduled for removal prior to the release of
+.Fx 14.0 .
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following lines in your
 kernel configuration file:
diff --git a/sys/dev/sound/isa/ad1816.c b/sys/dev/sound/isa/ad1816.c
index 97da82c21ff5..b348158cbfd2 100644
--- a/sys/dev/sound/isa/ad1816.c
+++ b/sys/dev/sound/isa/ad1816.c
@@ -599,6 +599,7 @@ ad1816_attach(device_t dev)
 	struct ad1816_info *ad1816;
     	char status[SND_STATUSLEN], status2[SND_STATUSLEN];
 
+	gone_in_dev(dev, 14, "ISA sound driver");
 	ad1816 = malloc(sizeof(*ad1816), M_DEVBUF, M_WAITOK | M_ZERO);
 	ad1816->lock = snd_mtxcreate(device_get_nameunit(dev),
 	    "snd_ad1816 softc");
diff --git a/sys/dev/sound/isa/ess.c b/sys/dev/sound/isa/ess.c
index 46405ec48aac..626f8b356537 100644
--- a/sys/dev/sound/isa/ess.c
+++ b/sys/dev/sound/isa/ess.c
@@ -812,6 +812,7 @@ ess_attach(device_t dev)
     	char status[SND_STATUSLEN], buf[64];
 	int ver;
 
+	gone_in_dev(dev, 14, "ISA sound driver");
     	sc = malloc(sizeof(*sc), M_DEVBUF, M_WAITOK | M_ZERO);
 	sc->parent_dev = device_get_parent(dev);
 	sc->bufsize = pcm_getbuffersize(dev, 4096, ESS_BUFFSIZE, 65536);
diff --git a/sys/dev/sound/isa/gusc.c b/sys/dev/sound/isa/gusc.c
index 00f59b834f51..6fd49ca1ea7e 100644
--- a/sys/dev/sound/isa/gusc.c
+++ b/sys/dev/sound/isa/gusc.c
@@ -308,6 +308,7 @@ gusc_attach(device_t dev)
 	sc_p scp;
 	void *ih;
 
+	gone_in_dev(dev, 14, "ISA sound driver");
 	scp = device_get_softc(dev);
 
 	bzero(scp, sizeof(*scp));
diff --git a/sys/dev/sound/isa/mss.c b/sys/dev/sound/isa/mss.c
index 745a20dbf1f0..b4e89d2a8041 100644
--- a/sys/dev/sound/isa/mss.c
+++ b/sys/dev/sound/isa/mss.c
@@ -1779,6 +1779,7 @@ mss_attach(device_t dev)
     	struct mss_info *mss;
     	int flags = device_get_flags(dev);
 
+	gone_in_dev(dev, 14, "ISA sound driver");
     	mss = (struct mss_info *)malloc(sizeof *mss, M_DEVBUF, M_NOWAIT | M_ZERO);
     	if (!mss) return ENXIO;
 
diff --git a/sys/dev/sound/isa/sb16.c b/sys/dev/sound/isa/sb16.c
index 38e15a427d50..7d750d054b29 100644
--- a/sys/dev/sound/isa/sb16.c
+++ b/sys/dev/sound/isa/sb16.c
@@ -814,6 +814,7 @@ sb16_attach(device_t dev)
 	uintptr_t ver;
     	char status[SND_STATUSLEN], status2[SND_STATUSLEN];
 
+	gone_in_dev(dev, 14, "ISA sound driver");
     	sb = malloc(sizeof(*sb), M_DEVBUF, M_WAITOK | M_ZERO);
 	sb->parent_dev = device_get_parent(dev);
 	BUS_READ_IVAR(sb->parent_dev, dev, 1, &ver);
diff --git a/sys/dev/sound/isa/sb8.c b/sys/dev/sound/isa/sb8.c
index 3fcc1770e136..700c106dcb19 100644
--- a/sys/dev/sound/isa/sb8.c
+++ b/sys/dev/sound/isa/sb8.c
@@ -718,6 +718,7 @@ sb_attach(device_t dev)
     	char status[SND_STATUSLEN];
 	uintptr_t ver;
 
+	gone_in_dev(dev, 14, "ISA sound driver");
     	sb = malloc(sizeof(*sb), M_DEVBUF, M_WAITOK | M_ZERO);
 	sb->parent_dev = device_get_parent(dev);
 	BUS_READ_IVAR(device_get_parent(dev), dev, 1, &ver);
diff --git a/sys/dev/sound/isa/sbc.c b/sys/dev/sound/isa/sbc.c
index d16e45bb3011..3c6dd3bba97d 100644
--- a/sys/dev/sound/isa/sbc.c
+++ b/sys/dev/sound/isa/sbc.c
@@ -329,6 +329,7 @@ sbc_attach(device_t dev)
     	int flags = device_get_flags(dev);
 	int f, dh, dl, x, irq, i;
 
+	gone_in_dev(dev, 14, "ISA sound driver");
     	if (!logical_id && (flags & DV_F_DUAL_DMA)) {
         	bus_set_resource(dev, SYS_RES_DRQ, 1,
 				 flags & DV_F_DRQ_MASK, 1);