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
This commit is contained in:
Ed Maste 2022-03-18 11:50:23 -04:00
parent 1b1bab0078
commit e39ec8933b
12 changed files with 27 additions and 5 deletions

View file

@ -24,12 +24,15 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 15, 2005 .Dd March 19, 2022
.Dt SND_AD1816 4 .Dt SND_AD1816 4
.Os .Os
.Sh NAME .Sh NAME
.Nm snd_ad1816 .Nm snd_ad1816
.Nd "Analog Devices AD1816 ISA bridge device driver" .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 .Sh SYNOPSIS
To compile this driver into the kernel, place the following lines in your To compile this driver into the kernel, place the following lines in your
kernel configuration file: kernel configuration file:

View file

@ -24,12 +24,15 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 15, 2005 .Dd March 19, 2022
.Dt SND_ESS 4 .Dt SND_ESS 4
.Os .Os
.Sh NAME .Sh NAME
.Nm snd_ess .Nm snd_ess
.Nd "Ensoniq ESS ISA PnP/non-PnP bridge device driver" .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 .Sh SYNOPSIS
To compile this driver into the kernel, place the following lines in your To compile this driver into the kernel, place the following lines in your
kernel configuration file: kernel configuration file:

View file

@ -25,12 +25,15 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 15, 2005 .Dd March 19, 2022
.Dt SND_GUSC 4 .Dt SND_GUSC 4
.Os .Os
.Sh NAME .Sh NAME
.Nm snd_gusc .Nm snd_gusc
.Nd Gravis UltraSound ISA bridge device driver .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 .Sh SYNOPSIS
To compile this driver into the kernel, place the following lines in your To compile this driver into the kernel, place the following lines in your
kernel configuration file: kernel configuration file:

View file

@ -24,12 +24,15 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 1, 2005 .Dd March 19, 2022
.Dt SND_MSS 4 .Dt SND_MSS 4
.Os .Os
.Sh NAME .Sh NAME
.Nm snd_mss .Nm snd_mss
.Nd "Microsoft Sound System ISA PnP/non-PnP bridge device driver" .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 .Sh SYNOPSIS
To compile this driver into the kernel, place the following lines in your To compile this driver into the kernel, place the following lines in your
kernel configuration file: kernel configuration file:

View file

@ -25,7 +25,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd February 17, 2007 .Dd March 19, 2022
.Dt SND_SBC 4 .Dt SND_SBC 4
.Os .Os
.Sh NAME .Sh NAME
@ -33,6 +33,9 @@
.Nm snd_sb16 , .Nm snd_sb16 ,
.Nm snd_sb8 .Nm snd_sb8
.Nd Creative Sound Blaster ISA and compatible bridge device driver .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 .Sh SYNOPSIS
To compile this driver into the kernel, place the following lines in your To compile this driver into the kernel, place the following lines in your
kernel configuration file: kernel configuration file:

View file

@ -599,6 +599,7 @@ ad1816_attach(device_t dev)
struct ad1816_info *ad1816; struct ad1816_info *ad1816;
char status[SND_STATUSLEN], status2[SND_STATUSLEN]; 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 = malloc(sizeof(*ad1816), M_DEVBUF, M_WAITOK | M_ZERO);
ad1816->lock = snd_mtxcreate(device_get_nameunit(dev), ad1816->lock = snd_mtxcreate(device_get_nameunit(dev),
"snd_ad1816 softc"); "snd_ad1816 softc");

View file

@ -812,6 +812,7 @@ ess_attach(device_t dev)
char status[SND_STATUSLEN], buf[64]; char status[SND_STATUSLEN], buf[64];
int ver; int ver;
gone_in_dev(dev, 14, "ISA sound driver");
sc = malloc(sizeof(*sc), M_DEVBUF, M_WAITOK | M_ZERO); sc = malloc(sizeof(*sc), M_DEVBUF, M_WAITOK | M_ZERO);
sc->parent_dev = device_get_parent(dev); sc->parent_dev = device_get_parent(dev);
sc->bufsize = pcm_getbuffersize(dev, 4096, ESS_BUFFSIZE, 65536); sc->bufsize = pcm_getbuffersize(dev, 4096, ESS_BUFFSIZE, 65536);

View file

@ -308,6 +308,7 @@ gusc_attach(device_t dev)
sc_p scp; sc_p scp;
void *ih; void *ih;
gone_in_dev(dev, 14, "ISA sound driver");
scp = device_get_softc(dev); scp = device_get_softc(dev);
bzero(scp, sizeof(*scp)); bzero(scp, sizeof(*scp));

View file

@ -1779,6 +1779,7 @@ mss_attach(device_t dev)
struct mss_info *mss; struct mss_info *mss;
int flags = device_get_flags(dev); 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); mss = (struct mss_info *)malloc(sizeof *mss, M_DEVBUF, M_NOWAIT | M_ZERO);
if (!mss) return ENXIO; if (!mss) return ENXIO;

View file

@ -814,6 +814,7 @@ sb16_attach(device_t dev)
uintptr_t ver; uintptr_t ver;
char status[SND_STATUSLEN], status2[SND_STATUSLEN]; 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 = malloc(sizeof(*sb), M_DEVBUF, M_WAITOK | M_ZERO);
sb->parent_dev = device_get_parent(dev); sb->parent_dev = device_get_parent(dev);
BUS_READ_IVAR(sb->parent_dev, dev, 1, &ver); BUS_READ_IVAR(sb->parent_dev, dev, 1, &ver);

View file

@ -718,6 +718,7 @@ sb_attach(device_t dev)
char status[SND_STATUSLEN]; char status[SND_STATUSLEN];
uintptr_t ver; uintptr_t ver;
gone_in_dev(dev, 14, "ISA sound driver");
sb = malloc(sizeof(*sb), M_DEVBUF, M_WAITOK | M_ZERO); sb = malloc(sizeof(*sb), M_DEVBUF, M_WAITOK | M_ZERO);
sb->parent_dev = device_get_parent(dev); sb->parent_dev = device_get_parent(dev);
BUS_READ_IVAR(device_get_parent(dev), dev, 1, &ver); BUS_READ_IVAR(device_get_parent(dev), dev, 1, &ver);

View file

@ -329,6 +329,7 @@ sbc_attach(device_t dev)
int flags = device_get_flags(dev); int flags = device_get_flags(dev);
int f, dh, dl, x, irq, i; int f, dh, dl, x, irq, i;
gone_in_dev(dev, 14, "ISA sound driver");
if (!logical_id && (flags & DV_F_DUAL_DMA)) { if (!logical_id && (flags & DV_F_DUAL_DMA)) {
bus_set_resource(dev, SYS_RES_DRQ, 1, bus_set_resource(dev, SYS_RES_DRQ, 1,
flags & DV_F_DRQ_MASK, 1); flags & DV_F_DRQ_MASK, 1);