summaryrefslogtreecommitdiff
path: root/doc/HACKING
diff options
context:
space:
mode:
authorRoger Dingledine <arma@torproject.org>2006-10-11 20:45:01 +0000
committerRoger Dingledine <arma@torproject.org>2006-10-11 20:45:01 +0000
commit7f3fc70945e8f3286c9701c168fa364003949b3e (patch)
tree2a40331258cd8852b78010166ae1de0b7ba2853e /doc/HACKING
parentedbda1c1266a5b89d8330b748d6eff747640af9f (diff)
downloadtor-7f3fc70945e8f3286c9701c168fa364003949b3e.tar.gz
tor-7f3fc70945e8f3286c9701c168fa364003949b3e.zip
simplify a section of the HACKING file
svn:r8689
Diffstat (limited to 'doc/HACKING')
-rw-r--r--doc/HACKING24
1 files changed, 8 insertions, 16 deletions
diff --git a/doc/HACKING b/doc/HACKING
index 81424a26b5..3c01554588 100644
--- a/doc/HACKING
+++ b/doc/HACKING
@@ -37,22 +37,14 @@
1.4. Log conventions
- Log convention: use only these four log severities.
-
- ERR is if something fatal just happened.
- WARN if something bad happened, but we're still running. The
- bad thing is either a bug in the code, an attack or buggy
- protocol/implementation of the remote peer, etc. The operator should
- examine the bad thing and try to correct it.
- NOTICE if it's something the operator will want to know about.
- (No error or warning messages should be expected during normal OR or OP
- operation. I expect most people to run on -l notice eventually. If a
- library function is currently called such that failure always means
- ERR, then the library function should log WARN and let the caller
- log ERR.)
- INFO means something happened (maybe bad, maybe ok), but there's nothing
- you need to (or can) do about it.
- DEBUG is for everything louder than INFO.
+ http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#LogLevels
+
+ No error or warning messages should be expected during normal OR or OP
+ operation.
+
+ If a library function is currently called such that failure always
+ means ERR, then the library function should log WARN and let the caller
+ log ERR.
[XXX Proposed convention: every message of severity INFO or higher should
either (A) be intelligible to end-users who don't know the Tor source; or