From e39ec8933be4d6e74cfb32680fb3e67469e66bb7 Mon Sep 17 00:00:00 2001 From: Ed Maste Date: Fri, 18 Mar 2022 11:50:23 -0400 Subject: [PATCH] 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 2bc5a46aa56..9ebc6ce3488 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 2b033313008..d4ac1520bec 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 1ad73cfef4b..86dd53b2d79 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 1baf1989d23..10e0985d04b 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 227080c65be..e15d23081fb 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 97da82c21ff..b348158cbfd 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 46405ec48aa..626f8b35653 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 00f59b834f5..6fd49ca1ea7 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 745a20dbf1f..b4e89d2a804 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 38e15a427d5..7d750d054b2 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 3fcc1770e13..700c106dcb1 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 d16e45bb301..3c6dd3bba97 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);