share/man/man5/mixerctl.conf.5

   1 .\"     $NetBSD: mixerctl.conf.5,v 1.5 2003/02/14 15:20:20 grant 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
  37 The
  38 .Pa /etc/mixerctl.conf
  39 file consists of
  40 .Xr mixerctl 1
  41 variables to set at boot time.
  42 Each line of
  43 .Nm
  44 has the following format:
  45 .Dl variable=value
  46 .Pp
  47 To generate a
  48 .Nm
  49 from the current mixer settings, execute:
  50 .Dl Ic mixerctl -a \*[Gt] /etc/mixerctl.conf
  51 .Pp
  52 Set
  53 .Sy mixerctl
  54 to YES in
  55 .Xr rc.conf 5
  56 to have the variables set at boot time.
  57 Additionally, you can have the settings saved
  58 and restored for the devices of your choice by listing them in
  59 .Sy mixerctl_mixers
  60 in
  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
  67 Example mixer settings for an
  68 .Xr esa 4
  69 audio adapter:
  70 .Bd -literal
  71 outputs.master=255,255
  72 outputs.master.mute=off
  73 outputs.mono=255
  74 outputs.mono.mute=on
  75 outputs.mono.source=mixerout
  76 outputs.headphones=255,255
  77 outputs.headphones.mute=off
  78 outputs.tone=255,255
  79 inputs.speaker=255
  80 inputs.speaker.mute=off
  81 inputs.phone=191
  82 inputs.phone.mute=on
  83 inputs.mic=191
  84 inputs.mic.mute=on
  85 inputs.mic.preamp=off
  86 inputs.mic.source=mic0
  87 inputs.line=191,191
  88 inputs.line.mute=on
  89 inputs.cd=191,191
  90 inputs.cd.mute=on
  91 inputs.video=255,255
  92 inputs.video.mute=off
  93 inputs.aux=255,255
  94 inputs.aux.mute=off
  95 inputs.dac=191,191
  96 inputs.dac.mute=off
  97 record.source=mic
  98 record.volume=255,255
  99 record.volume.mute=off
 100 record.mic=0
 101 record.mic.mute=off
 102 outputs.loudness=off
 103 outputs.spatial=off
 104 outputs.spatial.center=0
 105 outputs.spatial.depth=0
 106 .Ed
 107 .Sh SEE ALSO
 108 .Xr mixerctl 1 ,
 109 .Xr rc.conf 5
 110 .Sh HISTORY
 111 The
 112 .Nm
 113 configuration file first appeared in
 114 .Nx 2.0 .