1 .\" Copyright (c) 2009 Sun Microsystems, Inc. All rights reserved.
2 .\" Copyright 2019, Joyent, Inc.
3 .\" The contents of this file are subject to the terms of the
4 .\" Common Development and Distribution License (the "License").
5 .\" You may not use this file except in compliance with the License.
6 .\"
7 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
8 .\" or http://www.opensolaris.org/os/licensing.
9 .\" See the License for the specific language governing permissions
10 .\" and limitations under the License.
11 .\"
12 .\" When distributing Covered Code, include this CDDL HEADER in each
13 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
14 .\" If applicable, add the following below this CDDL HEADER, with the
15 .\" fields enclosed by brackets "[]" replaced with your own identifying
16 .\" information: Portions Copyright [yyyy] [name of copyright owner]
17 .Dd February 1, 2019
18 .Dt MIXER 7I
19 .Os
20 .Sh NAME
21 .Nm mixer
22 .Nd generic mixer device interface
23 .Sh SYNOPSIS
24 .In sys/soundcard.h
25 .Sh DESCRIPTION
26 .Ss "Mixer Pseudo-Device"
27 The
28 .Pa /dev/mixer
29 pseudo-device is provided for two purposes:
30 .Bl -bullet -offset indent
31 .It
32 The first purpose is for applications that wish to learn about the list of
33 audio devices on the system, so that they can select (or provide for users to
34 select) an appropriate audio device.
35 The
36 .Pa /dev/mixer
37 pseudo-device
421 .Dv SNDCTL_MIX_NREXT
422 description.
423 .Pp
424 The priority is used by the framework to assign a preference that applications
425 can use in choosing a device.
426 Higher values are preferable.
427 Mixers with priorities less than -1 should never be selected by default.
428 .Pp
429 The
430 .Fa devnode
431 field contains the actual full path to the device node for
432 the physical mixer, such as
433 .Pa /dev/sound/audio810:0mixer .
434 Applications
435 should open this file to access the mixer settings.
436 .El
437 .Ss "Mixer Extension IOCTLs"
438 The pseudo
439 .Pa /dev/mixer
440 device supports ioctls that can change the
441 oarious settings for the audio hardware in the system.
442 .Pp
443 Those ioctls should only be used by dedicated mixer applications or desktop
444 olumme controls, and not by typical ordinary audio applications such as media
445 players.
446 Ordinary applications that wish to adjust their own volume settings
447 should use the
448 .Dv SNDCTL_DSP_SETPLAYVOL
449 or
450 .Dv SNDCTL_DSP_SETRECVOL
451 ioctls for that purpose.
452 See
453 .Xr dsp 7I
454 for more information.
455 Ordinary
456 applications should never attempt to change master port selection or hardware
457 settings such as monitor gain settings.
458 .Pp
459 The ioctls in this section can only be used to access the mixer device that is
460 associated with the current file descriptor.
461 .Pp
462 Applications should not assume that a single
463 .Pa /dev/mixer
464 node is able to access any physical settings.
|
1 .\" Copyright (c) 2009 Sun Microsystems, Inc. All rights reserved.
2 .\" Copyright 2019, Joyent, Inc.
3 .\" The contents of this file are subject to the terms of the
4 .\" Common Development and Distribution License (the "License").
5 .\" You may not use this file except in compliance with the License.
6 .\"
7 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
8 .\" or http://www.opensolaris.org/os/licensing.
9 .\" See the License for the specific language governing permissions
10 .\" and limitations under the License.
11 .\"
12 .\" When distributing Covered Code, include this CDDL HEADER in each
13 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
14 .\" If applicable, add the following below this CDDL HEADER, with the
15 .\" fields enclosed by brackets "[]" replaced with your own identifying
16 .\" information: Portions Copyright [yyyy] [name of copyright owner]
17 .Dd February 17, 2020
18 .Dt MIXER 7I
19 .Os
20 .Sh NAME
21 .Nm mixer
22 .Nd generic mixer device interface
23 .Sh SYNOPSIS
24 .In sys/soundcard.h
25 .Sh DESCRIPTION
26 .Ss "Mixer Pseudo-Device"
27 The
28 .Pa /dev/mixer
29 pseudo-device is provided for two purposes:
30 .Bl -bullet -offset indent
31 .It
32 The first purpose is for applications that wish to learn about the list of
33 audio devices on the system, so that they can select (or provide for users to
34 select) an appropriate audio device.
35 The
36 .Pa /dev/mixer
37 pseudo-device
421 .Dv SNDCTL_MIX_NREXT
422 description.
423 .Pp
424 The priority is used by the framework to assign a preference that applications
425 can use in choosing a device.
426 Higher values are preferable.
427 Mixers with priorities less than -1 should never be selected by default.
428 .Pp
429 The
430 .Fa devnode
431 field contains the actual full path to the device node for
432 the physical mixer, such as
433 .Pa /dev/sound/audio810:0mixer .
434 Applications
435 should open this file to access the mixer settings.
436 .El
437 .Ss "Mixer Extension IOCTLs"
438 The pseudo
439 .Pa /dev/mixer
440 device supports ioctls that can change the
441 various settings for the audio hardware in the system.
442 .Pp
443 Those ioctls should only be used by dedicated mixer applications or desktop
444 volume controls, and not by typical ordinary audio applications such as media
445 players.
446 Ordinary applications that wish to adjust their own volume settings
447 should use the
448 .Dv SNDCTL_DSP_SETPLAYVOL
449 or
450 .Dv SNDCTL_DSP_SETRECVOL
451 ioctls for that purpose.
452 See
453 .Xr dsp 7I
454 for more information.
455 Ordinary
456 applications should never attempt to change master port selection or hardware
457 settings such as monitor gain settings.
458 .Pp
459 The ioctls in this section can only be used to access the mixer device that is
460 associated with the current file descriptor.
461 .Pp
462 Applications should not assume that a single
463 .Pa /dev/mixer
464 node is able to access any physical settings.
|