aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2011-01-25 15:02:36 -0500
committerNick Mathewson <nickm@torproject.org>2011-01-25 15:02:36 -0500
commit23f8bedddb1b3497ea8bbafef90ae24893be9a9e (patch)
tree1637341a108e9cac4eb2220e428058ea02cb365b /doc
parent68f8ca357fa98e7a2ed4ab45e4b982ea2ca370c8 (diff)
downloadtor-23f8bedddb1b3497ea8bbafef90ae24893be9a9e.tar
tor-23f8bedddb1b3497ea8bbafef90ae24893be9a9e.tar.gz
Add manpage entry for logging domains
Fixes issue 2215.
Diffstat (limited to 'doc')
-rw-r--r--doc/tor.1.txt23
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index c8608eb84..9a7ee07e7 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -323,6 +323,29 @@ Other options can be specified either on the command-line (--option
Messages are sent to all the logs that match their severity
level.
+**Log** **[**__domain__,...**]**__minSeverity__[-__maxSeverity__] ... **file** __FILENAME__ +
+
+**Log** **[**__domain__,...**]**__minSeverity__[-__maxSeverity__] ... **stderr**|**stdout**|**syslog** ::
+ As above, but select messages by range of log severity __and__ by a
+ set of "logging domains". Each logging domain corresponds to an area of
+ functionality inside Tor. You can specify any number of severity ranges
+ for a single log statement, each of them prefixed by a comma-separated
+ list of logging domains. You can prefix a domain with ~ to indicate
+ negation, and use * to indicate "all domains". If you specify a severity
+ range without a list of domains, it matches all domains. +
+ +
+ This is an advanced feature which is most useful for debugging one or two
+ of Tor's subsystems at a time. +
+ +
+ The currently recognized domains are: general, crypto, net, config, fs,
+ protocol, mm, http, app, control, circ, rend, bug, dir, dirserv, or, edge,
+ acct, hist, and handshake. Domain names are case-insensitive. +
+ +
+ For example, "`Log [handshake]debug [*,~net,~mm]info notice stdout`" sends
+ to stdout: all handshake messages of any severity, all info-and-higher
+ messages from domains other than networking and memory management, and all
+ messages of severity notice or higher.
+
**OutboundBindAddress** __IP__::
Make all outbound connections originate from the IP address specified. This
is only useful when you have multiple network interfaces, and you want all