FreeBSD Manual Pages
SNDIOCTL(1) General Commands Manual SNDIOCTL(1) NAME sndioctl -- manipulate audio device controls SYNOPSIS sndioctl [-dimnqv] [-f device] [command ...] DESCRIPTION The sndioctl utility can display or manipulate controls of sndio(7) audio devices, like the output level. The options are as follows: -d Dump the raw list of available controls and exit. Useful as a de- bugging tool. -f device Use this sndio(7) audio device. -i Display characteristics of requested controls instead of their val- ues. -m Monitor and display audio controls changes. -n Suppress printing of the variable name. -q Suppress all printing when setting a variable. -v Enable verbose mode, a.k.a. multi-channel mode. By default con- trols affecting different channels of the same stream are disguised as a single mono control to hide details that are not essential. If no commands are specified, all valid controls are displayed on stdout. Unless -d, -m, -n, or -i are used, displayed lines are valid commands. The set of available controls depends on the audio device. Commands use the following two formats to display and change controls re- spectively: [group/]stream[channel].function [group/]stream[channel].function=value On the left-hand side are specified the control group (if any), the af- fected stream name, and the optional channel number. Examples of left-hand side terms: output.level output[0].level If the channel number (including the brackets) is omitted, the command is applied to all channels. Values are numbers between 0 and 1. Two-state controls (switches) take ei- ther 0 or 1 as value, typically corresponding to the off and on states re- spectively. If a decimal is prefixed by the plus (minus) sign then the given value is added to (subtracted from) the current value of the control. If "!" is used instead of a number, then the switch is toggled. EXAMPLES Increase the level control affecting all output channels by 10% of the max- imum: $ sndioctl output.level=+0.1 Mute all output channels: $ sndioctl output.mute=1 Toggle the above mute control: $ sndioctl output.mute=! Allow audio recording and set all input channels to 50%: # sysctl kern.audio.record=1 $ sndioctl input.mute=0 input.level=0.5 SEE ALSO sioctl_open(3) FreeBSD ports 15.quarterly $Mdocdate$ SNDIOCTL(1)
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sndioctl&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>