git: d7620b6ec941 - stable/13 - Add deprecation notices to ISA sound cards

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Mon, 16 May 2022 13:51:57 UTC
The branch stable/13 has been updated by emaste:

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

commit d7620b6ec941fc6239bb2600495c2978181cfe28
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2022-03-18 15:50:23 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2022-05-16 13:51:23 +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.
    
    Mail to -current and -stable revealed some nostalgic interest, but
    no offers to test or requests to pospone the deprecation.
    
    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 (MAX and newer AFAIK)
    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
    
    (cherry picked from commit e39ec8933be4d6e74cfb32680fb3e67469e66bb7)
---
 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 e8d7ac7cf62f..73bad65b3c1d 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 424e757a4b00..af34ee38ad04 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 eacbbf85849c..143baa8c64f0 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 73ec7c56245e..50d7e89650e5 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 779c6631b264..b45358c6c29c 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);