[tor-commits] [stem/master] FAQ entry about how to reload your torrc

[atagar at torproject.org]

commit 456bc64f2fbd41918dd2db711eaf259a90f200e3
Author: Damian Johnson <atagar at torproject.org>
Date:   Sun Jun 16 14:44:30 2013 -0700

    FAQ entry about how to reload your torrc
---
 docs/faq.rst |   20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index 905b889..999ec2a 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -13,6 +13,7 @@ Frequently Asked Questions
 
  * :ref:`how_do_i_request_a_new_identity_from_tor`
  * :ref:`how_do_i_get_information_about_my_exits`
+ * :ref:`how_do_i_reload_my_torrc`
 
 * **Development**
 
@@ -160,6 +161,25 @@ To learn about the Tor relays you're presently using call :func:`~stem.control.C
     nickname: chaoscomputerclub19
     address: 31.172.30.2
 
+.. _how_do_i_reload_my_torrc:
+
+How do I reload my torrc?
+-------------------------
+
+Tor is configured through its `torrc <https://www.torproject.org/docs/faq.html.en#torrc>`_. When you edit this file you need to either restart Tor or issue a **SIGHUP** for the changes to be reflected. To issue a SIGHUP you can either...
+
+ * Run **pkill -sighup tor**.
+ * Send Tor a **SIGHUP** signal through its control port...
+
+::
+
+  from stem import Signal
+  from stem.control import Controller
+
+  with Controller.from_port(port = 9051) as controller:
+    controller.authenticate()
+    controller.signal(Signal.SIGHUP)
+
 Development
 ===========