From: Mike Brady <mikebrady@eircom.net>
Date: Tue, 1 Aug 2017 14:06:16 +0000 (+0200)
Subject: Add info about the alsa mute_using_playback_switch setting
X-Git-Tag: 3.1~10^2~7
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4c5464102bb0e36e1564200609ebb416ec2f7d93;p=thirdparty%2Fshairport-sync.git

Add info about the alsa mute_using_playback_switch setting
---

diff --git a/man/shairport-sync.7 b/man/shairport-sync.7
index e2eed3ab..0da7ba01 100644
--- a/man/shairport-sync.7
+++ b/man/shairport-sync.7
@@ -187,6 +187,11 @@ Use this optional advanced setting to set the alsa buffer size near to this valu
 \fBuse_mmap_if_available=\f1\fI"yes"\f1\fB;\f1
 Use this optional advanced setting to control whether MMAP-based output is used to communicate with the DAC. Default is \fI"yes"\f1.
 .TP
+\fBmute_using_playback_switch=\f1\fI"yes"\f1\fB;\f1
+This is an advanced setting and the default is \fI"yes"\f1, which means that hardware mute will be implemented using a feature called a 'playback switch', where one is available; set it to \fI"no"\f1 to prevent the playback switch being used.
+
+The motivation for this is to avoid using the alsa function call "snd_mixer_selem_set_playback_switch_all", which is incorrectly implemented on certain soundcards, including the emulated card in VMWare Fusion 8.5.
+.TP
 \fB"SNDIO" SETTINGS\f1
 These settings are for the SNDIO back end, used to communicate with audio output devices in the SNDIO system.
 .TP
diff --git a/man/shairport-sync.7.xml b/man/shairport-sync.7.xml
index 243babc3..c59d8988 100644
--- a/man/shairport-sync.7.xml
+++ b/man/shairport-sync.7.xml
@@ -332,9 +332,16 @@
     <p><opt>use_mmap_if_available=</opt><arg>"yes"</arg><opt>;</opt></p>
     <optdesc><p> Use this optional advanced setting to control whether MMAP-based output is used to communicate with the DAC. Default is <arg>"yes"</arg>.</p></optdesc>
     </option>
-
-
-
+    
+    <option>
+    <p><opt>mute_using_playback_switch=</opt><arg>"yes"</arg><opt>;</opt></p>
+    <optdesc>
+    <p>This is an advanced setting and the default is <arg>"yes"</arg>, which means that hardware mute will be implemented using a feature called a 'playback switch', where one is available;
+    set it to <arg>"no"</arg> to prevent the playback switch being used.</p>
+    <p>The motivation for this is to avoid using the alsa function call
+    "snd_mixer_selem_set_playback_switch_all", which is incorrectly implemented on certain soundcards, including the emulated card in VMWare Fusion 8.5.</p>
+    </optdesc>
+    </option>
     <option><p><opt>"SNDIO" SETTINGS</opt></p></option>
      <p>These settings are for the SNDIO back end, used to communicate with audio output devices in the SNDIO system.</p>
     <option>
diff --git a/man/shairport-sync.html b/man/shairport-sync.html
index 2ddab4e2..eaa38ca1 100644
--- a/man/shairport-sync.html
+++ b/man/shairport-sync.html
@@ -313,9 +313,16 @@
     <p><b>use_mmap_if_available=</b><em>&quot;yes&quot;</em><b>;</b></p>
     <p> Use this optional advanced setting to control whether MMAP-based output is used to communicate with the DAC. Default is <em>&quot;yes&quot;</em>.</p>
     
-
-
-
+    
+    
+    <p><b>mute_using_playback_switch=</b><em>&quot;yes&quot;</em><b>;</b></p>
+    
+    <p>This is an advanced setting and the default is <em>&quot;yes&quot;</em>, which means that hardware mute will be implemented using a feature called a 'playback switch', where one is available;
+    set it to <em>&quot;no&quot;</em> to prevent the playback switch being used.</p>
+    <p>The motivation for this is to avoid using the alsa function call
+    &quot;snd_mixer_selem_set_playback_switch_all&quot;, which is incorrectly implemented on certain soundcards, including the emulated card in VMWare Fusion 8.5.</p>
+    
+    
     <p><b>&quot;SNDIO&quot; SETTINGS</b></p>
      <p>These settings are for the SNDIO back end, used to communicate with audio output devices in the SNDIO system.</p>