xref: /freebsd/usr.sbin/mixer/mixer.8 (revision a8445737e740901f5f2c8d24c12ef7fc8b00134e)
1.\" Copyright (c) 1997
2.\"	Mike Pritchard <mpp@FreeBSD.ORG>.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. Neither the name of the author nor the names of its contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"    without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY MIKE PRITCHARD AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd January 9, 1997
29.Dt MIXER 8
30.Os
31.Sh NAME
32.Nm mixer
33.Nd set/display soundcard mixer values
34.Sh SYNOPSIS
35.Nm
36.Op Fl f Ar device
37.Oo
38.Oo Ns
39.Ar dev Op Ar lvol Ns Op Ar :rvol
40.Li | recsrc |
41.Ar {^|+|-|=}rec rdev
42.Oc
43.Ar ... \&
44.Oc
45.Sh DESCRIPTION
46The
47.Nm
48command is used to set and display soundcard mixer device levels. It may
49also be used to start and stop recording from the soundcard.  The list
50of mixer devices that may be modified are:
51.Pp
52.Bd -ragged -offset indent
53vol, bass, treble, synth, pcm, speaker, mic, cd, mix,
54pcm2, rec, igain, ogain, line1, line2, and line3.
55.Ed
56.Pp
57Not all mixer devices are available.
58.Pp
59When
60.Nm
61is run without any arguments, all supported devices are displayed
62along with current values.
63If the
64.Ar dev
65argument is specified, the value for the
66.Ar dev
67device will be displayed.
68.Pp
69To modify the mixer value
70.Ar dev ,
71the optional left and right channel settings of
72.Ar lvol Ns Op Ar :rvol
73may be specified.  The
74.Ar lvol
75and
76.Ar rvol
77arguments may be from 0 - 100.
78.Pp
79To change the recording device you use one of:
80.Bl -tag -width =rec -offset indent
81.It ^rec
82toggles
83.Ar rdev
84of possible recording devices
85.It +rec
86adds
87.Ar rdev
88to possible recording devices
89.It -rec
90removes
91.Ar rdev
92from possible recording devices
93.It =rec
94sets the recording device to
95.Ar rdev
96.El
97.Pp
98The above commands work on an internal mask.  After all the options
99have been parsed, it will set then read the mask from the sound card.
100This will let you see EXACTLY what the soundcard is using for the
101recording device(s).
102.Pp
103The option recsrc will display the current recording devices.
104.Pp
105The option
106.Fl f
107.Ar device
108will open
109.Ar device
110as the mixer device.
111This will ONLY work if the
112.Fl f
113option is immediately after the
114.Nm
115command.
116.Sh FILES
117.Bl -tag -width /dev/mixer -compact
118.It Pa /dev/mixer
119The default mixer device.
120.Sh SEE ALSO
121.Xr cdcontrol 1 ,
122.Xr cdplay 1
123.Sh HISTORY
124The
125.Nm
126command first appeared in
127.Fx 2.0.5 .
128.Sh AUTHORS
129Original source by
130.An Craig Metz Aq cmetz@thor.tjhsst.edu
131and
132.An Hannu Savolainen .
133Mostly rewriten by
134.An John-Mark Gurney Aq jmg@FreeBSD.org .
135This
136manual page was written by
137.An Mike Pritchard Aq mpp@FreeBSD.org .
138