| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686 | 
							- /*
 
-  *  Copyright 2004 The WebRTC Project Authors. All rights reserved.
 
-  *
 
-  *  Use of this source code is governed by a BSD-style license
 
-  *  that can be found in the LICENSE file in the root of the source
 
-  *  tree. An additional intellectual property rights grant can be found
 
-  *  in the file PATENTS.  All contributing project authors may
 
-  *  be found in the AUTHORS file in the root of the source tree.
 
-  */
 
- // RTC_LOG(...) an ostream target that can be used to send formatted
 
- // output to a variety of logging targets, such as debugger console, stderr,
 
- // or any LogSink.
 
- // The severity level passed as the first argument to the logging
 
- // functions is used as a filter, to limit the verbosity of the logging.
 
- // Static members of LogMessage documented below are used to control the
 
- // verbosity and target of the output.
 
- // There are several variations on the RTC_LOG macro which facilitate logging
 
- // of common error conditions, detailed below.
 
- // RTC_LOG(sev) logs the given stream at severity "sev", which must be a
 
- //     compile-time constant of the LoggingSeverity type, without the namespace
 
- //     prefix.
 
- // RTC_LOG_V(sev) Like RTC_LOG(), but sev is a run-time variable of the
 
- //     LoggingSeverity type (basically, it just doesn't prepend the namespace).
 
- // RTC_LOG_F(sev) Like RTC_LOG(), but includes the name of the current function.
 
- // RTC_LOG_T(sev) Like RTC_LOG(), but includes the this pointer.
 
- // RTC_LOG_T_F(sev) Like RTC_LOG_F(), but includes the this pointer.
 
- // RTC_LOG_GLE(sev [, mod]) attempt to add a string description of the
 
- //     HRESULT returned by GetLastError.
 
- // RTC_LOG_ERRNO(sev) attempts to add a string description of an errno-derived
 
- //     error. errno and associated facilities exist on both Windows and POSIX,
 
- //     but on Windows they only apply to the C/C++ runtime.
 
- // RTC_LOG_ERR(sev) is an alias for the platform's normal error system, i.e.
 
- //     _GLE on Windows and _ERRNO on POSIX.
 
- // (The above three also all have _EX versions that let you specify the error
 
- // code, rather than using the last one.)
 
- // RTC_LOG_E(sev, ctx, err, ...) logs a detailed error interpreted using the
 
- //     specified context.
 
- // RTC_LOG_CHECK_LEVEL(sev) (and RTC_LOG_CHECK_LEVEL_V(sev)) can be used as a
 
- //     test before performing expensive or sensitive operations whose sole
 
- //     purpose is to output logging data at the desired level.
 
- #ifndef RTC_BASE_LOGGING_H_
 
- #define RTC_BASE_LOGGING_H_
 
- #include <errno.h>
 
- #include <sstream>  // no-presubmit-check TODO(webrtc:8982)
 
- #include <string>
 
- #include <utility>
 
- #include "absl/meta/type_traits.h"
 
- #include "absl/strings/string_view.h"
 
- #include "rtc_base/constructor_magic.h"
 
- #include "rtc_base/deprecation.h"
 
- #include "rtc_base/strings/string_builder.h"
 
- #include "rtc_base/system/inline.h"
 
- #if !defined(NDEBUG) || defined(DLOG_ALWAYS_ON)
 
- #define RTC_DLOG_IS_ON 1
 
- #else
 
- #define RTC_DLOG_IS_ON 0
 
- #endif
 
- #if defined(RTC_DISABLE_LOGGING)
 
- #define RTC_LOG_ENABLED() 0
 
- #else
 
- #define RTC_LOG_ENABLED() 1
 
- #endif
 
- namespace rtc {
 
- //////////////////////////////////////////////////////////////////////
 
- // Note that the non-standard LoggingSeverity aliases exist because they are
 
- // still in broad use.  The meanings of the levels are:
 
- //  LS_VERBOSE: This level is for data which we do not want to appear in the
 
- //   normal debug log, but should appear in diagnostic logs.
 
- //  LS_INFO: Chatty level used in debugging for all sorts of things, the default
 
- //   in debug builds.
 
- //  LS_WARNING: Something that may warrant investigation.
 
- //  LS_ERROR: Something that should not have occurred.
 
- //  LS_NONE: Don't log.
 
- enum LoggingSeverity {
 
-   LS_VERBOSE,
 
-   LS_INFO,
 
-   LS_WARNING,
 
-   LS_ERROR,
 
-   LS_NONE,
 
-   INFO = LS_INFO,
 
-   WARNING = LS_WARNING,
 
-   LERROR = LS_ERROR
 
- };
 
- // LogErrorContext assists in interpreting the meaning of an error value.
 
- enum LogErrorContext {
 
-   ERRCTX_NONE,
 
-   ERRCTX_ERRNO,    // System-local errno
 
-   ERRCTX_HRESULT,  // Windows HRESULT
 
-   // Abbreviations for LOG_E macro
 
-   ERRCTX_EN = ERRCTX_ERRNO,    // LOG_E(sev, EN, x)
 
-   ERRCTX_HR = ERRCTX_HRESULT,  // LOG_E(sev, HR, x)
 
- };
 
- class LogMessage;
 
- // Virtual sink interface that can receive log messages.
 
- class LogSink {
 
-  public:
 
-   LogSink() {}
 
-   virtual ~LogSink() {}
 
-   virtual void OnLogMessage(const std::string& msg,
 
-                             LoggingSeverity severity,
 
-                             const char* tag);
 
-   virtual void OnLogMessage(const std::string& message,
 
-                             LoggingSeverity severity);
 
-   virtual void OnLogMessage(const std::string& message) = 0;
 
-  private:
 
-   friend class ::rtc::LogMessage;
 
- #if RTC_LOG_ENABLED()
 
-   // Members for LogMessage class to keep linked list of the registered sinks.
 
-   LogSink* next_ = nullptr;
 
-   LoggingSeverity min_severity_;
 
- #endif
 
- };
 
- namespace webrtc_logging_impl {
 
- class LogMetadata {
 
-  public:
 
-   LogMetadata(const char* file, int line, LoggingSeverity severity)
 
-       : file_(file),
 
-         line_and_sev_(static_cast<uint32_t>(line) << 3 | severity) {}
 
-   LogMetadata() = default;
 
-   const char* File() const { return file_; }
 
-   int Line() const { return line_and_sev_ >> 3; }
 
-   LoggingSeverity Severity() const {
 
-     return static_cast<LoggingSeverity>(line_and_sev_ & 0x7);
 
-   }
 
-  private:
 
-   const char* file_;
 
-   // Line number and severity, the former in the most significant 29 bits, the
 
-   // latter in the least significant 3 bits. (This is an optimization; since
 
-   // both numbers are usually compile-time constants, this way we can load them
 
-   // both with a single instruction.)
 
-   uint32_t line_and_sev_;
 
- };
 
- static_assert(std::is_trivial<LogMetadata>::value, "");
 
- struct LogMetadataErr {
 
-   LogMetadata meta;
 
-   LogErrorContext err_ctx;
 
-   int err;
 
- };
 
- #ifdef WEBRTC_ANDROID
 
- struct LogMetadataTag {
 
-   LoggingSeverity severity;
 
-   const char* tag;
 
- };
 
- #endif
 
- enum class LogArgType : int8_t {
 
-   kEnd = 0,
 
-   kInt,
 
-   kLong,
 
-   kLongLong,
 
-   kUInt,
 
-   kULong,
 
-   kULongLong,
 
-   kDouble,
 
-   kLongDouble,
 
-   kCharP,
 
-   kStdString,
 
-   kStringView,
 
-   kVoidP,
 
-   kLogMetadata,
 
-   kLogMetadataErr,
 
- #ifdef WEBRTC_ANDROID
 
-   kLogMetadataTag,
 
- #endif
 
- };
 
- // Wrapper for log arguments. Only ever make values of this type with the
 
- // MakeVal() functions.
 
- template <LogArgType N, typename T>
 
- struct Val {
 
-   static constexpr LogArgType Type() { return N; }
 
-   T GetVal() const { return val; }
 
-   T val;
 
- };
 
- // Case for when we need to construct a temp string and then print that.
 
- // (We can't use Val<CheckArgType::kStdString, const std::string*>
 
- // because we need somewhere to store the temp string.)
 
- struct ToStringVal {
 
-   static constexpr LogArgType Type() { return LogArgType::kStdString; }
 
-   const std::string* GetVal() const { return &val; }
 
-   std::string val;
 
- };
 
- inline Val<LogArgType::kInt, int> MakeVal(int x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kLong, long> MakeVal(long x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kLongLong, long long> MakeVal(long long x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kUInt, unsigned int> MakeVal(unsigned int x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kULong, unsigned long> MakeVal(unsigned long x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kULongLong, unsigned long long> MakeVal(
 
-     unsigned long long x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kDouble, double> MakeVal(double x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kLongDouble, long double> MakeVal(long double x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kCharP, const char*> MakeVal(const char* x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kStdString, const std::string*> MakeVal(
 
-     const std::string& x) {
 
-   return {&x};
 
- }
 
- inline Val<LogArgType::kStringView, const absl::string_view*> MakeVal(
 
-     const absl::string_view& x) {
 
-   return {&x};
 
- }
 
- inline Val<LogArgType::kVoidP, const void*> MakeVal(const void* x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kLogMetadata, LogMetadata> MakeVal(
 
-     const LogMetadata& x) {
 
-   return {x};
 
- }
 
- inline Val<LogArgType::kLogMetadataErr, LogMetadataErr> MakeVal(
 
-     const LogMetadataErr& x) {
 
-   return {x};
 
- }
 
- // The enum class types are not implicitly convertible to arithmetic types.
 
- template <typename T,
 
-           absl::enable_if_t<std::is_enum<T>::value &&
 
-                             !std::is_arithmetic<T>::value>* = nullptr>
 
- inline decltype(MakeVal(std::declval<absl::underlying_type_t<T>>())) MakeVal(
 
-     T x) {
 
-   return {static_cast<absl::underlying_type_t<T>>(x)};
 
- }
 
- #ifdef WEBRTC_ANDROID
 
- inline Val<LogArgType::kLogMetadataTag, LogMetadataTag> MakeVal(
 
-     const LogMetadataTag& x) {
 
-   return {x};
 
- }
 
- #endif
 
- template <typename T, class = void>
 
- struct has_to_log_string : std::false_type {};
 
- template <typename T>
 
- struct has_to_log_string<T, decltype(ToLogString(std::declval<T>()))>
 
-     : std::true_type {};
 
- // Handle arbitrary types other than the above by falling back to stringstream.
 
- // TODO(bugs.webrtc.org/9278): Get rid of this overload when callers don't need
 
- // it anymore. No in-tree caller does, but some external callers still do.
 
- template <
 
-     typename T,
 
-     typename T1 = absl::decay_t<T>,
 
-     absl::enable_if_t<std::is_class<T1>::value &&
 
-                       !std::is_same<T1, std::string>::value &&
 
-                       !std::is_same<T1, LogMetadata>::value &&
 
-                       !has_to_log_string<T1>::value &&
 
- #ifdef WEBRTC_ANDROID
 
-                       !std::is_same<T1, LogMetadataTag>::value &&
 
- #endif
 
-                       !std::is_same<T1, LogMetadataErr>::value>* = nullptr>
 
- ToStringVal MakeVal(const T& x) {
 
-   std::ostringstream os;  // no-presubmit-check TODO(webrtc:8982)
 
-   os << x;
 
-   return {os.str()};
 
- }
 
- template <typename T, absl::enable_if_t<has_to_log_string<T>::value>* = nullptr>
 
- ToStringVal MakeVal(const T& x) {
 
-   return {ToLogString(x)};
 
- }
 
- #if RTC_LOG_ENABLED()
 
- void Log(const LogArgType* fmt, ...);
 
- #else
 
- inline void Log(const LogArgType* fmt, ...) {
 
-   // Do nothing, shouldn't be invoked
 
- }
 
- #endif
 
- // Ephemeral type that represents the result of the logging << operator.
 
- template <typename... Ts>
 
- class LogStreamer;
 
- // Base case: Before the first << argument.
 
- template <>
 
- class LogStreamer<> final {
 
-  public:
 
-   template <typename U,
 
-             typename V = decltype(MakeVal(std::declval<U>())),
 
-             absl::enable_if_t<std::is_arithmetic<U>::value ||
 
-                               std::is_enum<U>::value>* = nullptr>
 
-   RTC_FORCE_INLINE LogStreamer<V> operator<<(U arg) const {
 
-     return LogStreamer<V>(MakeVal(arg), this);
 
-   }
 
-   template <typename U,
 
-             typename V = decltype(MakeVal(std::declval<U>())),
 
-             absl::enable_if_t<!std::is_arithmetic<U>::value &&
 
-                               !std::is_enum<U>::value>* = nullptr>
 
-   RTC_FORCE_INLINE LogStreamer<V> operator<<(const U& arg) const {
 
-     return LogStreamer<V>(MakeVal(arg), this);
 
-   }
 
-   template <typename... Us>
 
-   RTC_FORCE_INLINE static void Call(const Us&... args) {
 
-     static constexpr LogArgType t[] = {Us::Type()..., LogArgType::kEnd};
 
-     Log(t, args.GetVal()...);
 
-   }
 
- };
 
- // Inductive case: We've already seen at least one << argument. The most recent
 
- // one had type `T`, and the earlier ones had types `Ts`.
 
- template <typename T, typename... Ts>
 
- class LogStreamer<T, Ts...> final {
 
-  public:
 
-   RTC_FORCE_INLINE LogStreamer(T arg, const LogStreamer<Ts...>* prior)
 
-       : arg_(arg), prior_(prior) {}
 
-   template <typename U,
 
-             typename V = decltype(MakeVal(std::declval<U>())),
 
-             absl::enable_if_t<std::is_arithmetic<U>::value ||
 
-                               std::is_enum<U>::value>* = nullptr>
 
-   RTC_FORCE_INLINE LogStreamer<V, T, Ts...> operator<<(U arg) const {
 
-     return LogStreamer<V, T, Ts...>(MakeVal(arg), this);
 
-   }
 
-   template <typename U,
 
-             typename V = decltype(MakeVal(std::declval<U>())),
 
-             absl::enable_if_t<!std::is_arithmetic<U>::value &&
 
-                               !std::is_enum<U>::value>* = nullptr>
 
-   RTC_FORCE_INLINE LogStreamer<V, T, Ts...> operator<<(const U& arg) const {
 
-     return LogStreamer<V, T, Ts...>(MakeVal(arg), this);
 
-   }
 
-   template <typename... Us>
 
-   RTC_FORCE_INLINE void Call(const Us&... args) const {
 
-     prior_->Call(arg_, args...);
 
-   }
 
-  private:
 
-   // The most recent argument.
 
-   T arg_;
 
-   // Earlier arguments.
 
-   const LogStreamer<Ts...>* prior_;
 
- };
 
- class LogCall final {
 
-  public:
 
-   // This can be any binary operator with precedence lower than <<.
 
-   // We return bool here to be able properly remove logging if
 
-   // RTC_DISABLE_LOGGING is defined.
 
-   template <typename... Ts>
 
-   RTC_FORCE_INLINE bool operator&(const LogStreamer<Ts...>& streamer) {
 
-     streamer.Call();
 
-     return true;
 
-   }
 
- };
 
- // This class is used to explicitly ignore values in the conditional
 
- // logging macros.  This avoids compiler warnings like "value computed
 
- // is not used" and "statement has no effect".
 
- class LogMessageVoidify {
 
-  public:
 
-   LogMessageVoidify() = default;
 
-   // This has to be an operator with a precedence lower than << but
 
-   // higher than ?:
 
-   template <typename... Ts>
 
-   void operator&(LogStreamer<Ts...>&& streamer) {}
 
- };
 
- }  // namespace webrtc_logging_impl
 
- // Direct use of this class is deprecated; please use the logging macros
 
- // instead.
 
- // TODO(bugs.webrtc.org/9278): Move this class to an unnamed namespace in the
 
- // .cc file.
 
- class LogMessage {
 
-  public:
 
-   // Same as the above, but using a compile-time constant for the logging
 
-   // severity. This saves space at the call site, since passing an empty struct
 
-   // is generally the same as not passing an argument at all.
 
-   template <LoggingSeverity S>
 
-   RTC_NO_INLINE LogMessage(const char* file,
 
-                            int line,
 
-                            std::integral_constant<LoggingSeverity, S>)
 
-       : LogMessage(file, line, S) {}
 
- #if RTC_LOG_ENABLED()
 
-   LogMessage(const char* file, int line, LoggingSeverity sev);
 
-   LogMessage(const char* file,
 
-              int line,
 
-              LoggingSeverity sev,
 
-              LogErrorContext err_ctx,
 
-              int err);
 
- #if defined(WEBRTC_ANDROID)
 
-   LogMessage(const char* file, int line, LoggingSeverity sev, const char* tag);
 
- #endif
 
-   // DEPRECATED - DO NOT USE - PLEASE USE THE MACROS INSTEAD OF THE CLASS.
 
-   // Android code should use the 'const char*' version since tags are static
 
-   // and we want to avoid allocating a std::string copy per log line.
 
-   RTC_DEPRECATED
 
-   LogMessage(const char* file,
 
-              int line,
 
-              LoggingSeverity sev,
 
-              const std::string& tag);
 
-   ~LogMessage();
 
-   void AddTag(const char* tag);
 
-   rtc::StringBuilder& stream();
 
-   // Returns the time at which this function was called for the first time.
 
-   // The time will be used as the logging start time.
 
-   // If this is not called externally, the LogMessage ctor also calls it, in
 
-   // which case the logging start time will be the time of the first LogMessage
 
-   // instance is created.
 
-   static int64_t LogStartTime();
 
-   // Returns the wall clock equivalent of |LogStartTime|, in seconds from the
 
-   // epoch.
 
-   static uint32_t WallClockStartTime();
 
-   //  LogThreads: Display the thread identifier of the current thread
 
-   static void LogThreads(bool on = true);
 
-   //  LogTimestamps: Display the elapsed time of the program
 
-   static void LogTimestamps(bool on = true);
 
-   // These are the available logging channels
 
-   //  Debug: Debug console on Windows, otherwise stderr
 
-   static void LogToDebug(LoggingSeverity min_sev);
 
-   static LoggingSeverity GetLogToDebug();
 
-   // Sets whether logs will be directed to stderr in debug mode.
 
-   static void SetLogToStderr(bool log_to_stderr);
 
-   // Stream: Any non-blocking stream interface.
 
-   // Installs the |stream| to collect logs with severtiy |min_sev| or higher.
 
-   // |stream| must live until deinstalled by RemoveLogToStream
 
-   static void AddLogToStream(LogSink* stream, LoggingSeverity min_sev);
 
-   // Removes the specified stream, without destroying it.
 
-   static void RemoveLogToStream(LogSink* stream);
 
-   // Returns the severity for the specified stream, of if none is specified,
 
-   // the minimum stream severity.
 
-   static int GetLogToStream(LogSink* stream = nullptr);
 
-   // Testing against MinLogSeverity allows code to avoid potentially expensive
 
-   // logging operations by pre-checking the logging level.
 
-   static int GetMinLogSeverity();
 
-   // Parses the provided parameter stream to configure the options above.
 
-   // Useful for configuring logging from the command line.
 
-   static void ConfigureLogging(const char* params);
 
-   // Checks the current global debug severity and if the |streams_| collection
 
-   // is empty. If |severity| is smaller than the global severity and if the
 
-   // |streams_| collection is empty, the LogMessage will be considered a noop
 
-   // LogMessage.
 
-   static bool IsNoop(LoggingSeverity severity);
 
- #else
 
-   // Next methods do nothing; no one will call these functions.
 
-   LogMessage(const char* file, int line, LoggingSeverity sev) {}
 
-   LogMessage(const char* file,
 
-              int line,
 
-              LoggingSeverity sev,
 
-              LogErrorContext err_ctx,
 
-              int err) {}
 
- #if defined(WEBRTC_ANDROID)
 
-   LogMessage(const char* file, int line, LoggingSeverity sev, const char* tag) {
 
-   }
 
- #endif
 
-   // DEPRECATED - DO NOT USE - PLEASE USE THE MACROS INSTEAD OF THE CLASS.
 
-   // Android code should use the 'const char*' version since tags are static
 
-   // and we want to avoid allocating a std::string copy per log line.
 
-   RTC_DEPRECATED
 
-   LogMessage(const char* file,
 
-              int line,
 
-              LoggingSeverity sev,
 
-              const std::string& tag) {}
 
-   ~LogMessage() = default;
 
-   inline void AddTag(const char* tag) {}
 
-   inline rtc::StringBuilder& stream() { return print_stream_; }
 
-   inline static int64_t LogStartTime() { return 0; }
 
-   inline static uint32_t WallClockStartTime() { return 0; }
 
-   inline static void LogThreads(bool on = true) {}
 
-   inline static void LogTimestamps(bool on = true) {}
 
-   inline static void LogToDebug(LoggingSeverity min_sev) {}
 
-   inline static LoggingSeverity GetLogToDebug() {
 
-     return LoggingSeverity::LS_INFO;
 
-   }
 
-   inline static void SetLogToStderr(bool log_to_stderr) {}
 
-   inline static void AddLogToStream(LogSink* stream, LoggingSeverity min_sev) {}
 
-   inline static void RemoveLogToStream(LogSink* stream) {}
 
-   inline static int GetLogToStream(LogSink* stream = nullptr) { return 0; }
 
-   inline static int GetMinLogSeverity() { return 0; }
 
-   inline static void ConfigureLogging(const char* params) {}
 
-   inline static bool IsNoop(LoggingSeverity severity) { return true; }
 
- #endif  // RTC_LOG_ENABLED()
 
-  private:
 
-   friend class LogMessageForTesting;
 
- #if RTC_LOG_ENABLED()
 
-   // Updates min_sev_ appropriately when debug sinks change.
 
-   static void UpdateMinLogSeverity();
 
- // These write out the actual log messages.
 
- #if defined(WEBRTC_ANDROID)
 
-   static void OutputToDebug(const std::string& msg,
 
-                             LoggingSeverity severity,
 
-                             const char* tag);
 
- #else
 
-   static void OutputToDebug(const std::string& msg, LoggingSeverity severity);
 
- #endif  // defined(WEBRTC_ANDROID)
 
-   // Called from the dtor (or from a test) to append optional extra error
 
-   // information to the log stream and a newline character.
 
-   void FinishPrintStream();
 
-   // The severity level of this message
 
-   LoggingSeverity severity_;
 
- #if defined(WEBRTC_ANDROID)
 
-   // The default Android debug output tag.
 
-   const char* tag_ = "libjingle";
 
- #endif
 
-   // String data generated in the constructor, that should be appended to
 
-   // the message before output.
 
-   std::string extra_;
 
-   // The output streams and their associated severities
 
-   static LogSink* streams_;
 
-   // Flags for formatting options
 
-   static bool thread_, timestamp_;
 
-   // Determines if logs will be directed to stderr in debug mode.
 
-   static bool log_to_stderr_;
 
- #else  // RTC_LOG_ENABLED()
 
-   // Next methods do nothing; no one will call these functions.
 
-   inline static void UpdateMinLogSeverity() {}
 
- #if defined(WEBRTC_ANDROID)
 
-   inline static void OutputToDebug(const std::string& msg,
 
-                                    LoggingSeverity severity,
 
-                                    const char* tag) {}
 
- #else
 
-   inline static void OutputToDebug(const std::string& msg,
 
-                                    LoggingSeverity severity) {}
 
- #endif  // defined(WEBRTC_ANDROID)
 
-   inline void FinishPrintStream() {}
 
- #endif  // RTC_LOG_ENABLED()
 
-   // The stringbuilder that buffers the formatted message before output
 
-   rtc::StringBuilder print_stream_;
 
-   RTC_DISALLOW_COPY_AND_ASSIGN(LogMessage);
 
- };
 
- //////////////////////////////////////////////////////////////////////
 
- // Logging Helpers
 
- //////////////////////////////////////////////////////////////////////
 
- #define RTC_LOG_FILE_LINE(sev, file, line)            \
 
-   RTC_LOG_ENABLED() &&                                \
 
-       ::rtc::webrtc_logging_impl::LogCall() &         \
 
-           ::rtc::webrtc_logging_impl::LogStreamer<>() \
 
-               << ::rtc::webrtc_logging_impl::LogMetadata(file, line, sev)
 
- #define RTC_LOG(sev) RTC_LOG_FILE_LINE(::rtc::sev, __FILE__, __LINE__)
 
- // The _V version is for when a variable is passed in.
 
- #define RTC_LOG_V(sev) RTC_LOG_FILE_LINE(sev, __FILE__, __LINE__)
 
- // The _F version prefixes the message with the current function name.
 
- #if (defined(__GNUC__) && !defined(NDEBUG)) || defined(WANT_PRETTY_LOG_F)
 
- #define RTC_LOG_F(sev) RTC_LOG(sev) << __PRETTY_FUNCTION__ << ": "
 
- #define RTC_LOG_T_F(sev) \
 
-   RTC_LOG(sev) << this << ": " << __PRETTY_FUNCTION__ << ": "
 
- #else
 
- #define RTC_LOG_F(sev) RTC_LOG(sev) << __FUNCTION__ << ": "
 
- #define RTC_LOG_T_F(sev) RTC_LOG(sev) << this << ": " << __FUNCTION__ << ": "
 
- #endif
 
- #define RTC_LOG_CHECK_LEVEL(sev) ::rtc::LogCheckLevel(::rtc::sev)
 
- #define RTC_LOG_CHECK_LEVEL_V(sev) ::rtc::LogCheckLevel(sev)
 
- inline bool LogCheckLevel(LoggingSeverity sev) {
 
-   return (LogMessage::GetMinLogSeverity() <= sev);
 
- }
 
- #define RTC_LOG_E(sev, ctx, err)                                               \
 
-   RTC_LOG_ENABLED() && ::rtc::webrtc_logging_impl::LogCall() &                 \
 
-                            ::rtc::webrtc_logging_impl::LogStreamer<>()         \
 
-                                << ::rtc::webrtc_logging_impl::LogMetadataErr { \
 
-     {__FILE__, __LINE__, ::rtc::sev}, ::rtc::ERRCTX_##ctx, (err)               \
 
-   }
 
- #define RTC_LOG_T(sev) RTC_LOG(sev) << this << ": "
 
- #define RTC_LOG_ERRNO_EX(sev, err) RTC_LOG_E(sev, ERRNO, err)
 
- #define RTC_LOG_ERRNO(sev) RTC_LOG_ERRNO_EX(sev, errno)
 
- #if defined(WEBRTC_WIN)
 
- #define RTC_LOG_GLE_EX(sev, err) RTC_LOG_E(sev, HRESULT, err)
 
- #define RTC_LOG_GLE(sev) RTC_LOG_GLE_EX(sev, static_cast<int>(GetLastError()))
 
- #define RTC_LOG_ERR_EX(sev, err) RTC_LOG_GLE_EX(sev, err)
 
- #define RTC_LOG_ERR(sev) RTC_LOG_GLE(sev)
 
- #elif defined(__native_client__) && __native_client__
 
- #define RTC_LOG_ERR_EX(sev, err) RTC_LOG(sev)
 
- #define RTC_LOG_ERR(sev) RTC_LOG(sev)
 
- #elif defined(WEBRTC_POSIX)
 
- #define RTC_LOG_ERR_EX(sev, err) RTC_LOG_ERRNO_EX(sev, err)
 
- #define RTC_LOG_ERR(sev) RTC_LOG_ERRNO(sev)
 
- #endif  // WEBRTC_WIN
 
- #ifdef WEBRTC_ANDROID
 
- namespace webrtc_logging_impl {
 
- // TODO(kwiberg): Replace these with absl::string_view.
 
- inline const char* AdaptString(const char* str) {
 
-   return str;
 
- }
 
- inline const char* AdaptString(const std::string& str) {
 
-   return str.c_str();
 
- }
 
- }  // namespace webrtc_logging_impl
 
- #define RTC_LOG_TAG(sev, tag)                                                  \
 
-   RTC_LOG_ENABLED() && ::rtc::webrtc_logging_impl::LogCall() &                 \
 
-                            ::rtc::webrtc_logging_impl::LogStreamer<>()         \
 
-                                << ::rtc::webrtc_logging_impl::LogMetadataTag { \
 
-     sev, ::rtc::webrtc_logging_impl::AdaptString(tag)                          \
 
-   }
 
- #else
 
- // DEPRECATED. This macro is only intended for Android.
 
- #define RTC_LOG_TAG(sev, tag) RTC_LOG_V(sev)
 
- #endif
 
- // The RTC_DLOG macros are equivalent to their RTC_LOG counterparts except that
 
- // they only generate code in debug builds.
 
- #if RTC_DLOG_IS_ON
 
- #define RTC_DLOG(sev) RTC_LOG(sev)
 
- #define RTC_DLOG_V(sev) RTC_LOG_V(sev)
 
- #define RTC_DLOG_F(sev) RTC_LOG_F(sev)
 
- #else
 
- #define RTC_DLOG_EAT_STREAM_PARAMS()                \
 
-   while (false)                                     \
 
-   ::rtc::webrtc_logging_impl::LogMessageVoidify() & \
 
-       (::rtc::webrtc_logging_impl::LogStreamer<>())
 
- #define RTC_DLOG(sev) RTC_DLOG_EAT_STREAM_PARAMS()
 
- #define RTC_DLOG_V(sev) RTC_DLOG_EAT_STREAM_PARAMS()
 
- #define RTC_DLOG_F(sev) RTC_DLOG_EAT_STREAM_PARAMS()
 
- #endif
 
- }  // namespace rtc
 
- #endif  // RTC_BASE_LOGGING_H_
 
 
  |