version 1.5, 2020/04/23 00:16:59 |
version 1.6, 2020/04/23 05:54:35 |
|
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
command displays or sets various audio device variables. |
command displays or sets various audio device controls. |
If a list of variables is present on the command line, |
If a list of control names is present on the command line, |
.Nm |
.Nm |
prints the current value of those variables for the specified device. |
prints the current value of those controls for the specified device. |
Variables can also be set at system startup using the configuration file |
Controls can also be set up at system startup using the configuration file |
.Xr mixerctl.conf 5 . |
.Xr mixerctl.conf 5 . |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width "-f file" |
.Bl -tag -width "-f file" |
.It Fl a |
.It Fl a |
Print all device variables and their current values. |
Print all device controls and their current values. |
This is the default, if no parameters are given to |
This is the default, if no parameters are given to |
.Nm . |
.Nm . |
.It Fl f Ar file |
.It Fl f Ar file |
|
|
The default is |
The default is |
.Pa /dev/audioctl0 . |
.Pa /dev/audioctl0 . |
.It Fl n |
.It Fl n |
Suppress printing of the variable name. |
Suppress printing of the control name. |
.It Fl q |
.It Fl q |
Suppress all printing when setting a variable. |
Suppress all printing when setting a control. |
.It Fl t |
.It Fl t |
Toggle. |
Toggle. |
Attempt to select the next possible value |
Attempt to select the next possible value |
of an enum |
of an enum |
(see below). |
(see below). |
.It Fl v |
.It Fl v |
Show all possible values of variables. |
Show all possible values of controls. |
Enum values are shown in |
Enum values are shown in |
.Sq [] |
.Sq [] |
and values belonging to a set are shown in |
and values belonging to a set are shown in |
.Sq {} |
.Sq {} |
(see below). |
(see below). |
.It Ar name Ns = Ns Ar value |
.It Ar name Ns = Ns Ar value |
Attempt to set the specified variable |
Attempt to set the control with given |
.Ar name |
.Ar name |
to |
to |
.Ar value . |
.Ar value . |
|
|
configuration file. |
configuration file. |
.El |
.El |
.Sh EXAMPLES |
.Sh EXAMPLES |
Show possible values for all device variables, |
Show possible values for all controls, |
and their current settings: |
and their current settings: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
# mixerctl -av |
# mixerctl -av |