diff options
author | Roger Dingledine <arma@torproject.org> | 2006-10-11 20:45:01 +0000 |
---|---|---|
committer | Roger Dingledine <arma@torproject.org> | 2006-10-11 20:45:01 +0000 |
commit | 7f3fc70945e8f3286c9701c168fa364003949b3e (patch) | |
tree | 2a40331258cd8852b78010166ae1de0b7ba2853e /doc/HACKING | |
parent | edbda1c1266a5b89d8330b748d6eff747640af9f (diff) | |
download | tor-7f3fc70945e8f3286c9701c168fa364003949b3e.tar.gz tor-7f3fc70945e8f3286c9701c168fa364003949b3e.zip |
simplify a section of the HACKING file
svn:r8689
Diffstat (limited to 'doc/HACKING')
-rw-r--r-- | doc/HACKING | 24 |
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 |