xref: /dragonfly/usr.sbin/mixer/mixer.8 (revision 984263bc) 
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.\" $FreeBSD: src/usr.sbin/mixer/mixer.8,v 1.10.2.7 2003/03/11 21:13:51 trhodes Exp $
29.\"
30.Dd January 9, 1997
31.Dt MIXER 8
32.Os
33.Sh NAME
34.Nm mixer
35.Nd set/display soundcard mixer values
36.Sh SYNOPSIS
37.Nm
38.Op Fl f Ar device
39.Op Fl s
40.Oo
41.Oo Ar dev
42.Op Ar lvol Ns Op : Ns Ar rvol
43.Cm | recsrc |
44.Sm off
45.Eo \&{
46.Cm ^ | + | - | =
47.Sm on
48.Ec \&} Ns Cm rec
49.Ar rdev
50.Oc
51.Ar ...
52.Oc
53.Sh DESCRIPTION
54The
55.Nm
56utility is used to set and display soundcard mixer device levels.
57It may
58also be used to start and stop recording from the soundcard.  The list
59of mixer devices that may be modified are:
60.Pp
61.Bd -ragged -offset indent
62vol, bass, treble, synth, pcm, speaker, mic, cd, mix,
63pcm2, rec, igain, ogain, line1, line2, and line3.
64.Ed
65.Pp
66Not all mixer devices are available.
67.Pp
68When
69.Nm
70is run without any arguments, all supported devices are displayed
71along with current values.
72If the
73.Ar dev
74argument is specified, the value for the
75.Ar dev
76device will be displayed.
77.Pp
78To modify the mixer value
79.Ar dev ,
80the optional left and right channel settings of
81.Ar lvol Ns Op : Ns Ar rvol
82may be specified.  The
83.Ar lvol
84and
85.Ar rvol
86arguments may be from 0 - 100.  Omitting
87.Ar dev
88and including only the channel settings will change the main volume level.
89.Pp
90If the
91.Fl s
92flag is used, the current mixer values will be displayed in a format suitable
93for use as the command-line arguments to a future invocation of
94.Nm
95(as above).
96.Pp
97To change the recording device you use one of:
98.Bl -tag -width =rec -offset indent
99.It Cm ^rec
100toggles
101.Ar rdev
102of possible recording devices
103.It Cm +rec
104adds
105.Ar rdev
106to possible recording devices
107.It Cm -rec
108removes
109.Ar rdev
110from possible recording devices
111.It Cm =rec
112sets the recording device to
113.Ar rdev
114.El
115.Pp
116The above commands work on an internal mask.  After all the options
117have been parsed, it will set then read the mask from the sound card.
118This will let you see EXACTLY what the soundcard is using for the
119recording device(s).
120.Pp
121The option recsrc will display the current recording devices.
122.Pp
123The option
124.Fl f
125.Ar device
126will open
127.Ar device
128as the mixer device.
129.Sh FILES
130.Bl -tag -width /dev/mixer -compact
131.It Pa /dev/mixer
132the default mixer device
133.El
134.Sh SEE ALSO
135.Xr cdcontrol 1
136.Sh HISTORY
137The
138.Nm
139utility first appeared in
140.Fx 2.0.5 .
141.Sh AUTHORS
142.An -nosplit
143Original source by
144.An Craig Metz Aq cmetz@thor.tjhsst.edu
145and
146.An Hannu Savolainen .
147Mostly rewritten by
148.An John-Mark Gurney Aq jmg@FreeBSD.org .
149This
150manual page was written by
151.An Mike Pritchard Aq mpp@FreeBSD.org .
152