xref: /netbsd-src/share/man/man5/mixerctl.conf.5 (revision 01869ca4d24a86379a68731bf9706a9f0820fe4e)
1.\"	$NetBSD: mixerctl.conf.5,v 1.7 2017/07/03 21:30:59 wiz Exp $
2.\"
3.\" Copyright 2002 Jared D. McNeill <jmcneill@NetBSD.org>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. The name of the author may not be used to endorse or promote products
15.\"    derived from this software without specific prior written permission.
16.\"
17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27.\"
28.Dd April 5, 2003
29.Dt MIXERCTL.CONF 5
30.Os
31.Sh NAME
32.Nm mixerctl.conf
33.Nd audio mixer configuration file
34.Sh SYNOPSIS
35.Nm
36.Sh DESCRIPTION
37The
38.Pa /etc/mixerctl.conf
39file consists of
40.Xr mixerctl 1
41variables to set at boot time.
42Each line of
43.Nm
44has the following format:
45.Dl variable=value
46.Pp
47To generate a
48.Nm
49from the current mixer settings, execute:
50.Dl Ic mixerctl -a > /etc/mixerctl.conf
51.Pp
52Set
53.Sy mixerctl
54to YES in
55.Xr rc.conf 5
56to have the variables set at boot time.
57Additionally, you can have the settings saved
58and restored for the devices of your choice by listing them in
59.Sy mixerctl_mixers
60in
61.Xr rc.conf 5 .
62.Sh FILES
63.Bl -tag -width /etc/mixerctl.conf -compact
64.It Pa /etc/mixerctl.conf
65.El
66.Sh EXAMPLES
67Example mixer settings for an
68.Xr esa 4
69audio adapter:
70.Bd -literal
71outputs.master=255,255
72outputs.master.mute=off
73outputs.mono=255
74outputs.mono.mute=on
75outputs.mono.source=mixerout
76outputs.headphones=255,255
77outputs.headphones.mute=off
78outputs.tone=255,255
79inputs.speaker=255
80inputs.speaker.mute=off
81inputs.phone=191
82inputs.phone.mute=on
83inputs.mic=191
84inputs.mic.mute=on
85inputs.mic.preamp=off
86inputs.mic.source=mic0
87inputs.line=191,191
88inputs.line.mute=on
89inputs.cd=191,191
90inputs.cd.mute=on
91inputs.video=255,255
92inputs.video.mute=off
93inputs.aux=255,255
94inputs.aux.mute=off
95inputs.dac=191,191
96inputs.dac.mute=off
97record.source=mic
98record.volume=255,255
99record.volume.mute=off
100record.mic=0
101record.mic.mute=off
102outputs.loudness=off
103outputs.spatial=off
104outputs.spatial.center=0
105outputs.spatial.depth=0
106.Ed
107.Sh SEE ALSO
108.Xr mixerctl 1 ,
109.Xr rc.conf 5
110.Sh HISTORY
111The
112.Nm
113configuration file first appeared in
114.Nx 2.0 .
115