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)

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);