[docs] documentation about helpers

1 files changed, 35 insertions, 4 deletions

diff --git a/docs/hacking/osx.rst b/docs/hacking/osx.rst
index e80f1d97..8b438e0f 100644
--- a/docs/hacking/osx.rst
+++ b/docs/hacking/osx.rst
@@ -3,7 +3,7 @@
 Setting up a development environment in OSX™
 ============================================
 
-(work in progress)
+.. note: work in progress
 
 * Make sure you're using a new enough version of pip (1.8 or newest).
 This will make all the problems with ``cryptography`` going away, since it will
@@ -19,6 +19,26 @@ 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
 
+Privileged helper
+=================
+
+The OSX privileged helper is in ``src/leap/bitmask/vpn/fw/osx/``.
+
+.. note: move it to vpn/helpers/osx
+
+It is a python daemon that runs as root.
+It should be installed by the Bitmask installer.
+
+If you have to stop it::
+
+  sudo launchctl unload /Library/LaunchDaemons/se.leap.bitmask-helper.plist
+
+
+And, to load it again::
+
+  sudo launchctl load /Library/LaunchDaemons/se.leap.bitmask-helper.plist
+
+
 Debugging bitmask-helper
 ------------------------
 
@@ -30,15 +50,26 @@ tear down the firewall after a crash), you can do it like this with
   echo 'firewall_stop/CMD' | socat - UNIX-CONNECT:/tmp/bitmask-helper.socket
 
 
+Other helpers
+-------------
+
+There are other helpers that the installer drops in a well-know path.
+These are shipped in ``pkg/osx``, and copied to
+``/Applications/Bitmask.app/Contents/Resources``.
+
+.. note: cleanup unused helpers
+
+
 Other notes
------------
+===========
 
-PySide vs QtWebKit:
+PySide vs QtWebKit
+------------------
 
 http://qtwebkit.blogspot.nl/2016/08/qtwebkit-im-back.html
 
 Running OSX on KVM
-==================
+------------------
 
 The following notes are not yet tested, but might be useful for development.