summaryrefslogtreecommitdiff
path: root/src/common/torlog.h
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2018-06-22 10:30:45 -0400
committerNick Mathewson <nickm@torproject.org>2018-06-22 10:31:51 -0400
commit97b15a1d7c51764888d2172711e3f3a71fb01916 (patch)
tree2d7be35820f099e0d7da91f0e4eb49baa99476e4 /src/common/torlog.h
parent2cf033f238c111bef62552da16117568435d3a18 (diff)
downloadtor-97b15a1d7c51764888d2172711e3f3a71fb01916.tar.gz
tor-97b15a1d7c51764888d2172711e3f3a71fb01916.zip
Extract the locking and logging code
The locking code gets its own module, since it's more fundamental than the higher-level locking code. Extracting the logging code was the whole point here. :)
Diffstat (limited to 'src/common/torlog.h')
-rw-r--r--src/common/torlog.h274
1 files changed, 0 insertions, 274 deletions
diff --git a/src/common/torlog.h b/src/common/torlog.h
deleted file mode 100644
index 6814cc9d0b..0000000000
--- a/src/common/torlog.h
+++ /dev/null
@@ -1,274 +0,0 @@
-/* Copyright (c) 2001, Matej Pfajfar.
- * Copyright (c) 2001-2004, Roger Dingledine.
- * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
- * Copyright (c) 2007-2018, The Tor Project, Inc. */
-/* See LICENSE for licensing information */
-
-/**
- * \file torlog.h
- *
- * \brief Headers for log.c
- **/
-
-#ifndef TOR_TORLOG_H
-
-#include <stdarg.h>
-#include "lib/cc/torint.h"
-#include "lib/cc/compat_compiler.h"
-#include "lib/testsupport/testsupport.h"
-
-#ifdef HAVE_SYSLOG_H
-#include <syslog.h>
-#define LOG_WARN LOG_WARNING
-#if LOG_DEBUG < LOG_ERR
-#error "Your syslog.h thinks high numbers are more important. " \
- "We aren't prepared to deal with that."
-#endif
-#else /* !(defined(HAVE_SYSLOG_H)) */
-/* Note: Syslog's logging code refers to priorities, with 0 being the most
- * important. Thus, all our comparisons needed to be reversed when we added
- * syslog support.
- *
- * The upshot of this is that comments about log levels may be messed up: for
- * "maximum severity" read "most severe" and "numerically *lowest* severity".
- */
-
-/** Debug-level severity: for hyper-verbose messages of no interest to
- * anybody but developers. */
-#define LOG_DEBUG 7
-/** Info-level severity: for messages that appear frequently during normal
- * operation. */
-#define LOG_INFO 6
-/** Notice-level severity: for messages that appear infrequently
- * during normal operation; that the user will probably care about;
- * and that are not errors.
- */
-#define LOG_NOTICE 5
-/** Warn-level severity: for messages that only appear when something has gone
- * wrong. */
-#define LOG_WARN 4
-/** Error-level severity: for messages that only appear when something has gone
- * very wrong, and the Tor process can no longer proceed. */
-#define LOG_ERR 3
-#endif /* defined(HAVE_SYSLOG_H) */
-
-/* Logging domains */
-
-/** Catch-all for miscellaneous events and fatal errors. */
-#define LD_GENERAL (1u<<0)
-/** The cryptography subsystem. */
-#define LD_CRYPTO (1u<<1)
-/** Networking. */
-#define LD_NET (1u<<2)
-/** Parsing and acting on our configuration. */
-#define LD_CONFIG (1u<<3)
-/** Reading and writing from the filesystem. */
-#define LD_FS (1u<<4)
-/** Other servers' (non)compliance with the Tor protocol. */
-#define LD_PROTOCOL (1u<<5)
-/** Memory management. */
-#define LD_MM (1u<<6)
-/** HTTP implementation. */
-#define LD_HTTP (1u<<7)
-/** Application (socks) requests. */
-#define LD_APP (1u<<8)
-/** Communication via the controller protocol. */
-#define LD_CONTROL (1u<<9)
-/** Building, using, and managing circuits. */
-#define LD_CIRC (1u<<10)
-/** Hidden services. */
-#define LD_REND (1u<<11)
-/** Internal errors in this Tor process. */
-#define LD_BUG (1u<<12)
-/** Learning and using information about Tor servers. */
-#define LD_DIR (1u<<13)
-/** Learning and using information about Tor servers. */
-#define LD_DIRSERV (1u<<14)
-/** Onion routing protocol. */
-#define LD_OR (1u<<15)
-/** Generic edge-connection functionality. */
-#define LD_EDGE (1u<<16)
-#define LD_EXIT LD_EDGE
-/** Bandwidth accounting. */
-#define LD_ACCT (1u<<17)
-/** Router history */
-#define LD_HIST (1u<<18)
-/** OR handshaking */
-#define LD_HANDSHAKE (1u<<19)
-/** Heartbeat messages */
-#define LD_HEARTBEAT (1u<<20)
-/** Abstract channel_t code */
-#define LD_CHANNEL (1u<<21)
-/** Scheduler */
-#define LD_SCHED (1u<<22)
-/** Guard nodes */
-#define LD_GUARD (1u<<23)
-/** Generation and application of consensus diffs. */
-#define LD_CONSDIFF (1u<<24)
-/** Denial of Service mitigation. */
-#define LD_DOS (1u<<25)
-/** Number of logging domains in the code. */
-#define N_LOGGING_DOMAINS 26
-
-/** This log message is not safe to send to a callback-based logger
- * immediately. Used as a flag, not a log domain. */
-#define LD_NOCB (1u<<31)
-/** This log message should not include a function name, even if it otherwise
- * would. Used as a flag, not a log domain. */
-#define LD_NOFUNCNAME (1u<<30)
-
-#ifdef TOR_UNIT_TESTS
-/** This log message should not be intercepted by mock_saving_logv */
-#define LD_NO_MOCK (1u<<29)
-#endif
-
-/** Mask of zero or more log domains, OR'd together. */
-typedef uint32_t log_domain_mask_t;
-
-/** Configures which severities are logged for each logging domain for a given
- * log target. */
-typedef struct log_severity_list_t {
- /** For each log severity, a bitmask of which domains a given logger is
- * logging. */
- log_domain_mask_t masks[LOG_DEBUG-LOG_ERR+1];
-} log_severity_list_t;
-
-/** Callback type used for add_callback_log. */
-typedef void (*log_callback)(int severity, uint32_t domain, const char *msg);
-
-void init_logging(int disable_startup_queue);
-int parse_log_level(const char *level);
-const char *log_level_to_string(int level);
-int parse_log_severity_config(const char **cfg,
- log_severity_list_t *severity_out);
-void set_log_severity_config(int minSeverity, int maxSeverity,
- log_severity_list_t *severity_out);
-void add_stream_log(const log_severity_list_t *severity, const char *name,
- int fd);
-int add_file_log(const log_severity_list_t *severity, const char *filename,
- const int truncate);
-#ifdef HAVE_SYSLOG_H
-int add_syslog_log(const log_severity_list_t *severity,
- const char* syslog_identity_tag);
-#endif // HAVE_SYSLOG_H.
-#ifdef HAVE_ANDROID_LOG_H
-int add_android_log(const log_severity_list_t *severity,
- const char *android_identity_tag);
-#endif // HAVE_ANDROID_LOG_H.
-int add_callback_log(const log_severity_list_t *severity, log_callback cb);
-typedef void (*pending_callback_callback)(void);
-void logs_set_pending_callback_callback(pending_callback_callback cb);
-void logs_set_domain_logging(int enabled);
-int get_min_log_level(void);
-void switch_logs_debug(void);
-void logs_free_all(void);
-void add_temp_log(int min_severity);
-void close_temp_logs(void);
-void rollback_log_changes(void);
-void mark_logs_temp(void);
-void change_callback_log_severity(int loglevelMin, int loglevelMax,
- log_callback cb);
-void flush_pending_log_callbacks(void);
-void flush_log_messages_from_startup(void);
-void log_set_application_name(const char *name);
-void set_log_time_granularity(int granularity_msec);
-void truncate_logs(void);
-
-void tor_log(int severity, log_domain_mask_t domain, const char *format, ...)
- CHECK_PRINTF(3,4);
-
-void tor_log_update_sigsafe_err_fds(void);
-
-struct smartlist_t;
-void tor_log_get_logfile_names(struct smartlist_t *out);
-
-extern int log_global_min_severity_;
-
-void log_fn_(int severity, log_domain_mask_t domain,
- const char *funcname, const char *format, ...)
- CHECK_PRINTF(4,5);
-struct ratelim_t;
-void log_fn_ratelim_(struct ratelim_t *ratelim, int severity,
- log_domain_mask_t domain, const char *funcname,
- const char *format, ...)
- CHECK_PRINTF(5,6);
-
-int log_message_is_interesting(int severity, log_domain_mask_t domain);
-void tor_log_string(int severity, log_domain_mask_t domain,
- const char *function, const char *string);
-
-#if defined(__GNUC__) && __GNUC__ <= 3
-
-/* These are the GCC varidaic macros, so that older versions of GCC don't
- * break. */
-
-/** Log a message at level <b>severity</b>, using a pretty-printed version
- * of the current function name. */
-#define log_fn(severity, domain, args...) \
- log_fn_(severity, domain, __FUNCTION__, args)
-/** As log_fn, but use <b>ratelim</b> (an instance of ratelim_t) to control
- * the frequency at which messages can appear.
- */
-#define log_fn_ratelim(ratelim, severity, domain, args...) \
- log_fn_ratelim_(ratelim, severity, domain, __FUNCTION__, args)
-#define log_debug(domain, args...) \
- STMT_BEGIN \
- if (PREDICT_UNLIKELY(log_global_min_severity_ == LOG_DEBUG)) \
- log_fn_(LOG_DEBUG, domain, __FUNCTION__, args); \
- STMT_END
-#define log_info(domain, args...) \
- log_fn_(LOG_INFO, domain, __FUNCTION__, args)
-#define log_notice(domain, args...) \
- log_fn_(LOG_NOTICE, domain, __FUNCTION__, args)
-#define log_warn(domain, args...) \
- log_fn_(LOG_WARN, domain, __FUNCTION__, args)
-#define log_err(domain, args...) \
- log_fn_(LOG_ERR, domain, __FUNCTION__, args)
-
-#else /* !(defined(__GNUC__) && __GNUC__ <= 3) */
-
-/* Here are the c99 variadic macros, to work with non-GCC compilers */
-
-#define log_debug(domain, args, ...) \
- STMT_BEGIN \
- if (PREDICT_UNLIKELY(log_global_min_severity_ == LOG_DEBUG)) \
- log_fn_(LOG_DEBUG, domain, __FUNCTION__, args, ##__VA_ARGS__); \
- STMT_END
-#define log_info(domain, args,...) \
- log_fn_(LOG_INFO, domain, __FUNCTION__, args, ##__VA_ARGS__)
-#define log_notice(domain, args,...) \
- log_fn_(LOG_NOTICE, domain, __FUNCTION__, args, ##__VA_ARGS__)
-#define log_warn(domain, args,...) \
- log_fn_(LOG_WARN, domain, __FUNCTION__, args, ##__VA_ARGS__)
-#define log_err(domain, args,...) \
- log_fn_(LOG_ERR, domain, __FUNCTION__, args, ##__VA_ARGS__)
-/** Log a message at level <b>severity</b>, using a pretty-printed version
- * of the current function name. */
-#define log_fn(severity, domain, args,...) \
- log_fn_(severity, domain, __FUNCTION__, args, ##__VA_ARGS__)
-/** As log_fn, but use <b>ratelim</b> (an instance of ratelim_t) to control
- * the frequency at which messages can appear.
- */
-#define log_fn_ratelim(ratelim, severity, domain, args,...) \
- log_fn_ratelim_(ratelim, severity, domain, __FUNCTION__, \
- args, ##__VA_ARGS__)
-#endif /* defined(__GNUC__) && __GNUC__ <= 3 */
-
-/** This defines log levels that are linked in the Rust log module, rather
- * than re-defining these in both Rust and C.
- *
- * C_RUST_COUPLED src/rust/tor_log LogSeverity, LogDomain
- */
-extern const int LOG_WARN_;
-extern const int LOG_NOTICE_;
-extern const log_domain_mask_t LD_NET_;
-extern const log_domain_mask_t LD_GENERAL_;
-
-#ifdef LOG_PRIVATE
-MOCK_DECL(STATIC void, logv, (int severity, log_domain_mask_t domain,
- const char *funcname, const char *suffix, const char *format,
- va_list ap) CHECK_PRINTF(5,0));
-#endif
-
-# define TOR_TORLOG_H
-#endif /* !defined(TOR_TORLOG_H) */