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$
.\"
.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:

View file

@ -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:

View file

@ -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:

View file

@ -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:

View file

@ -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:

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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