xref: /netbsd-src/usr.bin/mixerctl/mixerctl.1 (revision 4d7e773266e3c3f48566c86c0ad52d51c6454fd1)
1.\" $NetBSD: mixerctl.1,v 1.4 1997/10/19 05:09:35 lukem Exp $
2.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
3.\" All rights reserved.
4.\"
5.\" Author: Lennart Augustsson
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"        This product includes software developed by the NetBSD
18.\"        Foundation, Inc. and its contributors.
19.\" 4. Neither the name of The NetBSD Foundation nor the names of its
20.\"    contributors may be used to endorse or promote products derived
21.\"    from this software without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
24.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
25.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
26.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
27.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33.\" POSSIBILITY OF SUCH DAMAGE.
34.\"
35.Dd May 4, 1997
36.Dt MIXERCTL 1
37.Os
38.Sh NAME
39.Nm mixerctl
40.Nd control audio mixing
41.Sh SYNOPSIS
42.Nm
43.Op Fl f Ar file
44.Op Fl n
45.Op Fl v
46.Fl a
47.Nm ""
48.Op Fl f Ar file
49.Op Fl n
50.Op Fl v
51.Ar name ...
52.Nm ""
53.Op Fl f Ar file
54.Op Fl n
55.Fl w
56.Ar name=value ...
57.Sh DESCRIPTION
58The
59.Nm
60command displays or sets various audio system mixing variables.
61If a list of variables is present on the command line, then
62.Nm
63prints the current value of those variables for the specified device.
64If the
65.Fl a
66flag is specified, all variables for the device are printed.
67If the
68.Fl w
69flag is specified
70.Nm
71attempts to set the specified variables to the given values.
72.Pp
73The
74.Fl f
75flag can be used to give an alternative mixer device, the default is
76.Pa /dev/mixer.
77.Pp
78The
79.Fl n
80flag suppresses printing of the variable name.
81.Pp
82The
83.Fl v
84flag shows the possible values of enumeration and set valued
85variables.  Enumerated values are shown in [] and set values
86are shown in {}.
87.Sh FILES
88.Bl -tag -width /dev/mixer
89.It Pa /dev/mixer
90mixer audio device
91.El
92.Sh SEE ALSO
93.Xr audioctl 1 ,
94.Xr audio 4 ,
95.Xr sysctl 8
96.Sh HISTORY
97The
98.Nm
99command first appeared in
100.Nx 1.3 .
101
102