version 1.9, 1998/12/16 02:38:50 |
version 1.10, 2000/03/10 18:34:39 |
|
|
The |
The |
.Nm |
.Nm |
command displays or sets various audio system mixing variables. |
command displays or sets various audio system mixing variables. |
If a list of variables is present on the command line, then |
If a list of variables 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 variables for the specified device. |
If the |
By default, |
.Fl a |
|
flag is specified, all variables for the device are printed. |
|
If the |
|
.Fl w |
|
flag is specified |
|
.Nm |
.Nm |
attempts to set the specified variables to the given values. |
operates on the |
|
.Pa /dev/mixer |
|
device. |
.Pp |
.Pp |
|
The options are as follows: |
|
.Bl -tag -width "-w name=value" |
|
.It Fl a |
|
Print all device variables and their current values. |
|
.It Fl w Ar name=value |
|
Attempt to set the specified variable |
|
.Ar name |
|
to |
|
.Ar value . |
|
.It Fl v |
|
Show the possible values of enumeration and set valued variables. |
|
Enumerated values are shown in |
|
.Dq [] |
|
and set values are shown in |
|
.Dq {} . |
|
.It Fl f Ar file |
|
Specify an alternative audio mixing device. |
|
.It Fl n |
|
Suppress printing of the variable name. |
|
.El |
|
.Pp |
Values may be specified in either absolute or relative forms. |
Values may be specified in either absolute or relative forms. |
The relative form is indicated by a prefix of |
The relative form is indicated by a prefix of |
.Dq + |
.Ql + |
or |
or |
.Dq - |
.Ql - |
to denote an increase or decrease respectively. |
to denote an increase or decrease, respectively. |
.Pp |
.Pp |
The |
The exact set of controls that can be manipulated depends on |
.Fl f |
the mixer. |
flag can be used to give an alternative mixer device, the default is |
The general format (in both getting and setting a value) is |
.Pa /dev/mixer . |
|
.Pp |
.Pp |
The |
.Va class.name = value |
.Fl n |
|
flag suppresses printing of the variable name. |
|
.Pp |
.Pp |
The |
The |
.Fl v |
|
flag shows the possible values of enumeration and set valued |
|
variables. Enumerated values are shown in [] and set values |
|
are shown in {}. |
|
.Pp |
|
The exact set of controls that can be manipulated depends on |
|
the mixer. The general format (in both getting and setting a value) |
|
is |
|
.br |
|
.Va "class.name" = value |
|
.br |
|
The |
|
.Va class |
.Va class |
can have values like |
can have values like |
.Li inputs |
.Li inputs |
or |
or |
.Li outputs |
.Li outputs |
indicating that the control affects the input resp. output to the |
indicating that the control affects the input resp. output to the |
mixer. The |
mixer. |
|
The |
.Va name |
.Va name |
indicates what part of the mixer the control affects. |
indicates what part of the mixer the control affects. |
Continuous mixer values, e.g., volume, have numeric values |
Continuous mixer values, e.g., volume, have numeric values |
in the range 0-255. If value can be set for each channel independently |
in the range 0-255. |
the values are printed separated by commas. Discrete mixer values, e.g., |
If value can be set for each channel independently |
the recording source, have symbolic names. Depending on the mixer it |
the values are printed separated by commas. |
|
Discrete mixer values, e.g., |
|
the recording source, have symbolic names. |
|
Depending on the mixer it |
may either be an enumeration or a set. |
may either be an enumeration or a set. |
.Sh EXAMPLES |
.Sh EXAMPLES |
The command |
The command |
|
.Pp |
.Dl "mixerctl -a -v" |
.Dl "mixerctl -a -v" |
|
.Pp |
can produce |
can produce |
.Bd -literal |
.Bd -literal |
inputs.mic=0,0 volume |
inputs.mic=0,0 volume |
|
|
mixer audio device |
mixer audio device |
.El |
.El |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
|
The following environment variables affect the execution of |
|
.Nm mixerctl : |
.Bl -tag -width MIXERDEVICE |
.Bl -tag -width MIXERDEVICE |
.It Ev MIXERDEVICE |
.It Ev MIXERDEVICE |
the mixer device to use. |
The audio mixer device to use. |
|
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr audioctl 1 , |
.Xr audioctl 1 , |
.Xr audio 4 , |
.Xr audio 4 , |
|
|
.Nm |
.Nm |
command first appeared in |
command first appeared in |
.Nx 1.3 . |
.Nx 1.3 . |
|
|