git: af89ff11fcfe - stable/12 - Add deprecation notices to ISA sound cards

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Mon, 16 May 2022 15:05:20 UTC
The branch stable/12 has been updated by emaste:

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

commit af89ff11fcfebe7e2de004766e86e8061ab57681
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:52:16 +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)
    (cherry picked from commit d7620b6ec941fc6239bb2600495c2978181cfe28)
---
 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 e8a8199b5008..07c5d10c807a 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 c2f50a8a32bd..c0c7d279f021 100644
--- a/sys/dev/sound/isa/ess.c
+++ b/sys/dev/sound/isa/ess.c
@@ -815,6 +815,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 302f2f180999..cbc01e408e9e 100644
--- a/sys/dev/sound/isa/gusc.c
+++ b/sys/dev/sound/isa/gusc.c
@@ -309,6 +309,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 b79c4fc1c337..6c169dbceaee 100644
--- a/sys/dev/sound/isa/mss.c
+++ b/sys/dev/sound/isa/mss.c
@@ -1782,6 +1782,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 cf7dd54199dc..50d48c00f63c 100644
--- a/sys/dev/sound/isa/sb16.c
+++ b/sys/dev/sound/isa/sb16.c
@@ -817,6 +817,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 9cdc1b230ab4..0830e52a49e1 100644
--- a/sys/dev/sound/isa/sb8.c
+++ b/sys/dev/sound/isa/sb8.c
@@ -720,6 +720,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);