xref: /freebsd/usr.sbin/mixer/mixer.8 (revision 1130b656e5fe4c2d1ba299e024d1b40eaeebd380)
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.Nm mixer
37.Ar setting
38.Op Ar lvalue:rvalue
39.Nm mixer
40.Ar +rec | -rec
41.Op Ar device
42.Sh DESCRIPTION
43The
44.Nm
45command is used to set and display soundcard mixer settings. It may also be
46used to start and stop recording from the soundcard.  The list of mixer
47settings that may
48be modified are:
49.Pp
50vol, bass, treble, synth, pcm, speaker, mic, cd, mix,
51pcm2, rec, igain, ogain, line1, line2, and line3.
52.Pp
53Not all mixer settings are available on all soundcards.
54.Pp
55When
56.Nm
57is run without any arguments, all settings that are supported by the
58soundcard will be displayed.
59If the
60.Ar setting
61argument is specified, then only the value for
62the
63.Ar setting
64mixer will be displayed.
65.Pp
66To modify the mixer value
67.Ar setting ,
68the optional left and right channel settings of
69.Ar lvalue:rvalue
70may be specified.  The
71.Ar lvalue
72and
73.Ar rvalue
74arguments may be from 0 - 100.
75.Pp
76To start recording, use the
77.Ar +rec
78argument.  To stop recording, use the
79.Ar -rec
80argument.  The optional argument
81.Ar device
82may be specified to use a different
83mixer device.  The default device is
84.Pa /dev/mixer .
85.Sh FILES
86.Bl -tag -width /dev/mixer -compact
87.It Pa /dev/mixer
88The default mixer device.
89.Sh SEE ALSO
90.Xr cdcontrol 1 ,
91.Xr cdplay 1
92.Sh HISTORY
93The
94.Nm
95command first appeared in
96.Fx 2.0.5 .
97.Sh AUTHORS
98Craig Metz and Hannu Savolainen.
99This
100manual page was written by Mike Pritchard
101.Aq mpp@FreeBSD.ORG .
102