Add info about the alsa mute_using_playback_switch setting

diff --git a/man/shairport-sync.7 b/man/shairport-sync.7
index e2eed3ab08a2484a032bdeb06d367807b80effbb..0da7ba01bd507610a1ce5c90ede7bfe9ca757b75 100644 (file)
--- 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 243babc30b666c3920fa8e585aa3452956c4e175..c59d89884271a4b9ea7d24ceeaec1e65a383f9b2 100644 (file)
--- 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 2ddab4e2d0bf975c0ae6c960ac56060c4e3c9f38..eaa38ca1fc31266c93d3036df72d9e18e71f9c99 100644 (file)
--- 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>