diff options
| author | Nick Mathewson <nickm@torproject.org> | 2018-07-01 20:22:55 -0400 |
|---|---|---|
| committer | Nick Mathewson <nickm@torproject.org> | 2018-07-01 20:22:55 -0400 |
| commit | cb1a3674ebb3826d9e1e56146210bd79cb4a42f0 (patch) | |
| tree | 84382a222e7d271efb8426560b61fb1a28ec4e05 /src/lib/err/torerr.c | |
| parent | 83a4946e7b9d2bb75ab8dfa8073c5dd7b3f77bc9 (diff) | |
| download | tor-cb1a3674ebb3826d9e1e56146210bd79cb4a42f0.tar.gz tor-cb1a3674ebb3826d9e1e56146210bd79cb4a42f0.zip | |
File-level documentation for some of src/lib.
Diffstat (limited to 'src/lib/err/torerr.c')
| -rw-r--r-- | src/lib/err/torerr.c | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/src/lib/err/torerr.c b/src/lib/err/torerr.c index 8d8f694f1d..f9e139f967 100644 --- a/src/lib/err/torerr.c +++ b/src/lib/err/torerr.c @@ -9,6 +9,14 @@ * * \brief Handling code for unrecoverable emergencies, at a lower level * than the logging code. + * + * There are plenty of places that things can go wrong in Tor's backend + * libraries: the allocator can fail, the locking subsystem can fail, and so + * on. But since these subsystems are used themselves by the logging module, + * they can't use the logging code directly to report their errors. + * + * As a workaround, the logging code provides this module with a set of raw + * fds to be used for reporting errors in the lowest-level Tor code. */ #include "orconfig.h" |