Merge pull request #131 from elliotkillick/master

Fix Qubes PulseAudio (Audio and Microphone) in Kali Linux

docs/os/pentesting/kali.md

@@ -144,6 +144,30 @@ At this point you should have a working template and you can install the tools y
 You can find [a list of Kali Linux `Metapackages` here](https://tools.kali.org/kali-metapackages)
 Keep in mind that the tools you will install can easily take more than 10 GB, [so you will need to **grow** the size of the VM system storage.][qubes-resize-disk-image]
 
+Fix Qubes PulseAudio (audio and microphone)
+---------------------------------------------
+Installing the `kali-defaults` package (which is included in many Kali metapackages including `kali-linux-core`) causes Kali PulseAudio configurations files to be installed that interfere with what Qubes provides. This breaks audio and microphone throughput for that qube.
+
+To fix this, simply do one of the following in the Kali Linux TemplateVM:
+
+### Remove just the conflicting PulseAudio configuration files
+
+1.  Remove the configuration files by running the following command:
+
+```shell_session
+# rm /usr/lib/systemd/user/pulseaudio.service.d/kali_pulseaudio.conf /usr/lib/systemd/user/pulseaudio.socket.d/kali_pulseaudio.socket.conf
+```
+
+### Uninstall the entire `kali-defaults` package
+
+1. Assess the function and contents of the package to see if you need it:
+    - See description: `apt show kali-defaults`
+    - See installed files: `dpkg -L kali-defaults`
+2. If you determine that the package is unnecessary, then uninstall it
+    - `sudo apt remove kali-defaults`
+
+Finally, for both of these options, the Kali Linux qube will have to be restarted for these changes to take effect.
+
 Alternative Options to Kali Linux
 ===================================
 * [PenTester Framework][PTF], with [PTF Qubes OS guide][qubes-ptf]