History log of /freebsd-current/lib/libmixer/mixer.3
Revision Date Author Comments
# 1ab62c8d 22-May-2024 Christos Margiolis <christos@FreeBSD.org>

mixer.3: Fix mandoc -Tlint warnings

Sponsored by: The FreeBSD Foundation
MFC after: 1 day
Reviewed by: emaste
Differential Revision: https://reviews.freebsd.org/D45290


# 67c89b21 22-May-2024 Christos Margiolis <christos@FreeBSD.org>

mixer(3): Implement mixer_get_path() function

This is better than hardcoding device paths in mixer applications.

Sponsored by: The FreeBSD Foundation
MFC after: 1 day
Reviewed by: dev_submerge.ch
Differential Revision: https://reviews.freebsd.org/D45275


# 5d980fad 22-May-2024 Christos Margiolis <christos@FreeBSD.org>

sound: Handle unavailable devices in various OSS IOCTLs

mixer(8)'s -a option is used to print information about all mixer
devices in the system. To do this, it loops from 0 to
mixer_get_nmixers(), and tries to open "/dev/mixer%d". However, this
approach doesn't work when there are disabled/unregistered mixers in the
system, or when an audio device simply doesn't have a mixer.

mixer_get_nmixers() calls SNDCTL_SYSINFO and returns
oss_sysinfo->nummixers, whose value is the number of currently _enabled_
mixers only. Taking the bug report mentioned below (277615) as an
example, suppose a system with 8 mixer devices total, but 3 of them are
either disabled or non-existent, which means they will not show up under
/dev, meaning we have 5 enabled mixer devices, which is also what the
value of oss_sysinfo->nummixers will be. What mixer(8) will do is loop
from 0 to 5 (instead of 8), and start calling mixer_open() on
/dev/mixer0, up to /dev/mixer4, and as is expected, the first call will
fail right away, hence the error shown in the bug report.

To fix this, modify oss_sysinfo->nummixers to hold the value of the
maximum unit in the system, which, although not necessarily "correct",
is more intuitive for applications that will want to use this value to
loop through all mixer devices.

Additionally, notify applications that a device is
unavailable/unregistered instead of skipping it. The current
implementations of SNDCTL_AUDIOINFO, SNDCTL_MIXERINFO and
SNDCTL_CARDINFO break applications that expect to get information about
a device that is skipped. Related discussion can be found here:
https://reviews.freebsd.org/D45135#1029526

It has to be noted, that other applications, apart from mixer(8), suffer
from this.

PR: 277615
Sponsored by: The FreeBSD Foundation
MFC after: 1 day
Reviewed by: dev_submerge.ch
Differential Revision: https://reviews.freebsd.org/D45256


# fa9896e0 16-Aug-2023 Warner Losh <imp@FreeBSD.org>

Remove $FreeBSD$: two-line nroff pattern

Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/


# 2d3515d6 24-Jan-2023 Christos Margiolis <christos@FreeBSD.org>

mixer(3): Add HEADNAME to TAILQ_HEAD declarations in man page

Forgot to modify the man page in commit 249526dace5d6f.

Reviewed by: markj
Differential Revision: https://reviews.freebsd.org/D38118


# bde84602 20-Mar-2022 Hans Petter Selasky <hselasky@FreeBSD.org>

mixer.4 and mixer.8: Fix mandoc -Tlint errors.

Submitted by: christos@
Differential Revision: https://reviews.freebsd.org/D34603
Sponsored by: NVIDIA Networking


# 5c6935a6 17-Mar-2022 Hans Petter Selasky <hselasky@FreeBSD.org>

mixer.3: Fix spelling

Submitted by: christos@
Differential Revision: https://reviews.freebsd.org/D34378
MFC after: 1 week
Sponsored by: NVIDIA Networking


# ce74223a 20-Nov-2021 Christos Margiolis <christos@FreeBSD.org>

mixer: make .Dt tags uppercase

The document title should be uppercase in man pages.

Reviewed by: imp, gbe
MFC after: 5 days
Differential Revision: https://reviews.freebsd.org/D33027


# db6ba1e0 22-Sep-2021 Hans Petter Selasky <hselasky@FreeBSD.org>

mixer(3) and mixer(8): Update manual pages.

- Use correct e-mail address.
- Set FreeBSD 14.0 as introduction for the updated mixer(8) utility.

Submitted by: christos@
Differential Revision: https://reviews.freebsd.org/D31636
Sponsored by: NVIDIA Networking


# 903873ce 22-Sep-2021 Hans Petter Selasky <hselasky@FreeBSD.org>

Implement and use new mixer(3) library for FreeBSD.

Wiki article: https://wiki.freebsd.org/SummerOfCode2021Projects/SoundMixerImprovements
This project was part of Google Summer of Code 2021.

Submitted by: christos@
Differential Revision: https://reviews.freebsd.org/D31636
Sponsored by: NVIDIA Networking