summaryrefslogtreecommitdiff
path: root/docs/hacking/manhole.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/hacking/manhole.rst')
-rw-r--r--docs/hacking/manhole.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/hacking/manhole.rst b/docs/hacking/manhole.rst
new file mode 100644
index 0000000..cea3581
--- /dev/null
+++ b/docs/hacking/manhole.rst
@@ -0,0 +1,24 @@
+.. _manhole:
+
+The manhole HowTo
+-------------------------------------------------
+
+Troubles with Bitmask Daemon? Don't panic! Just SSH into it
+
+If you want to inspect the objects living in your application memory, in
+realtime, you can ssh into it.
+
+For that, you must add the following section to your ``bitmaskd.cfg``
+configuration file::
+
+ [manhole]
+ user = bitmask
+ passwd = <yoursecret>
+ port = 22900
+
+
+And then you can ssh into your application::
+
+ ssh bitmask@localhost -p 22900
+
+Did I mention how *awesome* twisted is?? ``:)``