Browse code

import the logs faq entry

Roger Dingledine authored on 07/02/2011 09:48:17
Showing 1 changed files
... ...
@@ -48,6 +48,8 @@
48 48
     <ul>
49 49
     <li><a href="#torrc">I'm supposed to "edit my torrc". What does
50 50
     that mean?</a></li>
51
+    <li><a href="#logs">How do I set up logging, or see Tor's
52
+    logs?</a></li>
51 53
     </ul>
52 54
 
53 55
     <p>Running a Tor client:</p>
... ...
@@ -814,6 +816,87 @@ configuration.
814 816
 
815 817
 <hr>
816 818
 
819
+<a id="logs"></a>
820
+<h3><a class="anchor" href="#logs">How do I set up logging, or see
821
+Tor's logs?</a></h3>
822
+
823
+<p>
824
+If you installed a Tor bundle with Vidalia, then Vidalia has a window
825
+called "Message Log" that will show you Tor's log messages. You can
826
+click on "Settings" to see more details, or to save the messages to a
827
+file also. You're all set.
828
+</p>
829
+
830
+<p>
831
+If you're not using Vidalia, you'll have to go find the log files by
832
+hand as described below.
833
+</p>
834
+
835
+<p>
836
+By default, Tor logs to "standard out" (also knows as "stdout") at
837
+log-level notice. However, some Tor packages (notably the ones for OS X,
838
+Debian, Red Hat, etc) change the default logging so it logs to a file,
839
+and then Tor runs in the background.
840
+</p>
841
+
842
+<p>
843
+If you're using a pre-packaged Tor, here are some likely places for your
844
+logs to go by default:
845
+</p>
846
+
847
+<ul>
848
+<li>On Windows, there are no default log files currently. If you
849
+configure logging to a file in your torrc, they will show up in
850
+<code>\username\Application Data\tor\log\</code> or <code>\Application
851
+Data\tor\log\</code>
852
+</li>
853
+<li>On OS X, Debian, Red Hat, etc, the logs are in /var/log/tor/
854
+</li>
855
+<li>If you compiled Tor from source, your logs will go to
856
+<code>/usr/local/var/log/tor/</code>, but only if you enable them in
857
+the torrc file.
858
+</li>
859
+</ul>
860
+
861
+<p>
862
+If you want to change your logging setup, <a href="#torrc">open your
863
+torrc in an editor</a>.
864
+</p>
865
+
866
+<p>
867
+Find the section (near the top of the file) which contains the following line:
868
+</p>
869
+
870
+<pre>
871
+##torrc go to stdout at level "notice" unless redirected by something else, like one of the below lines.
872
+<pre>
873
+
874
+<p>
875
+Now, assuming you want Tor to send complete debug, info, notice, warn,
876
+and err level messages to a file, append the following line to the end
877
+of the section:
878
+</p>
879
+
880
+<pre>
881
+Log debug file c:/program files/tor/debug.log
882
+</pre>
883
+
884
+<p>
885
+Replace <code>c:/program files/tor/debug.log</code> with a
886
+directory/filename for your Tor log.
887
+</p>
888
+
889
+<p>
890
+If you also want Tor to output to stdout, append the following line to
891
+the section as well:
892
+</p>
893
+
894
+<pre>
895
+Log notice stdout
896
+</pre>
897
+
898
+<hr>
899
+
817 900
 <a id="DoesntWork"></a>
818 901
 <h3><a class="anchor" href="#DoesntWork">I installed Tor and Polipo but
819 902
 it's not working.</a></h3>