CVS log for src/share/man/man4/audio.4

Up to [cvs.NetBSD.org] / src / share / man / man4

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

audio.4: Document how the "delta" affects setting mixer levels.

Explicitly say that "delta" is optional and may be zero. While this
hasn't previously been specified anywhere (to my knowledge), the best
de-facto specification we have (sb and mixerctl source code) points
towards the historical practice being there.

audio.4: fix grammar and style in places

No change to technical content.

Pull up following revision(s) (requested by isaki in ticket #1157):

	share/man/man4/audio.4: revision 1.104

Remove an old description.
This behavior was modified in sys/dev/audio/audio.c rev 1.65 (Mar. 2020).

Remove an old description.
This behavior was modified in sys/dev/audio/audio.c rev 1.65 (Mar. 2020).

Pull up following revision(s) (requested by isaki in ticket #875):

	sys/dev/audio/audio.c: revision 1.59
	share/man/man4/audio.4: revision 1.102
	share/man/man4/audio.4: revision 1.103
	sys/dev/audio/audio.c: revision 1.43

Limit the number of channels that userland apps can set (by AUDIO_SETINFO)
to the number of channels supported by the hardware or less, if the hardware
supports multi channels.
- On monaural or stereo hardware, userland apps can always set 1ch or 2ch.
  The kernel (audio layer) can convert mono-stereo each other.
- On 3ch (2.1ch) hardware, for example, userland apps can set 1, 2, or 3ch,
  but not 4ch or more.

This allows userland apps to know actual number of channels supported by
the hardware in the same way as before.

PR kern/54973.


Reinitialize the sticky parameters whenever the hardware format is changed.

When the number of the hardware channels becomes less than the number of
channels that sticky parameters remember, subsequent open("/dev/sound") will
fail without this treatment.  This is for rev 1.43.


Add description about channel limitation introduced in audio.c 1.43.
PR kern/54973.

Remove trailing whitespace.

Mostly merge changes from HEAD upto 20200411

Remove trailing whitespace.

Add description about channel limitation introduced in audio.c 1.43.
PR kern/54973.

Revert 1.96, 1.97 and 1.100.  (no response from nia@)
These changes are not correct nor notable unresolvable problem.
If you find any problems, please send a report before changing manpage.

audio.4: 1-12 channels are only universally supported for playback.

When a mono recording device is set to use 1 channel, the kernel will
correct the number of channels back down to 1. This information can be
obtained with AUDIO_GETINFO...

audio.4: Mention the blk_ms sysctl

Sort sections.

audio.4: O_NONBLOCK isn't the actual problem

audio.4: Remove reference to using O_NONBLOCK

It doesn't work properly, but this turns out to not be a problem in most
code (code where it is generally uses threads)...

Don't provide misleading information about using it, or programmers
might start wondering why their code doesn't work.

Noted by Yorick Hardy on current-users

Sort SEE ALSO.

Replace mention of azalia with hdaudio

Add some audio drivers in SEE ALSO.

Remove self-reference

Update list of audio drivers in SEE ALSO.

Based on audioplay(1) man page, where I'll remove them shortly.

Pull up following revision(s) (requested by sevan in ticket #1351):

	share/man/man4/man4.amiga/grf.4: revision 1.7
	share/man/man4/si.4: revision 1.11
	share/man/man8/man8.sparc/boot.8: revision 1.32
	share/man/man5/nsswitch.conf.5: revision 1.29
	share/man/man5/mixerctl.conf.5: revision 1.7
	share/man/man8/man8.vax/boot.8: revision 1.14
	share/man/man4/man4.vax/dn.4: revision 1.12
	share/man/man8/man8.vax/drtest.8: revision 1.16
	share/man/man8/sysinst.8: revision 1.6
	share/man/man4/ip.4: revision 1.37
	share/man/man5/boot.cfg.5: revision 1.28
	share/man/man1/cd.1: revision 1.10
	share/man/man4/usb.4: revision 1.106
	share/man/man4/man4.vax/ix.4: revision 1.17
	share/man/man7/security.7: revision 1.15
	share/man/man7/hier.7: revision 1.123
	share/man/man8/afterboot.8: revision 1.58
	share/man/man1/man1.x68k/bellctrl.1: revision 1.14
	share/man/man4/se.4: revision 1.6
	share/man/man4/utoppy.4: revision 1.7
	share/man/man4/midi.4: revision 1.32
	share/man/man4/cfb.4: revision 1.5
	share/man/man4/man4.sparc/magma.4: revision 1.12
	share/man/man4/audio.4: revision 1.80
	share/man/man4/isic.4: revision 1.18
	share/man/man1/cd.1: revision 1.7
	share/man/man4/envsys.4: revision 1.51
	share/man/man1/cd.1: revision 1.8
	share/man/man1/cd.1: revision 1.9
	share/man/man3/fast_divide32.3: revision 1.9
	share/man/man4/pci.4: revision 1.97
	share/man/man5/ranlib.5: revision 1.7
	share/man/man3/__arraycount.3: revision 1.7
	share/man/man4/isa.4: revision 1.46
	share/man/man8/man8.atari/ahdilabel.8: revision 1.14
	share/man/man4/chipsfb.4: revision 1.6
	share/man/man8/man8.macppc/boot.8: revision 1.8
	share/man/man5/passwd.5: revision 1.33
	share/man/man8/man8.macppc/ofwboot.8: revision 1.14
	share/man/man8/compat_linux.8: revision 1.38
	share/man/man4/iop.4: revision 1.22
	share/man/man4/ddb.4: revision 1.167
	share/man/man4/termios.4: revision 1.37
	share/man/man8/compat_freebsd.8: revision 1.18
	share/man/man5/ar.5: revision 1.9
	share/man/man7/release.7: revision 1.37
	share/man/man5/core.5: revision 1.31
	share/man/man4/ahd.4: revision 1.6
	share/man/man4/man4.vax/ad.4: revision 1.12
	share/man/man4/pppoe.4: revision 1.39
	share/man/man5/locale.alias.5: revision 1.3
	share/man/man8/man8.amiga/installboot.8: revision 1.23
	share/man/man4/etherip.4: revision 1.8
	share/man/man3/queue.3: revision 1.57
	share/man/man5/genassym.cf.5: revision 1.13
	share/man/man4/mpls.4: revision 1.10
	share/man/man1/wait.1: revision 1.5
	share/man/man5/capfile.5: revision 1.4
	share/man/man4/man4.alpha/ttwopci.4: revision 1.6
	share/man/man4/man4.atari/rtc.4: revision 1.8
	share/man/man4/gpiosim.4: revision 1.6
	share/man/man3/bitstring.3: revision 1.18
	share/man/man4/isdntel.4: revision 1.8
	share/man/man4/ai.4: revision 1.9
	share/man/man8/man8.hppa/boot.8: revision 1.2
	share/man/man4/uyurex.4: revision 1.6
	share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
	share/man/man4/bpf.4: revision 1.56
	share/man/man4/man4.amiga/mfcs.4: revision 1.8
	share/man/man4/cmpci.4: revision 1.9
	share/man/man8/man8.vax/format.8: revision 1.14
	share/man/man8/compat_svr4.8: revision 1.27
	share/man/man4/crypto.4: revision 1.26
	share/man/man4/userconf.4: revision 1.13
	share/man/man4/agp.4: revision 1.17
	share/man/man9/man9.i386/bioscall.9: revision 1.10
	share/man/man4/uftdi.4: revision 1.20
	share/man/man4/radio.4: revision 1.13
	share/man/man4/mfb.4: revision 1.5
	share/man/man7/ascii.7: revision 1.8
	share/man/man4/man4.vax/dl.4: revision 1.13
	share/man/man4/ral.4: revision 1.12
	share/man/man4/unix.4: revision 1.26
	share/man/man4/edc.4: revision 1.12
	share/man/man4/pim.4: revision 1.5
	share/man/man8/compat_ultrix.8: revision 1.21
	share/man/man4/dge.4: revision 1.11
	share/man/man8/diskless.8: revision 1.32
	share/man/man5/passwd.conf.5: revision 1.11
	share/man/man8/man8.acorn26/boot26.8: revision 1.8
	share/man/man4/man4.vax/hy.4: revision 1.12
	share/man/man4/plip.4: revision 1.4
	share/man/man4/sc.4: revision 1.8
	share/man/man4/ec.4: revision 1.14
	share/man/man4/man4.sgimips/giopci.4: revision 1.9
	share/man/man7/sysctl.7: revision 1.114
	share/man/man3/bits.3: revision 1.18
	share/man/man4/we.4: revision 1.19
	share/man/man8/compat_sunos.8: revision 1.21
	share/man/man4/ip6.4: revision 1.31
	share/man/man4/acpilid.4: revision 1.8
	share/man/man4/man4.dreamcast/aica.4: revision 1.6
	share/man/man4/mfi.4: revision 1.12
	share/man/man4/ugen.4: revision 1.32
	share/man/man4/jme.4: revision 1.7
	share/man/man4/man4.sparc64/intro.4: revision 1.5
	share/man/man4/zyd.4: revision 1.5
	share/man/man4/gre.4: revision 1.45
	share/man/man3/bitmap.3: revision 1.10
	share/man/man4/man4.vax/cons.4: revision 1.12
	share/man/man3/gcq.3: revision 1.4
	share/man/man4/man4.hppa/pdc.4: revision 1.3
	share/man/man4/multicast.4: revision 1.8
	share/man/man4/man4.sparc/intro.4: revision 1.27
	share/man/man4/ath.4: revision 1.32
	share/man/man4/ym.4: revision 1.19
	share/man/man3/iso646.3: revision 1.6
	share/man/man4/btsco.4: revision 1.13
	share/man/man4/man4.i386/ndis.4: revision 1.6
	share/man/man4/pad.4: revision 1.6
	share/man/man4/strip.4: revision 1.16
	share/man/man8/man8.x86/boot.8: revision 1.12
	share/man/man4/amr.4: revision 1.15
	share/man/man4/ieee80211.4: revision 1.5
	share/man/man4/options.4: revision 1.467
	share/man/man5/link.5: revision 1.24
	share/man/man8/man8.cobalt/boot.8: revision 1.10
	share/man/man5/stab.5: revision 1.15
	share/man/man3/tree.3: revision 1.12
	share/man/man4/route.4: revision 1.31
	share/man/man4/man4.sun3/leds.4: revision 1.13
	share/man/man4/bluetooth.4: revision 1.20
	share/man/man4/man4.i386/pcibios.4: revision 1.19
	share/man/man5/veriexec.5: revision 1.8
	share/man/man7/operator.7: revision 1.12
	share/man/man4/man4.hp300/dcl.4: revision 1.13
	share/man/man4/man4.i386/intro.4: revision 1.31
	share/man/man5/ld.so.conf.5: revision 1.21
	share/man/man8/man8.alpha/boot.8: revision 1.16
	share/man/man4/bio.4: revision 1.13
	share/man/man4/man4.sun2/leds.4: revision 1.10
	share/man/man8/man8.x86/mbr.8: revision 1.4
	share/man/man8/man8.mvme68k/boot.8: revision 1.9
	share/man/man4/man4.alpha/ttwoga.4: revision 1.6
	share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

 -

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.

Sync with HEAD

Bump date.

Fix some typos, improve wording and formatting.

Update manpages respond to isaki-audio2 branch.

Two minor fixes.
- Add missing AUDIO_PERROR (since 1996!)
- Sort AUDIO_GETFD.

Sync with HEAD

Pull up following revision(s) (requested by nat in ticket #848):

	share/man/man9/Makefile: revision 1.422
	distrib/sets/lists/comp/mi: revision 1.2198
	share/man/man7/Makefile: revision 1.33
	share/man/man9/audio.9: revision 1.47
	share/man/man7/audio.7: file removal
	sys/dev/audio.c: revision 1.456
	sys/dev/audio.c: revision 1.457
	distrib/sets/lists/man/mi: revision 1.1591
	share/man/man9/intro.9: revision 1.20
	share/man/man7/audio.7: revision 1.3
	share/man/man9/audio_system.9: revision 1.1
	share/man/man7/intro.7: revision 1.26
	share/man/man4/audio.4: revision 1.86

Fix a typo with sc_out/inports when setting the hardware recording gain on the
mix ring.  Found by mrg@
XXX pullup-8

Using audioctl without the -p switch defaults to the mix ring.  This allows
setting the hardware gain etc.

Update the audio spec in audio.7 to reflect these changes.
Addresses PR kern/52781.

Move the audio specification to section 9 under audio_system.
Ok wiz@

Move the audio specification to section 9 under audio_system.

Ok wiz@

Sync with HEAD

Pull up following revision(s) (requested by nat in ticket #825):

	share/man/man7/Makefile: revision 1.32
	share/man/man9/audio.9: revision 1.46
	sys/dev/audio.c: revision 1.453
	sys/dev/audio.c: revision 1.454
	sys/dev/audio.c: revision 1.455
	share/man/man7/audio.7: revision 1.1
	share/man/man7/audio.7: revision 1.2
	share/man/man7/intro.7: revision 1.24
	share/man/man4/audio.4: revision 1.85
	distrib/sets/lists/man/mi: revision 1.1586

Fix numbering of vchan mixer controls to correspond to the vchan number in
use.

This makes the numbering of vchans consistient for audioctl and mixerctl.
Expose the audio_info structure of vchan zero(0) the mix ring to allow
setting the hardware gain and balance via audioctl(1) using the -p 0
switch.

It is not possible to influence the hardware gain/blance from the
audio_info structure of vchans 1 onwards.  It is now possible to return
the audio mixers audio format from the audio_info structure of vchan 0 to
ease applications configuring for mmapped play back.

This is conformant to the audio specification posted on tech-kern see:

        "NetBSD Audio Specification 2018"

or audio.7 manual page to be added in a follow up commit.
Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."
Update the introduction page to section 7 of the manual noting the audio
spec.

Various improvements, more markup, typo fixes.

Fix over cautious compiler error - setmode may not be initialized.

Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."

Pull up following revision(s) (requested by nat in ticket #489):
	share/man/man4/audio.4: 1.81-1.82
	sys/dev/audio.c: 1.376 via patch, 1.407-1.413, 1.415-1.440, 1.441 via patch, 1.443-1.450
	sys/dev/audiovar.h: 1.59 via patch, 1.65-1.68
Improve audio_set_vchan_defaults().
- Correct confused input/output parameters.
- Remove sc->{sc_channels, sc_precision, sc_frequency}.  They are
  the same as sc->sc_vchan_params.{channels, precision, sample_rate}.
The input parameter of audio_set_vchan_defaults() is now only
sc->sc_vchan_params.
Fix PR kern/52437
Move play/rec mix ring buffers into a virtual channel sc_mixring.  NFCI.
Call audio_mix for a third time - thus ensuring there is a block of data
in the mix ring before the audio interrupt occurs.
This addresses the instability seen in the audio atf tests.
Improve logic in audio_initbufs().  No functional changes intended.
Ensure proper use of sc_opens (play back) and sc_recopens (recording).
Fix logic for /dev/sound so audiosetinfo is only called once.
These changes are to ensure that init_output/input is only called once for
the respective function play back or recording.  For multiple recording or
plack back streams init_input/output is only called once fot the first
play/rec stream.
This addresses PR kern/52580, PR kern/52581 and PR kern/52582 analyzed and
reported by isaki@.
Fix return value.  fo_mmap is expected to return errno on error.
Fix return value.  fo_poll is expected to return revents on error.
Fix return value.  fo_kqfilter is expected to return errno on error.
This is the rest of 1.226 (10 years ago).
Add latency sysctl to adjust hw blocksize and hence latency of the mixer.
        usage: sysctl -w hw.hdafg0.lantency="value in milliseconds"
It is possible to set the latency of the mixer unless a static blocksize
is configured by the underlying hardware driver (pad, vcaudio on RPI).
Documentation updates to audio.4 will occur in a follow up commit.
OK christos@.
Ensure that the low/high water marks are at least PREFILL_BLOCKS.
Independent blocksizes for virtual channels where a static blocksize is
not stipulated by the underlying hw driver.
This improves latency in games esp. when the stream format differs from
the harware format.
OK christos@.
No externs in .c files!  Include ioconf.h for struct cfdriver xyz_cd.
round_blocksize is only used for the hardware ring buffer.  All other
buffers (mix ring, streams) are set to be a power of 2.
This allows for consistent latency where a static blocksize is enforced by
the underlying audio device driver.
Ok christos@.
Move calculation of sc_latency into a function.
The latency of the audio device is updated on attach in the audio auto
config and shown on screen.
Ok christos@.
Only allow blocksizes greater or equal to the calculated one.
This should help applications as the blocksize obtained (AUDIO_SET/GETINFO)
will work without stutter.
Ok christos@.
Revert commit rev 1.419 to audio.c.  This should address PR kern/52685.
This also means that drivers that have a static block size will have more
latency at lower sample rates/precision/channels.  Also audio drivers that
do more than supply rounded blocksizes in their round_blocksize functions
will have to be changed.
Use mix ring block size in audio write, startp, and audio drain.
Allow for block sizes less than hw block size.  This allows for the lowest
possible latency for all precision, sample rate and frequencies.
This is a rework of rev 1.419.
Calc latency when altering precision, frequency and channels sysctls.
No need to ratify block size twice as this is done in audio_initbufs.
This is a rework of rev 1.421.
Revert to previous.  It is necessary to use the calculated blocksize if
none supplied.
Tested by martin@.
Blocksizes sould be rounded to a power of 2 as OSS applications need this.
Tested by martin@.
AU_RING_SIZE -> s.bufsize in audio_initbufs.
A sysctl is now available to disable the in kernel mixer.
        sysctl -w hw.hdafg0.usemixer=0
There currently is a problem draining the last block with the mixer
disabled.  I will fix this in a follow up commit.
AFAIK there will be a problem wiht vs(4) on x68k with the mixer disabled
as the filters for mulaw, alaw and unsigned linear have been removed post
audio mixing changes.
Documentation for this sysctl variable will be made to audio.4 in a follow
up commit.
Ok christos@.
Use mixring blocksizes in the right places when mixer is enabled.
This means that x68k's vs audio works once again with sysctl usemixer=1.
Tested with xm6i.
Don't return EIO falsely when dealing with the hardware vc.
Draining of the hardware vc on close is now possible.
Plug memory leak as the mixer state does not grow or shrink when audio
mixing is disabled.  This avoids triggering a panic also.
Improved draining function for when the mixer is and is not enabled.
One block of silence is also played in audio drivers using start_output
when draining the hardware, this helps playback of short (less than
blocksize) samples.
Improved audiostartp for when audio mixing is disabled.
audio_pint improvements for when audio mixing is disabled.
When audio mixing is disabled there is only the hardware vc the mix ring
is not used.
The harware vc is rounded to a power of two then round_blocksize is called.
This improves playback and makes it possibile to use mmapped audio on usb.
For the virtual stream it is required to insert silence.  As these streams
are not harware streams audio_pint_silence is ineffective.
As audio_mix() was the only consumer of audio_pint_silence it has been
removed along with sc_sil_count - which was only used by this function.
Add vc to debug messages in audio_mix.
Also add debug message when available data in the vc is less than the mix
ring blocksize.  NFC.
Use correct combination of mix ring block size and vc playring used low
for signalling the writer or fetching data from the vc play ring filters.
When dealing with the ring buffer sc_mpr.s it is necessary to use the hwvc
or mixring block sizes as they represent the final size of the data to be
played back from the stream vc.
When dealing with sc_pustream when there is play back filters or not one
should use the vc->sc_mpr.blocksize, as this represents the amount of data
before going through play back filters.
This should address PR kern/52685.
Speed up improvements for MIX_FUNC.
As suggested by jmcneill@.
Only init the mix ring if sc_usemixer is enabled as with mixing set to
false the mix ring is not used.
Allow the hwvc block size to be set to any amount with audio mixing
disabled.
Convert double block size of data though the play back filters.  This is
primarily for when audio mixing is disabled to stop inserting silence when
there is data available.
This change should have no effect when mixing is enabled as there is only
1 block of data in the mix ring.
Whitespace.
Only signal a pause change on a transition of a pause change.
This addresses a problem found in audio/sox causing high cpu usage.
Path and analysis by Onno van der Linden.
Rework of play/rec threads to ensure effective use of locks.
Addresses part of PR kern/52889 where the mixing thread would not exit on
audio detach.
Forcefully detach children of audio instances.
This addresses part of PR kern/52889 as children of pad(4) were not
detaching.
Document the hw.driverN.latency sysctl variable.
Bump date for previous. Remove superfluous Pp.
Allow open of audioctl devices whilst audio is open with the mixer
disabled.

Use .Ar to mark up the variable parts of sysctl nodes.

Drive-by markup improvements.

Bump date for previous. Remove superfluous Pp.

Document the hw.driverN.latency sysctl variable.

Remove workaround for ancient HTML generation code.

Sync with HEAD

Audio mmap now works with all devices as hw->mappage is no longer used.
Audio ring buffers are now uvm objects.

This was made possibile with help from christos@ and much help and mmap
functions written by riastradh@.

Sync with HEAD

Sync with HEAD

Improved mixing function - more expensive in cycles though.
hw.driverN.saturate is no longer needed and has been removed.

Mixing function thanks to jmcneill@.

hw.driverN.saturate bool->integer (default 16).

This means for a greater number than 16 (or user set value) the saturate
function is turned off.  Results in better listening if a large number of
channels are in use.

Renane ioctl AUDIO_SETPROC to AUDIO_SETCHAN.

Add an ioctl to return channel number (AUDIO_GETCHAN). This can be used
on audio/sound/audioctl devices.

Return EIO in read/write/ioctl/poll/stat if fp has been closed or is
invalid.

Update audio.4, audioio.h and audioctl(1) to reflect these changes.

Sync with HEAD

Sort sections.

Audio now uses fdclone, there is no longer a limitation of one audio
instance per process.  Virtual channels are placed in a queue, so there is
no longer a compile time limit of VAUDIOCHANS.

A new sysctl has been added to control multiple user access.
Mixer labels on virtual channels are now prefixed by vchan.

audiobell.c and audioctl have been updated to reflect these changes.

Use of fdclone was posted to tech-kern@ and improvements made.
Multiuser access control changes and the use of a queue were suggessted by
pgoyette@

Sync with HEAD.  (Note that most of these changes are simply $NetBSD$
tag issues.)

Update audio man page with regard to audio changes.
OK wiz@

Document AUDIO_ENCODING_AC3

Sync with HEAD (-D20101022).

AUDIO_WSEEK uses a u_long, not a int.

sync to netbsd-5

Pull up following revision(s) (requested by sborrill in ticket #1038):
	share/man/man4/audio.4: revision 1.70 via patch
	sys/dev/audio.c: revision 1.248
	sys/dev/audio_if.h: revision 1.66
	sys/dev/pci/hdaudio/hdaudio_afg.c: revision 1.16
	sys/sys/audioio.h: revision 1.33
Add support for playback- or capture-only devices.
Fixes PR 42050

Add support for playback- or capture-only devices by adding
AUDIO_PROP_PLAYBACK and AUDIO_PROP_CAPTURE properties.

From jmcneill@.

Fixes PR#42050

remove siisata and esl. (KIYOHARA Takashi)

Sync with HEAD.

sync with head.

Convert TNF licenses to new 2 clause variant

Sync w/ NetBSD-4-RC_1

Whitespace nits.

Pull up following revision(s) (requested by jmcneill in ticket #716):
	share/man/man4/audio.4: revision 1.66
	sys/compat/ossaudio/ossaudio.c: revision 1.56
	sys/sys/audioio.h: revision 1.32
	lib/libossaudio/ossaudio.c: revision 1.21
	sys/dev/audio.c: revision 1.222
Add a new ioctl AUDIO_GETBUFINFO. It works like AUDIO_GETINFO, but
doesn't obtain the ports, gain and balance related parameters.
Those generally require reading from the hardware and therefore are
much
more expensive to obtain. Modify OSS emulation to use the new ioctl
where possible.
This reduces CPU usage of mplayer during mp3 playback with my Thinkpad
from 20% to < 1% and from 50% to 20% during Xvid playback.
Review and comments from jmcneill@

Add a new ioctl AUDIO_GETBUFINFO. It works like AUDIO_GETINFO, but
doesn't obtain the ports, gain and balance related parameters.
Those generally require reading from the hardware and therefore are much
more expensive to obtain. Modify OSS emulation to use the new ioctl
where possible.

This reduces CPU usage of mplayer during mp3 playback with my Thinkpad
from 20% to < 1% and from 50% to 20% during Xvid playback.

Review and comments from jmcneill@

Bump date for previous.

Make <sys/audioio.h> include prerequisite headers; audio(4) was incomplete
with regard to required headers, and besides that it also matches Solaris.

add references to auixp(4) and azalia(4)

Also remove references to sp(4) (same as pss(4)).

Remove references to removed pss(4).

Add auacer.

Various fixes from Sergey Svishchev svs at ropnet ru in private mail.
Some additional "new sentence, new line" changes while I was there.

Bump date for previous.

Fix a couple of long-standing bugs in the volume control(s) part of the
audio device interface:

1) When attempting to match the appropriate mixer control, we weren't
checking the class label, but only the second level label, so for
devices that had both an "inputs.cd" and a "record.cd", for example,
we could never do the right thing except by chance. For this reason,
evidently, all the record masters were labeled (by the underlying
drivers) either "record.record" or "record.volume", to distinguish
from "outputs.master". We'll now accept "record.master", and document
that as the the new preferred way.

2) More importantly, the model was deficient. Selecting a port on many
chips completely disables most of the level controls, which doesn't play
nice with other applications which are trying to use the interface. Now,
selecting a port simply sets which mixer input control shall be changed,
setting state in the audio layer. In other words, the "mixerout" port
is really selected all the time, enabling the final stage mixer, and
setting "gain" sets the level of the appropriate input. It should be
possible for separate applications to each control the mic, dac, and cd
inputs at the same time using this interface, simply by reiterating their
port selections with each change, but applications that don't bother to
do that aren't any worse off than they were before.

The user is expected to set the master output with another application,
dedicated to that task. Though it is now meaningful to select "no port"
with the audio device interface, to manipulate the master output, there's
no particular reason for an audio device consumer to do that. (I added
the capability in order to restore the initial state of the audio device,
for testing purposes. It might also be useful to users of broken binary-
only applications.)

Observe that the mixer device interface (and so, "mixerctl") still
retains all capabilities, including the ability to set the actual input
port on the chip, overriding the level controls. No change is being made
to the mixer device interface. The mixer device simply presents all the
controls on the chip, with no attempt at abstraction, so there are no
bugs there.

The upshot is, that applications that have been trying to use the audio
device interface to change the volume, such as mplayer, now "just work".

I've tested these changes extensively with "eso" and "eap" since first
proposing them on tech-kern last January, and somewhat with "esm" and a
few others. This closes both PR kern/10221, and PR kern/17159.

Complete typedef of struct audio_info to audio_info_t.
From Jared Yanovich via jmc@openbsd.

There is no als(4).

.Li Dv -> .Dv.

Update the SEE ALSO list with drivers that have been added since
1997 (when this man page was updated?). Change an ugly .br hack
into .Ss macros. Add paragraph breaks in a few places to improve
readability.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Respect the law: Use A-law and mu-law as spellings as far as easily possible.
Inspired by Igor Sobrado in PR 19680.

Use .Dv for AudioN* and AudioC*

Fix capitalization error, noted by uwe.
Minor mandoc improvements while I'm here.

Fix typo.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Drop trailing whitespace.

A number of small fixes from Sergey Svishchev.

Add a cross reference to esa(4).

Pull up revision 1.43 (requested by he):
  Add driver for Creative Labs SBLive! EMU10000 and (probably) PCI512.
  Fixes PR#15260.

Xref.

Remove a 'the'.

Xref esl(4).

Whitespace&punctuation fixes, sort SEE ALSO, sort sections, drop .Pp's,
swap empty lines for .Pp's.

Typos/whitespace.

Pull up revision 1.36 (requested by skrll):
  Add a driver for the ESS Technology Maestro-1/2/2E AC97 audio chips,
  ES1968 and ES1978.

Pull up revision 1.38 (requested by minoura):
  Add Yamaha YMF724/740/744/745-based sound driver and
  its subordinates.

Manual page for Yamaha YMF724/740/744/754 PCI audio driver.

Add clct(4) man page.

Add reference to esm(4)

Fix formatting glitches.

Fix typo.

Xref cmpci(4).

Man page for auvia(4). Also xref fms(4) from audio(4).

Fix doubled 'the's.

Xref clcs(4).

Pull up to last week's -current.

Pull up revision 1.29 (requested by is):
  Add missing "that" in AUDIO_WSEEK description, fixing PR#8664.

Add missing "that" in WSEEK description. By wiz@danbala.ifoer.tuwien.ac.at
in PR 8684.

Mention uaudio(4).

Fix typo noted by "Wiz" in PR misc/8061.

Xref eso(4).

Pasto.

More and more of .Os cleanups.  .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages.  Many more to
come.

Fix minor formatting error.

Minor touchup and add sv man page.

Add a midi(4) man page.

Add info about mixer_level_t which has been missing for all these years.

Cross reference audioctl(1) and mixerctl(1).

Marathon man page editing session to fix broken .Xr's, add important
references, add a little white space here & there for readability,
clean up some mdoc(7) macro usage and so on. Whew!

Minor editorial changes.

Update for SunOS compatibility.

Cross reference ossaudio(3).

Fix tipo inherited from old version of TNF copyright form.
s/REGENTS/FOUNDATION/.

Man page for guspnp driver.

Make sure audio device starts in half-duplex mode and document the fact.

Document some minor changes in the audio interface.

Document how setting the blocksize works now.

Document /dev/audioctl.

Document how setting the blocksize works.

Update man pages a little.

Update man pages for new audio features.

Return audio buffer size in audio_info_t with ioctl() AUDIO_GETINFO.
Use the buffer size to implement one more OSS ioctl().

update to match reality a bit more closely.  some parts are from John
  Hawkinson (PR kern/2523) and Lennart Augustsson (PR misc/3303), rest
  is by me.

Copyright assigned to the NetBSD Foundation

Fix typo, from John Kohl.  Closes PR 2066.

audio(4) man page from John Kohl (submitted in PR#1752).