import the logs faq entry
Roger Dingledine commited on 2011-02-07 09:48:17
Zeige 1 geänderte Dateien mit 83 Einfügungen und 0 Löschungen.
- docs/en/faq.wml 769452f66..817e22b39
| ... | ... |
@@ -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> |
| 820 | 903 |