From 6f961fc09dd633d0bcf5397787139c0032e0661e Mon Sep 17 00:00:00 2001
From: "Kali Kaneko (leap communications)" <kali@leap.se>
Date: Wed, 7 Jun 2017 17:32:35 +0200
Subject: [docs] note about debugging osx helper

---
 docs/hacking/osx.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'docs')

diff --git a/docs/hacking/osx.rst b/docs/hacking/osx.rst
index 3a75dea7..e80f1d97 100644
--- a/docs/hacking/osx.rst
+++ b/docs/hacking/osx.rst
@@ -19,6 +19,17 @@ workaround in an issue in qutebrowser's repo, works fine for me for now::
   https://raw.githubusercontent.com/Homebrew/homebrew/f802822b0fa35ad362aebd0101ccf83a638bed37/Library/Formula/{py,}qt5.rb
   brew install qt5 pyqt5
 
+Debugging bitmask-helper
+------------------------
+
+Bitmask communicates with the privileged ``bitmask-helper`` through a unix
+socket. If you need to debug the privileged helper (for instance, if you need to
+tear down the firewall after a crash), you can do it like this with
+``socat``::
+
+  echo 'firewall_stop/CMD' | socat - UNIX-CONNECT:/tmp/bitmask-helper.socket
+
+
 Other notes
 -----------
 
-- 
cgit v1.2.3