Rework the FILES section to cover the list of common symbolic links

in the /dev directory.  Also cover this driver's quirky relationship
with the MAKEDEV script.
This commit is contained in:
sheldonh 2000-07-22 10:23:06 +00:00
parent db0fcdfb37
commit 85976e9542

View File

@ -124,19 +124,60 @@ Creative Labs SoundBlaster PCI is supported as well.
.Pp
.El
.Sh FILES
.Bl -tag -width /dev/snd* -compact
.It Pa /dev/snd*
Device nodes created with the shell commands
.Bk -words
.Ql cd /dev; sh MAKEDEV snd0
.Ek
for the pcm0 device,
.Bk -words
.Ql cd /dev; sh MAKEDEV snd1
.Ek
for the pcm1 device,
etc.
The following commonly used symbolic links to real device nodes
should be present:
.Pp
.Bl -tag -width /dev/sequencer -compact
.It Pa /dev/audio
Sparc-compatible audio device
.It Pa /dev/dsp
Digitized voice device
.It Pa /dev/dspW
Like
.Pa /dev/dsp ,
but 16 bits per sample
.It Pa /dev/midi
Raw midi access device
.It Pa /dev/mixer
Control port mixer device
.It Pa /dev/music
Level 2 sequencer interface
.It Pa /dev/sequencer
Sequencer device
.It Pa /dev/pss
Programmable device interface
.El
.Pp
Each symbolic link refers to a device node of the same name,
but with a unit number appended.
The unit number for each device matches the unit number of the
device probed at boot time.
Device probe messages can be examined with the
.Xr dmesg 8
utility.
.Pp
All the appropriate device nodes and symbolic links
for the
.Ql pcm0
device would created with the following commands:
.Bd -literal -offset indent
cd /dev; sh MAKEDEV snd0
.Ed
.Pp
Similarly, the device nodes and symbolic links for the
.Ql pcm1
device would be created as follows:
.Bd -literal -offset indent
cd /dev; sh MAKEDEV snd1
.Ed
.Pp
Since the
.Pa /dev/MAKEDEV
utility creates symbolic links that will be used by
many utilities by default,
the device nodes and symbolic links for the
preferred audio device in systems with multiple audio devices
should be created last.
.Sh DIAGNOSTICS AND TROUBLESHOOTING
.Bl -tag -width 2m
.It ac97: dac not ready