src/cpp-common/bt2c/logging.hpp

   1 /*
   2  * SPDX-FileCopyrightText: 2023 Philippe Proulx <pproulx@efficios.com>
   3  * SPDX-License-Identifier: MIT
   4  */
   5
   6 #ifndef BABELTRACE_CPP_COMMON_BT2C_LOGGING_HPP
   7 #define BABELTRACE_CPP_COMMON_BT2C_LOGGING_HPP
   8
   9 #include <cstring>
  10 #include <iterator>
  11 #include <string>
  12 #include <utility>
  13 #include <vector>
  14
  15 #include <glib.h>
  16
  17 #include <babeltrace2/babeltrace.h>
  18
  19 #include "common/assert.h"
  20 #include "cpp-common/bt2/private-query-executor.hpp"
  21 #include "cpp-common/bt2/self-component-class.hpp"
  22 #include "cpp-common/bt2/self-component-port.hpp"
  23 #include "cpp-common/bt2/self-message-iterator.hpp"
  24 #include "cpp-common/bt2s/optional.hpp"
  25 #include "cpp-common/bt2s/span.hpp"
  26 #include "cpp-common/vendor/fmt/core.h"
  27 #include "cpp-common/vendor/wise-enum/wise_enum.h"
  28 #include "logging/log-api.h"
  29
  30 namespace bt2c {
  31
  32 /*
  33  * A logger contains an actor (self component class, self component,
  34  * self message iterator, or simple module name), a current logging
  35  * level, and a logging tag.
  36  *
  37  * It offers the log(), logMem(), logErrno(), logErrorAndThrow(),
  38  * logErrorAndRethrow(), logErrorErrnoAndThrow(), and
  39  * logErrorErrnoAndRethrow() method templates to log using a given
  40  * level, optionally append a cause to the error of the current thread
  41  * using the correct actor, and optionally throw or rethrow.
  42  *
  43  * The methods above expect a format string and zero or more arguments
  44  * to be formatted with fmt::format().
  45  */
  46 class Logger final
  47 {
  48 public:
  49     using MemData = bt2s::span<const std::uint8_t>;
  50
  51     /* clang-format off */
  52
  53     /* Available log levels */
  54     WISE_ENUM_CLASS_MEMBER(Level,
  55         (Trace,     BT_LOG_TRACE),
  56         (Debug,     BT_LOG_DEBUG),
  57         (Info,      BT_LOG_INFO),
  58         (Warning,   BT_LOG_WARNING),
  59         (Error,     BT_LOG_ERROR),
  60         (Fatal,     BT_LOG_FATAL),
  61         (None,      BT_LOG_NONE)
  62     )
  63
  64     /* clang-format on */
  65
  66     /*
  67      * Builds a logger from the self component class `selfCompCls` using
  68      * the tag `tag` and the logging level of `privQueryExec`.
  69      */
  70     explicit Logger(const bt2::SelfComponentClass selfCompCls,
  71                     const bt2::PrivateQueryExecutor privQueryExec, std::string tag) noexcept :
  72         _mSelfCompCls {selfCompCls},
  73         _mLevel {static_cast<Level>(privQueryExec.loggingLevel())}, _mTag {std::move(tag)}
  74     {
  75     }
  76
  77     /*
  78      * Builds a logger from the self component `selfComp` using the tag
  79      * `tag`.
  80      */
  81     explicit Logger(const bt2::SelfComponent selfComp, std::string tag) noexcept :
  82         _mSelfComp {selfComp}, _mLevel {static_cast<Level>(selfComp.loggingLevel())}, _mTag {
  83                                                                                           std::move(
  84                                                                                               tag)}
  85     {
  86     }
  87
  88     /*
  89      * Builds a logger from the self source component `selfComp` using
  90      * the tag `tag`.
  91      */
  92     explicit Logger(const bt2::SelfSourceComponent selfComp, std::string tag) noexcept :
  93         Logger {
  94             bt2::SelfComponent {bt_self_component_source_as_self_component(selfComp.libObjPtr())},
  95             std::move(tag)}
  96     {
  97     }
  98
  99     /*
 100      * Builds a logger from the self filter component `selfComp` using
 101      * the tag `tag`.
 102      */
 103     explicit Logger(const bt2::SelfFilterComponent selfComp, std::string tag) noexcept :
 104         Logger {
 105             bt2::SelfComponent {bt_self_component_filter_as_self_component(selfComp.libObjPtr())},
 106             std::move(tag)}
 107     {
 108     }
 109
 110     /*
 111      * Builds a logger from the self sink component `selfComp` using the
 112      * tag `tag`.
 113      */
 114     explicit Logger(const bt2::SelfSinkComponent selfComp, std::string tag) noexcept :
 115         Logger {bt2::SelfComponent {bt_self_component_sink_as_self_component(selfComp.libObjPtr())},
 116                 std::move(tag)}
 117     {
 118     }
 119
 120     /*
 121      * Builds a logger from the self message iterator `selfMsgIter`
 122      * using the tag `tag`.
 123      */
 124     explicit Logger(const bt2::SelfMessageIterator selfMsgIter, std::string tag) noexcept :
 125         _mSelfMsgIter {selfMsgIter},
 126         _mLevel {static_cast<Level>(selfMsgIter.component().loggingLevel())}, _mTag {std::move(tag)}
 127     {
 128     }
 129
 130     /*
 131      * Builds a logger from the module named `moduleName` using the tag
 132      * `tag` and logging level `logLevel`.
 133      */
 134     explicit Logger(std::string moduleName, std::string tag, const Level logLevel) noexcept :
 135         _mModuleName {std::move(moduleName)}, _mLevel {logLevel}, _mTag {std::move(tag)}
 136     {
 137     }
 138
 139     /*
 140      * Builds a logger from another logger `other` using the new tag
 141      * `newTag`.
 142      */
 143     explicit Logger(const Logger& other, std::string newTag) :
 144         _mSelfCompCls {other._mSelfCompCls}, _mSelfComp {other._mSelfComp},
 145         _mSelfMsgIter {other._mSelfMsgIter},
 146         _mModuleName {other._mModuleName}, _mLevel {other._mLevel}, _mTag {std::move(newTag)}
 147     {
 148     }
 149
 150     /*
 151      * Current logging level.
 152      */
 153     Level level() const noexcept
 154     {
 155         return _mLevel;
 156     }
 157
 158     /*
 159      * Current logging level converted to a `bt_log_level` value.
 160      *
 161      * For legacy code.
 162      */
 163     bt_log_level cLevel() const noexcept
 164     {
 165         return static_cast<bt_log_level>(_mLevel);
 166     }
 167
 168     /*
 169      * Whether or not this logger would log at the level `level`.
 170      */
 171     bool wouldLog(const Level level) const noexcept
 172     {
 173         return BT_LOG_ON_CUR_LVL(static_cast<int>(level), static_cast<int>(_mLevel));
 174     }
 175
 176     /*
 177      * Whether or not this logger would log at the trace level.
 178      */
 179     bool wouldLogT() const noexcept
 180     {
 181         return this->wouldLog(Level::Trace);
 182     }
 183
 184     /*
 185      * Whether or not this logger would log at the debug level.
 186      */
 187     bool wouldLogD() const noexcept
 188     {
 189         return this->wouldLog(Level::Debug);
 190     }
 191
 192     /*
 193      * Whether or not this logger would log at the info level.
 194      */
 195     bool wouldLogI() const noexcept
 196     {
 197         return this->wouldLog(Level::Info);
 198     }
 199
 200     /*
 201      * Whether or not this logger would log at the warning level.
 202      */
 203     bool wouldLogW() const noexcept
 204     {
 205         return this->wouldLog(Level::Warning);
 206     }
 207
 208     /*
 209      * Whether or not this logger would log at the error level.
 210      */
 211     bool wouldLogE() const noexcept
 212     {
 213         return this->wouldLog(Level::Error);
 214     }
 215
 216     /*
 217      * Whether or not this logger would log at the fatal level.
 218      */
 219     bool wouldLogF() const noexcept
 220     {
 221         return this->wouldLog(Level::Fatal);
 222     }
 223
 224     /*
 225      * Logging tag.
 226      */
 227     const std::string& tag() const noexcept
 228     {
 229         return _mTag;
 230     }
 231
 232     /*
 233      * Self component class actor, or `bt2s::nullopt` if none.
 234      */
 235     const bt2s::optional<bt2::SelfComponentClass>& selfCompCls() const noexcept
 236     {
 237         return _mSelfCompCls;
 238     }
 239
 240     /*
 241      * Self component actor, or `bt2s::nullopt` if none.
 242      */
 243     const bt2s::optional<bt2::SelfComponent>& selfComp() const noexcept
 244     {
 245         return _mSelfComp;
 246     }
 247
 248     /*
 249      * Self message iterator actor, or `bt2s::nullopt` if none.
 250      */
 251     const bt2s::optional<bt2::SelfMessageIterator>& selfMsgIter() const noexcept
 252     {
 253         return _mSelfMsgIter;
 254     }
 255
 256     /*
 257      * Name of module actor, or `bt2s::nullopt` if none.
 258      */
 259     const bt2s::optional<std::string>& moduleName() const noexcept
 260     {
 261         return _mModuleName;
 262     }
 263
 264 private:
 265     struct _StdLogWriter final
 266     {
 267         static void write(const char * const fileName, const char * const funcName,
 268                           const unsigned lineNo, const Level level, const char * const tag, MemData,
 269                           const char * const initMsg, const char * const msg) noexcept
 270         {
 271             BT_ASSERT_DBG(initMsg && std::strcmp(initMsg, "") == 0);
 272             bt_log_write(fileName, funcName, lineNo, static_cast<bt_log_level>(level), tag, msg);
 273         }
 274     };
 275
 276 public:
 277     /*
 278      * Logs using the level `LevelV`.
 279      *
 280      * This method forwards `fmt` and `args` to fmt::format() to create
 281      * the log message.
 282      *
 283      * If `AppendCauseV` is true, this method also appends a cause to
 284      * the error of the current thread using the same message.
 285      */
 286     template <Level LevelV, bool AppendCauseV, typename... ArgTs>
 287     void log(const char * const fileName, const char * const funcName, const unsigned int lineNo,
 288              const char * const fmt, ArgTs&&...args) const
 289     {
 290         this->_log<_StdLogWriter, LevelV, AppendCauseV>(fileName, funcName, lineNo, {}, "", fmt,
 291                                                         std::forward<ArgTs>(args)...);
 292     }
 293
 294     /*
 295      * Logs `msg` using the level `LevelV`.
 296      *
 297      * If `AppendCauseV` is true, this method also appends a cause to
 298      * the error of the current thread using the same message.
 299      */
 300     template <Level LevelV, bool AppendCauseV>
 301     void logStr(const char * const fileName, const char * const funcName, const unsigned int lineNo,
 302                 const char * const msg) const
 303     {
 304         this->_logStr<_StdLogWriter, LevelV, AppendCauseV>(fileName, funcName, lineNo, {}, "", msg);
 305     }
 306
 307     /*
 308      * Like log() with the `Level::Error` level, but also throws a
 309      * default-constructed instance of `ExcT`.
 310      */
 311     template <bool AppendCauseV, typename ExcT, typename... ArgTs>
 312     [[noreturn]] void logErrorAndThrow(const char * const fileName, const char * const funcName,
 313                                        const unsigned int lineNo, const char * const fmt,
 314                                        ArgTs&&...args) const
 315     {
 316         this->log<Level::Error, AppendCauseV>(fileName, funcName, lineNo, fmt,
 317                                               std::forward<ArgTs>(args)...);
 318         throw ExcT {};
 319     }
 320
 321     /*
 322      * Like logStr() with the `Level::Error` level, but also throws a
 323      * default-constructed instance of `ExcT`.
 324      */
 325     template <bool AppendCauseV, typename ExcT>
 326     [[noreturn]] void logErrorStrAndThrow(const char * const fileName, const char * const funcName,
 327                                           const unsigned int lineNo, const char * const msg) const
 328     {
 329         this->logStr<Level::Error, AppendCauseV>(fileName, funcName, lineNo, msg);
 330         throw ExcT {};
 331     }
 332
 333     /*
 334      * Like log() with the `Level::Error` level, but also rethrows.
 335      */
 336     template <bool AppendCauseV, typename... ArgTs>
 337     [[noreturn]] void logErrorAndRethrow(const char * const fileName, const char * const funcName,
 338                                          const unsigned int lineNo, const char * const fmt,
 339                                          ArgTs&&...args) const
 340     {
 341         this->log<Level::Error, AppendCauseV>(fileName, funcName, lineNo, fmt,
 342                                               std::forward<ArgTs>(args)...);
 343         throw;
 344     }
 345
 346     /*
 347      * Like logStr() with the `Level::Error` level, but also rethrows.
 348      */
 349     template <bool AppendCauseV>
 350     [[noreturn]] void logErrorStrAndRethrow(const char * const fileName,
 351                                             const char * const funcName, const unsigned int lineNo,
 352                                             const char * const msg) const
 353     {
 354         this->logStr<Level::Error, AppendCauseV>(fileName, funcName, lineNo, msg);
 355         throw;
 356     }
 357
 358 private:
 359     struct _InitMsgLogWriter final
 360     {
 361         static void write(const char * const fileName, const char * const funcName,
 362                           const unsigned lineNo, const Level level, const char * const tag, MemData,
 363                           const char * const initMsg, const char * const msg) noexcept
 364         {
 365             bt_log_write_printf(funcName, fileName, lineNo, static_cast<bt_log_level>(level), tag,
 366                                 "%s%s", initMsg, msg);
 367         }
 368     };
 369
 370 public:
 371     /*
 372      * Logs the message of `errno` using the level `LevelV`.
 373      *
 374      * The log message starts with `initMsg`, is followed with the
 375      * message for `errno`, and then with what fmt::format() creates
 376      * given `fmt` and `args`.
 377      *
 378      * If `AppendCauseV` is true, this method also appends a cause to
 379      * the error of the current thread using the same message.
 380      */
 381     template <Level LevelV, bool AppendCauseV, typename... ArgTs>
 382     void logErrno(const char * const fileName, const char * const funcName,
 383                   const unsigned int lineNo, const char * const initMsg, const char * const fmt,
 384                   ArgTs&&...args) const
 385     {
 386         this->_log<_InitMsgLogWriter, LevelV, AppendCauseV>(fileName, funcName, lineNo, {},
 387                                                             this->_errnoIntroStr(initMsg).c_str(),
 388                                                             fmt, std::forward<ArgTs>(args)...);
 389     }
 390
 391     /*
 392      * Logs the message of `errno` using the level `LevelV`.
 393      *
 394      * The log message starts with `initMsg`, is followed with the
 395      * message for `errno`, and then with `msg`.
 396      *
 397      * If `AppendCauseV` is true, this method also appends a cause to
 398      * the error of the current thread using the same message.
 399      */
 400     template <Level LevelV, bool AppendCauseV>
 401     void logErrnoStr(const char * const fileName, const char * const funcName,
 402                      const unsigned int lineNo, const char * const initMsg,
 403                      const char * const msg) const
 404     {
 405         this->_logStr<_InitMsgLogWriter, LevelV, AppendCauseV>(
 406             fileName, funcName, lineNo, {}, this->_errnoIntroStr(initMsg).c_str(), msg);
 407     }
 408
 409     /*
 410      * Like logErrno() with the `Level::Error` level, but also throws a
 411      * default-constructed instance of `ExcT`.
 412      */
 413     template <bool AppendCauseV, typename ExcT, typename... ArgTs>
 414     [[noreturn]] void logErrorErrnoAndThrow(const char * const fileName,
 415                                             const char * const funcName, const unsigned int lineNo,
 416                                             const char * const initMsg, const char * const fmt,
 417                                             ArgTs&&...args) const
 418     {
 419         this->logErrno<Level::Error, AppendCauseV>(fileName, funcName, lineNo, initMsg, fmt,
 420                                                    std::forward<ArgTs>(args)...);
 421         throw ExcT {};
 422     }
 423
 424     /*
 425      * Like logErrnoStr() with the `Level::Error` level, but also throws
 426      * a default-constructed instance of `ExcT`.
 427      */
 428     template <bool AppendCauseV, typename ExcT>
 429     [[noreturn]] void
 430     logErrorErrnoStrAndThrow(const char * const fileName, const char * const funcName,
 431                              const unsigned int lineNo, const char * const initMsg,
 432                              const char * const msg) const
 433     {
 434         this->logErrnoStr<Level::Error, AppendCauseV>(fileName, funcName, lineNo, initMsg, msg);
 435         throw ExcT {};
 436     }
 437
 438     /*
 439      * Like logErrno() with the `Level::Error` level, but also rethrows.
 440      */
 441     template <bool AppendCauseV, typename... ArgTs>
 442     [[noreturn]] void logErrorErrnoAndRethrow(const char * const fileName,
 443                                               const char * const funcName,
 444                                               const unsigned int lineNo, const char * const initMsg,
 445                                               const char * const fmt, ArgTs&&...args) const
 446     {
 447         this->logErrno<Level::Error, AppendCauseV>(fileName, funcName, lineNo, initMsg, fmt,
 448                                                    std::forward<ArgTs>(args)...);
 449         throw;
 450     }
 451
 452     /*
 453      * Like logErrnoStr() with the `Level::Error` level, but also
 454      * rethrows.
 455      */
 456     template <bool AppendCauseV>
 457     [[noreturn]] void
 458     logErrorErrnoStrAndRethrow(const char * const fileName, const char * const funcName,
 459                                const unsigned int lineNo, const char * const initMsg,
 460                                const char * const msg) const
 461     {
 462         this->logErrnoStr<Level::Error, AppendCauseV>(fileName, funcName, lineNo, initMsg, msg);
 463         throw;
 464     }
 465
 466 private:
 467     struct _MemLogWriter final
 468     {
 469         static void write(const char * const fileName, const char * const funcName,
 470                           const unsigned lineNo, const Level level, const char * const tag,
 471                           const MemData memData, const char *, const char * const msg) noexcept
 472         {
 473             bt_log_write_mem(funcName, fileName, lineNo, static_cast<bt_log_level>(level), tag,
 474                              memData.data(), memData.size(), msg);
 475         }
 476     };
 477
 478 public:
 479     /*
 480      * Logs memory data using the level `LevelV`.
 481      *
 482      * This method forwards `fmt` and `args` to fmt::format() to create
 483      * the log message.
 484      */
 485     template <Level LevelV, typename... ArgTs>
 486     void logMem(const char * const fileName, const char * const funcName, const unsigned int lineNo,
 487                 const MemData memData, const char * const fmt, ArgTs&&...args) const
 488     {
 489         this->_log<_MemLogWriter, LevelV, false>(fileName, funcName, lineNo, memData, "", fmt,
 490                                                  std::forward<ArgTs>(args)...);
 491     }
 492
 493     /*
 494      * Logs memory data using the level `LevelV`, starting with the
 495      * message `msg`.
 496      */
 497     template <Level LevelV>
 498     void logMemStr(const char * const fileName, const char * const funcName,
 499                    const unsigned int lineNo, const MemData memData, const char * const msg) const
 500     {
 501         this->_logStr<_MemLogWriter, LevelV, false>(fileName, funcName, lineNo, memData, "", msg);
 502     }
 503
 504 private:
 505     /*
 506      * Formats a log message with fmt::format() given `fmt` and `args`,
 507      * and then forwards everything to _logStr().
 508      */
 509     template <typename LogWriterT, Level LevelV, bool AppendCauseV, typename... ArgTs>
 510     void _log(const char * const fileName, const char * const funcName, const unsigned int lineNo,
 511               const MemData memData, const char * const initMsg, const char * const fmt,
 512               ArgTs&&...args) const
 513     {
 514         /* Only format arguments if logging or appending an error cause */
 515         if (G_UNLIKELY(this->wouldLog(LevelV) || AppendCauseV)) {
 516             /*
 517              * Format arguments to our buffer (fmt::format_to() doesn't
 518              * append a null character).
 519              */
 520             _mBuf.clear();
 521             fmt::format_to(std::back_inserter(_mBuf), fmt, std::forward<ArgTs>(args)...);
 522             _mBuf.push_back('\0');
 523         }
 524
 525         this->_logStr<LogWriterT, LevelV, AppendCauseV>(fileName, funcName, lineNo, memData,
 526                                                         initMsg, _mBuf.data());
 527     }
 528
 529     /*
 530      * Calls LogWriterT::write() with its arguments to log using the
 531      * level `LevelV`.
 532      *
 533      * If `AppendCauseV` is true, this method also appends a cause to
 534      * the error of the current thread using the concatenation of
 535      * `initMsg` and `msg` as the message.
 536      */
 537     template <typename LogWriterT, Level LevelV, bool AppendCauseV>
 538     void _logStr(const char * const fileName, const char * const funcName,
 539                  const unsigned int lineNo, const MemData memData, const char * const initMsg,
 540                  const char * const msg) const
 541     {
 542         /* Initial message and main message are required */
 543         BT_ASSERT(initMsg);
 544         BT_ASSERT(msg);
 545
 546         /* Log if needed */
 547         if (this->wouldLog(LevelV)) {
 548             LogWriterT::write(fileName, funcName, lineNo, LevelV, _mTag.data(), memData, initMsg,
 549                               msg);
 550         }
 551
 552         /* Append an error cause if needed */
 553         if (AppendCauseV) {
 554             if (_mSelfMsgIter) {
 555                 bt_current_thread_error_append_cause_from_message_iterator(
 556                     _mSelfMsgIter->libObjPtr(), fileName, lineNo, "%s%s", initMsg, msg);
 557             } else if (_mSelfComp) {
 558                 bt_current_thread_error_append_cause_from_component(
 559                     _mSelfComp->libObjPtr(), fileName, lineNo, "%s%s", initMsg, msg);
 560             } else if (_mSelfCompCls) {
 561                 bt_current_thread_error_append_cause_from_component_class(
 562                     _mSelfCompCls->libObjPtr(), fileName, lineNo, "%s%s", initMsg, msg);
 563             } else {
 564                 BT_ASSERT(_mModuleName);
 565                 bt_current_thread_error_append_cause_from_unknown(_mModuleName->data(), fileName,
 566                                                                   lineNo, "%s%s", initMsg, msg);
 567             }
 568         }
 569     }
 570
 571     static std::string _errnoIntroStr(const char * const initMsg)
 572     {
 573         BT_ASSERT(errno != 0);
 574         return fmt::format("{}: {}", initMsg, g_strerror(errno));
 575     }
 576
 577     /* Exactly one of the following four members has a value */
 578     bt2s::optional<bt2::SelfComponentClass> _mSelfCompCls;
 579     bt2s::optional<bt2::SelfComponent> _mSelfComp;
 580     bt2s::optional<bt2::SelfMessageIterator> _mSelfMsgIter;
 581     bt2s::optional<std::string> _mModuleName;
 582
 583     /* Current logging level */
 584     Level _mLevel;
 585
 586     /* Logging tag */
 587     std::string _mTag;
 588
 589     /* Formatting buffer */
 590     mutable std::vector<char> _mBuf;
 591 };
 592
 593 /*
 594  * Returns `s` if it's not `nullptr`, or the `(null)` string otherwise.
 595  */
 596 inline const char *maybeNull(const char * const s) noexcept
 597 {
 598     return s ? s : "(null)";
 599 }
 600
 601 } /* namespace bt2c */
 602
 603 /* Internal: default logger name */
 604 #define _BT_CPPLOG_DEF_LOGGER _mLogger
 605
 606 /*
 607  * Calls log() on `_logger` to log using the level `_lvl`.
 608  */
 609 #define BT_CPPLOG_EX(_lvl, _logger, _fmt, ...)                                                     \
 610     do {                                                                                           \
 611         if (G_UNLIKELY((_logger).wouldLog(_lvl))) {                                                \
 612             (_logger).log<(_lvl), false>(__FILE__, __func__, __LINE__, (_fmt), ##__VA_ARGS__);     \
 613         }                                                                                          \
 614     } while (0)
 615
 616 /*
 617  * BT_CPPLOG_EX() with specific logging levels.
 618  */
 619 #define BT_CPPLOGT_SPEC(_logger, _fmt, ...)                                                        \
 620     BT_CPPLOG_EX(bt2c::Logger::Level::Trace, (_logger), (_fmt), ##__VA_ARGS__)
 621 #define BT_CPPLOGD_SPEC(_logger, _fmt, ...)                                                        \
 622     BT_CPPLOG_EX(bt2c::Logger::Level::Debug, (_logger), (_fmt), ##__VA_ARGS__)
 623 #define BT_CPPLOGI_SPEC(_logger, _fmt, ...)                                                        \
 624     BT_CPPLOG_EX(bt2c::Logger::Level::Info, (_logger), (_fmt), ##__VA_ARGS__)
 625 #define BT_CPPLOGW_SPEC(_logger, _fmt, ...)                                                        \
 626     BT_CPPLOG_EX(bt2c::Logger::Level::Warning, (_logger), (_fmt), ##__VA_ARGS__)
 627 #define BT_CPPLOGE_SPEC(_logger, _fmt, ...)                                                        \
 628     BT_CPPLOG_EX(bt2c::Logger::Level::Error, (_logger), (_fmt), ##__VA_ARGS__)
 629 #define BT_CPPLOGF_SPEC(_logger, _fmt, ...)                                                        \
 630     BT_CPPLOG_EX(bt2c::Logger::Level::Fatal, (_logger), (_fmt), ##__VA_ARGS__)
 631
 632 /*
 633  * BT_CPPLOG_EX() with specific logging levels and using the default
 634  * logger.
 635  */
 636 #define BT_CPPLOGT(_fmt, ...) BT_CPPLOGT_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 637 #define BT_CPPLOGD(_fmt, ...) BT_CPPLOGD_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 638 #define BT_CPPLOGI(_fmt, ...) BT_CPPLOGI_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 639 #define BT_CPPLOGW(_fmt, ...) BT_CPPLOGW_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 640 #define BT_CPPLOGE(_fmt, ...) BT_CPPLOGE_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 641 #define BT_CPPLOGF(_fmt, ...) BT_CPPLOGF_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 642
 643 /*
 644  * Calls logStr() on `_logger` to log using the level `_lvl`.
 645  */
 646 #define BT_CPPLOG_STR_EX(_lvl, _logger, _msg)                                                      \
 647     (_logger).logStr<(_lvl), false>(__FILE__, __func__, __LINE__, (_msg))
 648
 649 /*
 650  * BT_CPPLOG_STR_EX() with specific logging levels.
 651  */
 652 #define BT_CPPLOGT_STR_SPEC(_logger, _msg)                                                         \
 653     BT_CPPLOG_STR_EX(bt2c::Logger::Level::Trace, (_logger), (_msg))
 654 #define BT_CPPLOGD_STR_SPEC(_logger, _msg)                                                         \
 655     BT_CPPLOG_STR_EX(bt2c::Logger::Level::Debug, (_logger), (_msg))
 656 #define BT_CPPLOGI_STR_SPEC(_logger, _msg)                                                         \
 657     BT_CPPLOG_STR_EX(bt2c::Logger::Level::Info, (_logger), (_msg))
 658 #define BT_CPPLOGW_STR_SPEC(_logger, _msg)                                                         \
 659     BT_CPPLOG_STR_EX(bt2c::Logger::Level::Warning, (_logger), (_msg))
 660 #define BT_CPPLOGE_STR_SPEC(_logger, _msg)                                                         \
 661     BT_CPPLOG_STR_EX(bt2c::Logger::Level::Error, (_logger), (_msg))
 662 #define BT_CPPLOGF_STR_SPEC(_logger, _msg)                                                         \
 663     BT_CPPLOG_STR_EX(bt2c::Logger::Level::Fatal, (_logger), (_msg))
 664
 665 /*
 666  * BT_CPPLOG_STR_EX() with specific logging levels and using the default
 667  * logger.
 668  */
 669 #define BT_CPPLOGT_STR(_msg) BT_CPPLOGT_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 670 #define BT_CPPLOGD_STR(_msg) BT_CPPLOGD_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 671 #define BT_CPPLOGI_STR(_msg) BT_CPPLOGI_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 672 #define BT_CPPLOGW_STR(_msg) BT_CPPLOGW_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 673 #define BT_CPPLOGE_STR(_msg) BT_CPPLOGE_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 674 #define BT_CPPLOGF_STR(_msg) BT_CPPLOGF_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 675
 676 /*
 677  * Calls logMem() on `_logger` to log using the level `_lvl`.
 678  */
 679 #define BT_CPPLOG_MEM_EX(_lvl, _logger, _memData, _fmt, ...)                                       \
 680     do {                                                                                           \
 681         if (G_UNLIKELY((_logger).wouldLog(_lvl))) {                                                \
 682             (_logger).logMem<(_lvl)>(__FILE__, __func__, __LINE__, (_memData), (_fmt),             \
 683                                      ##__VA_ARGS__);                                               \
 684         }                                                                                          \
 685     } while (0)
 686
 687 /*
 688  * BT_CPPLOG_MEM_EX() with specific logging levels.
 689  */
 690 #define BT_CPPLOGT_MEM_SPEC(_logger, _memData, _fmt, ...)                                          \
 691     BT_CPPLOG_MEM_EX(bt2c::Logger::Level::Trace, (_logger), (_memData), (_fmt), ##__VA_ARGS__)
 692 #define BT_CPPLOGD_MEM_SPEC(_logger, _memData, _fmt, ...)                                          \
 693     BT_CPPLOG_MEM_EX(bt2c::Logger::Level::Debug, (_logger), (_memData), (_fmt), ##__VA_ARGS__)
 694 #define BT_CPPLOGI_MEM_SPEC(_logger, _memData, _fmt, ...)                                          \
 695     BT_CPPLOG_MEM_EX(bt2c::Logger::Level::Info, (_logger), (_memData), (_fmt), ##__VA_ARGS__)
 696 #define BT_CPPLOGW_MEM_SPEC(_logger, _memData, _fmt, ...)                                          \
 697     BT_CPPLOG_MEM_EX(bt2c::Logger::Level::Warning, (_logger), (_memData), (_fmt), ##__VA_ARGS__)
 698 #define BT_CPPLOGE_MEM_SPEC(_logger, _memData, _fmt, ...)                                          \
 699     BT_CPPLOG_MEM_EX(bt2c::Logger::Level::Error, (_logger), (_memData), (_fmt), ##__VA_ARGS__)
 700 #define BT_CPPLOGF_MEM_SPEC(_logger, _memData, _fmt, ...)                                          \
 701     BT_CPPLOG_MEM_EX(bt2c::Logger::Level::Fatal, (_logger), (_memData), (_fmt), ##__VA_ARGS__)
 702
 703 /*
 704  * BT_CPPLOG_MEM_EX() with specific logging levels and using the default
 705  * logger.
 706  */
 707 #define BT_CPPLOGT_MEM(_memData, _fmt, ...)                                                        \
 708     BT_CPPLOGT_MEM_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_fmt), ##__VA_ARGS__)
 709 #define BT_CPPLOGD_MEM(_memData, _fmt, ...)                                                        \
 710     BT_CPPLOGD_MEM_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_fmt), ##__VA_ARGS__)
 711 #define BT_CPPLOGI_MEM(_memData, _fmt, ...)                                                        \
 712     BT_CPPLOGI_MEM_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_fmt), ##__VA_ARGS__)
 713 #define BT_CPPLOGW_MEM(_memData, _fmt, ...)                                                        \
 714     BT_CPPLOGW_MEM_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_fmt), ##__VA_ARGS__)
 715 #define BT_CPPLOGE_MEM(_memData, _fmt, ...)                                                        \
 716     BT_CPPLOGE_MEM_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_fmt), ##__VA_ARGS__)
 717 #define BT_CPPLOGF_MEM(_memData, _fmt, ...)                                                        \
 718     BT_CPPLOGF_MEM_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_fmt), ##__VA_ARGS__)
 719
 720 /*
 721  * Calls logMemStr() on `_logger` to log using the level `_lvl`.
 722  */
 723 #define BT_CPPLOG_MEM_STR_EX(_lvl, _logger, _memData, _msg)                                        \
 724     (_logger).logMemStr<(_lvl)>(__FILE__, __func__, __LINE__, (_memData), (_msg))
 725
 726 /*
 727  * BT_CPPLOG_MEM_STR_EX() with specific logging levels.
 728  */
 729 #define BT_CPPLOGT_MEM_STR_SPEC(_logger, _memData, _msg)                                           \
 730     BT_CPPLOG_MEM_STR_EX(bt2c::Logger::Level::TRACE, (_logger), (_memData), (_msg))
 731 #define BT_CPPLOGD_MEM_STR_SPEC(_logger, _memData, _msg)                                           \
 732     BT_CPPLOG_MEM_STR_EX(bt2c::Logger::Level::DEBUG, (_logger), (_memData), (_msg))
 733 #define BT_CPPLOGI_MEM_STR_SPEC(_logger, _memData, _msg)                                           \
 734     BT_CPPLOG_MEM_STR_EX(bt2c::Logger::Level::INFO, (_logger), (_memData), (_msg))
 735 #define BT_CPPLOGW_MEM_STR_SPEC(_logger, _memData, _msg)                                           \
 736     BT_CPPLOG_MEM_STR_EX(bt2c::Logger::Level::WARNING, (_logger), (_memData), (_msg))
 737 #define BT_CPPLOGE_MEM_STR_SPEC(_logger, _memData, _msg)                                           \
 738     BT_CPPLOG_MEM_STR_EX(bt2c::Logger::Level::Error, (_logger), (_memData), (_msg))
 739 #define BT_CPPLOGF_MEM_STR_SPEC(_logger, _memData, _msg)                                           \
 740     BT_CPPLOG_MEM_STR_EX(bt2c::Logger::Level::FATAL, (_logger), (_memData), (_msg))
 741
 742 /*
 743  * BT_CPPLOG_MEM_STR_EX() with specific logging levels and using the
 744  * default logger.
 745  */
 746 #define BT_CPPLOGT_MEM_STR(_memData, _msg)                                                         \
 747     BT_CPPLOGT_MEM_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_msg))
 748 #define BT_CPPLOGD_MEM_STR(_memData, _msg)                                                         \
 749     BT_CPPLOGD_MEM_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_msg))
 750 #define BT_CPPLOGI_MEM_STR(_memData, _msg)                                                         \
 751     BT_CPPLOGI_MEM_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_msg))
 752 #define BT_CPPLOGW_MEM_STR(_memData, _msg)                                                         \
 753     BT_CPPLOGW_MEM_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_msg))
 754 #define BT_CPPLOGE_MEM_STR(_memData, _msg)                                                         \
 755     BT_CPPLOGE_MEM_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_msg))
 756 #define BT_CPPLOGF_MEM_STR(_memData, _msg)                                                         \
 757     BT_CPPLOGF_MEM_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_memData), (_msg))
 758
 759 /*
 760  * Calls logErrno() on `_logger` to log using the level `_lvl` and
 761  * initial message `_initMsg`.
 762  */
 763 #define BT_CPPLOG_ERRNO_EX(_lvl, _logger, _initMsg, _fmt, ...)                                     \
 764     do {                                                                                           \
 765         if (G_UNLIKELY((_logger).wouldLog(_lvl))) {                                                \
 766             (_logger).logErrno<(_lvl), false>(__FILE__, __func__, __LINE__, (_initMsg), (_fmt),    \
 767                                               ##__VA_ARGS__);                                      \
 768         }                                                                                          \
 769     } while (0)
 770
 771 /*
 772  * BT_CPPLOG_ERRNO_EX() with specific logging levels.
 773  */
 774 #define BT_CPPLOGT_ERRNO_SPEC(_logger, _initMsg, _fmt, ...)                                        \
 775     BT_CPPLOG_ERRNO_EX(bt2c::Logger::Level::Trace, (_logger), (_initMsg), (_fmt), ##__VA_ARGS__)
 776 #define BT_CPPLOGD_ERRNO_SPEC(_logger, _initMsg, _fmt, ...)                                        \
 777     BT_CPPLOG_ERRNO_EX(bt2c::Logger::Level::Debug, (_logger), (_initMsg), (_fmt), ##__VA_ARGS__)
 778 #define BT_CPPLOGI_ERRNO_SPEC(_logger, _initMsg, _fmt, ...)                                        \
 779     BT_CPPLOG_ERRNO_EX(bt2c::Logger::Level::Info, (_logger), (_initMsg), (_fmt), ##__VA_ARGS__)
 780 #define BT_CPPLOGW_ERRNO_SPEC(_logger, _initMsg, _fmt, ...)                                        \
 781     BT_CPPLOG_ERRNO_EX(bt2c::Logger::Level::Warning, (_logger), (_initMsg), (_fmt), ##__VA_ARGS__)
 782 #define BT_CPPLOGE_ERRNO_SPEC(_logger, _initMsg, _fmt, ...)                                        \
 783     BT_CPPLOG_ERRNO_EX(bt2c::Logger::Level::Error, (_logger), (_initMsg), (_fmt), ##__VA_ARGS__)
 784 #define BT_CPPLOGF_ERRNO_SPEC(_logger, _initMsg, _fmt, ...)                                        \
 785     BT_CPPLOG_ERRNO_EX(bt2c::Logger::Level::Fatal, (_logger), (_initMsg), (_fmt), ##__VA_ARGS__)
 786
 787 /*
 788  * BT_CPPLOG_ERRNO_EX() with specific logging levels and using the
 789  * default logger.
 790  */
 791 #define BT_CPPLOGT_ERRNO(_initMsg, _fmt, ...)                                                      \
 792     BT_CPPLOGT_ERRNO_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 793 #define BT_CPPLOGD_ERRNO(_initMsg, _fmt, ...)                                                      \
 794     BT_CPPLOGD_ERRNO_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 795 #define BT_CPPLOGI_ERRNO(_initMsg, _fmt, ...)                                                      \
 796     BT_CPPLOGI_ERRNO_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 797 #define BT_CPPLOGW_ERRNO(_initMsg, _fmt, ...)                                                      \
 798     BT_CPPLOGW_ERRNO_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 799 #define BT_CPPLOGE_ERRNO(_initMsg, _fmt, ...)                                                      \
 800     BT_CPPLOGE_ERRNO_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 801 #define BT_CPPLOGF_ERRNO(_initMsg, _fmt, ...)                                                      \
 802     BT_CPPLOGF_ERRNO_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 803
 804 /*
 805  * Calls logErrnoStr() on `_logger` to log using the level `_lvl` and
 806  * initial message `_initMsg`.
 807  */
 808 #define BT_CPPLOG_ERRNO_STR_EX(_lvl, _logger, _initMsg, _msg)                                      \
 809     (_logger).logErrnoStr<(_lvl), false>(__FILE__, __func__, __LINE__, (_initMsg), (_msg))
 810
 811 /*
 812  * BT_CPPLOG_ERRNO_STR_EX() with specific logging levels.
 813  */
 814 #define BT_CPPLOGT_ERRNO_STR_SPEC(_logger, _initMsg, _msg)                                         \
 815     BT_CPPLOG_ERRNO_STR_EX(bt2c::Logger::Level::Trace, (_logger), (_initMsg), (_msg))
 816 #define BT_CPPLOGD_ERRNO_STR_SPEC(_logger, _initMsg, _msg)                                         \
 817     BT_CPPLOG_ERRNO_STR_EX(bt2c::Logger::Level::Debug, (_logger), (_initMsg), (_msg))
 818 #define BT_CPPLOGI_ERRNO_STR_SPEC(_logger, _initMsg, _msg)                                         \
 819     BT_CPPLOG_ERRNO_STR_EX(bt2c::Logger::Level::Info, (_logger), (_initMsg), (_msg))
 820 #define BT_CPPLOGW_ERRNO_STR_SPEC(_logger, _initMsg, _msg)                                         \
 821     BT_CPPLOG_ERRNO_STR_EX(bt2c::Logger::Level::Warning, (_logger), (_initMsg), (_msg))
 822 #define BT_CPPLOGE_ERRNO_STR_SPEC(_logger, _initMsg, _msg)                                         \
 823     BT_CPPLOG_ERRNO_STR_EX(bt2c::Logger::Level::Error, (_logger), (_initMsg), (_msg))
 824 #define BT_CPPLOGF_ERRNO_STR_SPEC(_logger, _initMsg, _msg)                                         \
 825     BT_CPPLOG_ERRNO_STR_EX(bt2c::Logger::Level::Fatal, (_logger), (_initMsg), (_msg))
 826
 827 /*
 828  * BT_CPPLOG_ERRNO_STR_EX() with specific logging levels and using the
 829  * default logger.
 830  */
 831 #define BT_CPPLOGT_ERRNO_STR(_initMsg, _msg)                                                       \
 832     BT_CPPLOGT_ERRNO_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 833 #define BT_CPPLOGD_ERRNO_STR(_initMsg, _msg)                                                       \
 834     BT_CPPLOGD_ERRNO_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 835 #define BT_CPPLOGI_ERRNO_STR(_initMsg, _msg)                                                       \
 836     BT_CPPLOGI_ERRNO_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 837 #define BT_CPPLOGW_ERRNO_STR(_initMsg, _msg)                                                       \
 838     BT_CPPLOGW_ERRNO_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 839 #define BT_CPPLOGE_ERRNO_STR(_initMsg, _msg)                                                       \
 840     BT_CPPLOGE_ERRNO_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 841 #define BT_CPPLOGF_ERRNO_STR(_initMsg, _msg)                                                       \
 842     BT_CPPLOGF_ERRNO_STR_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 843
 844 /*
 845  * Calls log() on `_logger` with the `Error` level to log an error and
 846  * append a cause to the error of the current thread.
 847  */
 848 #define BT_CPPLOGE_APPEND_CAUSE_SPEC(_logger, _fmt, ...)                                           \
 849     (_logger).log<bt2c::Logger::Level::Error, true>(__FILE__, __func__, __LINE__, (_fmt),          \
 850                                                     ##__VA_ARGS__)
 851
 852 /*
 853  * BT_CPPLOGE_APPEND_CAUSE_SPEC() using the default logger.
 854  */
 855 #define BT_CPPLOGE_APPEND_CAUSE(_fmt, ...)                                                         \
 856     BT_CPPLOGE_APPEND_CAUSE_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 857
 858 /*
 859  * Calls logStr() on `_logger` with the `Error` level to log an error and
 860  * append a cause to the error of the current thread.
 861  */
 862 #define BT_CPPLOGE_STR_APPEND_CAUSE_SPEC(_logger, _msg)                                            \
 863     (_logger).logStr<bt2c::Logger::Level::Error, true>(__FILE__, __func__, __LINE__, (_msg))
 864
 865 /*
 866  * BT_CPPLOGE_STR_APPEND_CAUSE_SPEC() using the default logger.
 867  */
 868 #define BT_CPPLOGE_STR_APPEND_CAUSE(_msg)                                                          \
 869     BT_CPPLOGE_STR_APPEND_CAUSE_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 870
 871 /*
 872  * Calls logErrorAndThrow() on `_logger` to log an error, append a cause
 873  * to the error of the current thread, and throw an instance of
 874  * `_excCls`.
 875  */
 876 #define BT_CPPLOGE_APPEND_CAUSE_AND_THROW_SPEC(_logger, _excCls, _fmt, ...)                        \
 877     (_logger).logErrorAndThrow<true, _excCls>(__FILE__, __func__, __LINE__, (_fmt), ##__VA_ARGS__)
 878
 879 /*
 880  * BT_CPPLOGE_APPEND_CAUSE_AND_THROW_SPEC() using the default logger.
 881  */
 882 #define BT_CPPLOGE_APPEND_CAUSE_AND_THROW(_excCls, _fmt, ...)                                      \
 883     BT_CPPLOGE_APPEND_CAUSE_AND_THROW_SPEC(_BT_CPPLOG_DEF_LOGGER, _excCls, (_fmt), ##__VA_ARGS__)
 884
 885 /*
 886  * Calls logErrorStrAndThrow() on `_logger` to log an error, append a
 887  * cause to the error of the current thread, and throw an instance of
 888  * `_excCls`.
 889  */
 890 #define BT_CPPLOGE_STR_APPEND_CAUSE_AND_THROW_SPEC(_logger, _excCls, _msg)                         \
 891     (_logger).logErrorStrAndThrow<true, _excCls>(__FILE__, __func__, __LINE__, (_msg))
 892
 893 /*
 894  * BT_CPPLOGE_STR_APPEND_CAUSE_AND_THROW_SPEC() using the default
 895  * logger.
 896  */
 897 #define BT_CPPLOGE_STR_APPEND_CAUSE_AND_THROW(_excCls, _msg)                                       \
 898     BT_CPPLOGE_STR_APPEND_CAUSE_AND_THROW_SPEC(_BT_CPPLOG_DEF_LOGGER, _excCls, (_msg))
 899
 900 /*
 901  * Calls logErrorAndRethrow() on `_logger` to log an error, append a
 902  * cause to the error of the current thread, and throw an instance of
 903  * `_excCls`.
 904  */
 905 #define BT_CPPLOGE_APPEND_CAUSE_AND_RETHROW_SPEC(_logger, _fmt, ...)                               \
 906     (_logger).logErrorAndRethrow<true>(__FILE__, __func__, __LINE__, (_fmt), ##__VA_ARGS__)
 907
 908 /*
 909  * BT_CPPLOGE_APPEND_CAUSE_AND_RETHROW_SPEC() using the default logger.
 910  */
 911 #define BT_CPPLOGE_APPEND_CAUSE_AND_RETHROW(_fmt, ...)                                             \
 912     BT_CPPLOGE_APPEND_CAUSE_AND_RETHROW_SPEC(_BT_CPPLOG_DEF_LOGGER, (_fmt), ##__VA_ARGS__)
 913
 914 /*
 915  * Calls logErrorStrAndRethrow() on `_logger` to log an error, append a
 916  * cause to the error of the current thread, and throw an instance of
 917  * `_excCls`.
 918  */
 919 #define BT_CPPLOGE_STR_APPEND_CAUSE_AND_RETHROW_SPEC(_logger, _msg)                                \
 920     (_logger).logErrorStrAndRethrow<true>(__FILE__, __func__, __LINE__, (_msg))
 921
 922 /*
 923  * BT_CPPLOGE_STR_APPEND_CAUSE_AND_RETHROW_SPEC() using the default
 924  * logger.
 925  */
 926 #define BT_CPPLOGE_STR_APPEND_CAUSE_AND_RETHROW(_msg)                                              \
 927     BT_CPPLOGE_STR_APPEND_CAUSE_AND_RETHROW_SPEC(_BT_CPPLOG_DEF_LOGGER, (_msg))
 928
 929 /*
 930  * Calls logErrno() on `_logger` with the `Level::Error` level to log an
 931  * error and append a cause to the error of the current thread.
 932  */
 933 #define BT_CPPLOGE_ERRNO_APPEND_CAUSE_SPEC(_logger, _initMsg, _fmt, ...)                           \
 934     (_logger).logErrno<bt2c::Logger::Level::Error, true>(__FILE__, __func__, __LINE__, (_initMsg), \
 935                                                          (_fmt), ##__VA_ARGS__)
 936
 937 /*
 938  * BT_CPPLOGE_ERRNO_APPEND_CAUSE_SPEC() using the default logger.
 939  */
 940 #define BT_CPPLOGE_ERRNO_APPEND_CAUSE(_initMsg, _fmt, ...)                                         \
 941     BT_CPPLOGE_ERRNO_APPEND_CAUSE_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt), ##__VA_ARGS__)
 942
 943 /*
 944  * Calls logErrnoStr() on `_logger` with the `Level::Error` level to log
 945  * an error and append a cause to the error of the current thread.
 946  */
 947 #define BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_SPEC(_logger, _initMsg, _msg)                            \
 948     (_logger).logErrnoStr<bt2c::Logger::Level::Error, true>(__FILE__, __func__, __LINE__,          \
 949                                                             (_initMsg), (_msg))
 950
 951 /*
 952  * BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_SPEC() using the default logger.
 953  */
 954 #define BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE(_initMsg, _msg)                                          \
 955     BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
 956
 957 /*
 958  * Calls logErrorErrnoAndThrow() on `_logger` to log an error, append a
 959  * cause to the error of the current thread, and throw an instance of
 960  * `_excCls`.
 961  */
 962 #define BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_THROW_SPEC(_logger, _excCls, _initMsg, _fmt, ...)        \
 963     (_logger).logErrorErrnoAndThrow<true, _excCls>(__FILE__, __func__, __LINE__, (_initMsg),       \
 964                                                    (_fmt), ##__VA_ARGS__)
 965
 966 /*
 967  * BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_THROW_SPEC() using the default
 968  * logger.
 969  */
 970 #define BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_THROW(_excCls, _initMsg, _fmt, ...)                      \
 971     BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_THROW_SPEC(_BT_CPPLOG_DEF_LOGGER, _excCls, (_initMsg),       \
 972                                                  (_fmt), ##__VA_ARGS__)
 973
 974 /*
 975  * Calls logErrorErrnoStrAndThrow() on `_logger` to log an error, append
 976  * a cause to the error of the current thread, and throw an instance of
 977  * `_excCls`.
 978  */
 979 #define BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_THROW_SPEC(_logger, _excCls, _initMsg, _msg)         \
 980     (_logger).logErrorErrnoStrAndThrow<true, _excCls>(__FILE__, __func__, __LINE__, (_initMsg),    \
 981                                                       (_msg))
 982
 983 /*
 984  * BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_THROW_SPEC() using the default
 985  * logger.
 986  */
 987 #define BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_THROW(_excCls, _initMsg, _msg)                       \
 988     BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_THROW_SPEC(_BT_CPPLOG_DEF_LOGGER, _excCls, (_initMsg),   \
 989                                                      (_msg))
 990
 991 /*
 992  * Calls logErrorErrnoAndRethrow() on `_logger` to log an error, append
 993  * a cause to the error of the current thread, and throw an instance of
 994  * `_excCls`.
 995  */
 996 #define BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_RETHROW_SPEC(_logger, _initMsg, _fmt, ...)               \
 997     (_logger).logErrorErrnoAndRethrow<true>(__FILE__, __func__, __LINE__, (_initMsg), (_fmt),      \
 998                                             ##__VA_ARGS__)
 999
1000 /*
1001  * BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_RETHROW_SPEC() using the default
1002  * logger.
1003  */
1004 #define BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_RETHROW(_initMsg, _fmt, ...)                             \
1005     BT_CPPLOGE_ERRNO_APPEND_CAUSE_AND_RETHROW_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_fmt),      \
1006                                                    ##__VA_ARGS__)
1007
1008 /*
1009  * Calls logErrorErrnoStrAndRethrow() on `_logger` to log an error,
1010  * append a cause to the error of the current thread, and throw an
1011  * instance of `_excCls`.
1012  */
1013 #define BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_RETHROW_SPEC(_logger, _initMsg, _msg)                \
1014     (_logger).logErrorErrnoStrAndRethrow<true>(__FILE__, __func__, __LINE__, (_initMsg), (_msg))
1015
1016 /*
1017  * BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_RETHROW_SPEC() using the
1018  * default logger.
1019  */
1020 #define BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_RETHROW(_initMsg, _msg)                              \
1021     BT_CPPLOGE_ERRNO_STR_APPEND_CAUSE_AND_RETHROW_SPEC(_BT_CPPLOG_DEF_LOGGER, (_initMsg), (_msg))
1022
1023 #endif /* BABELTRACE_CPP_COMMON_BT2C_LOGGING_HPP */