247 lines
7.5 KiB
C++
247 lines
7.5 KiB
C++
/**
|
|
******************************************************************************
|
|
* Xenia : Xbox 360 Emulator Research Project *
|
|
******************************************************************************
|
|
* Copyright 2021 Ben Vanik. All rights reserved. *
|
|
* Released under the BSD license - see LICENSE in the root for more details. *
|
|
******************************************************************************
|
|
*/
|
|
|
|
#ifndef XENIA_BASE_LOGGING_H_
|
|
#define XENIA_BASE_LOGGING_H_
|
|
|
|
#include <cstdarg>
|
|
#include <cstdint>
|
|
#include <string>
|
|
|
|
#include "third_party/fmt/include/fmt/format.h"
|
|
#include "third_party/fmt/include/fmt/std.h"
|
|
#include "xenia/base/string.h"
|
|
|
|
namespace xe {
|
|
|
|
#define XE_OPTION_ENABLE_LOGGING 1
|
|
|
|
// Log level is a general indication of the importance of a given log line.
|
|
//
|
|
// While log levels are named, they are a rough correlation of what the log line
|
|
// may be related to. These names should not be taken as fact as what a given
|
|
// log line from any log level actually is.
|
|
enum class LogLevel {
|
|
Disabled = -1,
|
|
Error = 0,
|
|
Warning,
|
|
Info,
|
|
Debug,
|
|
Trace,
|
|
};
|
|
|
|
// bitmasks!
|
|
namespace LogSrc {
|
|
enum : uint32_t { Uncategorized = 0, Kernel = 1, Apu = 2, Cpu = 4, Gpu = 8 };
|
|
}
|
|
|
|
class LogSink {
|
|
public:
|
|
virtual ~LogSink() = default;
|
|
|
|
virtual void Write(const char* buf, size_t size) = 0;
|
|
virtual void Flush() = 0;
|
|
};
|
|
|
|
class FileLogSink final : public LogSink {
|
|
public:
|
|
explicit FileLogSink(FILE* file, bool own_file)
|
|
: file_(file), owns_file_(own_file) {}
|
|
~FileLogSink();
|
|
|
|
void Write(const char* buf, size_t size) override;
|
|
void Flush() override;
|
|
|
|
private:
|
|
FILE* file_;
|
|
bool owns_file_;
|
|
};
|
|
|
|
class DebugPrintLogSink final : public LogSink {
|
|
public:
|
|
DebugPrintLogSink() = default;
|
|
|
|
void Write(const char* buf, size_t size) override;
|
|
void Flush() override {}
|
|
};
|
|
|
|
// Initializes the logging system and any outputs requested.
|
|
// Must be called on startup.
|
|
void InitializeLogging(const std::string_view app_name);
|
|
void ShutdownLogging();
|
|
|
|
namespace logging {
|
|
|
|
constexpr char kPrefixCharError = '!';
|
|
constexpr char kPrefixCharWarning = 'w';
|
|
constexpr char kPrefixCharInfo = 'i';
|
|
constexpr char kPrefixCharDebug = 'd';
|
|
|
|
void ToggleLogLevel();
|
|
bool ShouldLog(LogLevel log_level,
|
|
uint32_t log_mask = xe::LogSrc::Uncategorized);
|
|
namespace internal {
|
|
|
|
uint32_t GetLogLevel();
|
|
std::pair<char*, size_t> GetThreadBuffer();
|
|
|
|
XE_NOALIAS
|
|
void AppendLogLine(LogLevel log_level, const char prefix_char, size_t written);
|
|
|
|
} // namespace internal
|
|
// technically, noalias is incorrect here, these functions do in fact alias
|
|
// global memory, but msvc will not optimize the calls away, and the global
|
|
// memory modified by the calls is limited to internal logging variables, so it
|
|
// might as well be noalias
|
|
template <typename... Args>
|
|
XE_NOALIAS XE_NOINLINE XE_COLD static void AppendLogLineFormat_Impl(
|
|
LogLevel log_level, const char prefix_char, std::string_view format,
|
|
const Args&... args) noexcept {
|
|
auto target = internal::GetThreadBuffer();
|
|
auto result = fmt::format_to_n(target.first, target.second,
|
|
fmt::runtime(format), args...);
|
|
internal::AppendLogLine(log_level, prefix_char, result.size);
|
|
}
|
|
|
|
// Appends a line to the log with {fmt}-style formatting.
|
|
// chrispy: inline the initial check, outline the append. the append should
|
|
// happen rarely for end users
|
|
template <typename... Args>
|
|
XE_FORCEINLINE static void AppendLogLineFormat(uint32_t log_src_mask,
|
|
LogLevel log_level,
|
|
const char prefix_char,
|
|
std::string_view format,
|
|
const Args&... args) noexcept {
|
|
if (!ShouldLog(log_level, log_src_mask)) {
|
|
return;
|
|
}
|
|
AppendLogLineFormat_Impl(log_level, prefix_char, format, args...);
|
|
}
|
|
|
|
// Appends a line to the log.
|
|
void AppendLogLine(LogLevel log_level, const char prefix_char,
|
|
const std::string_view str,
|
|
uint32_t log_mask = LogSrc::Uncategorized);
|
|
|
|
template <LogLevel ll>
|
|
struct LoggerBatch {
|
|
char* thrd_buf; // current position in thread buffer
|
|
size_t thrd_buf_rem; // num left in thrd buffer
|
|
size_t total_size;
|
|
|
|
void reset() {
|
|
auto target = logging::internal::GetThreadBuffer();
|
|
|
|
thrd_buf = target.first;
|
|
thrd_buf_rem = target.second;
|
|
total_size = 0;
|
|
}
|
|
|
|
LoggerBatch() { reset(); }
|
|
template <size_t fmtlen, typename... Ts>
|
|
void operator()(const char (&fmt)[fmtlen], Ts&&... args) {
|
|
auto tmpres =
|
|
fmt::format_to_n(thrd_buf, thrd_buf_rem, fmt::runtime(fmt), args...);
|
|
thrd_buf_rem -= tmpres.size;
|
|
thrd_buf = tmpres.out;
|
|
total_size += tmpres.size;
|
|
}
|
|
|
|
void submit(char prefix_char) {
|
|
logging::internal::AppendLogLine(ll, prefix_char, total_size);
|
|
}
|
|
};
|
|
|
|
} // namespace logging
|
|
|
|
// Logs a fatal error and aborts the program.
|
|
[[noreturn]] void FatalError(const std::string_view str);
|
|
|
|
} // namespace xe
|
|
|
|
#if XE_OPTION_ENABLE_LOGGING
|
|
|
|
template <typename... Args>
|
|
XE_COLD void XELOGE(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(
|
|
xe::LogSrc::Uncategorized, xe::LogLevel::Error,
|
|
xe::logging::kPrefixCharError, format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
XE_COLD void XELOGW(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(
|
|
xe::LogSrc::Uncategorized, xe::LogLevel::Warning,
|
|
xe::logging::kPrefixCharWarning, format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGI(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(
|
|
xe::LogSrc::Uncategorized, xe::LogLevel::Info,
|
|
xe::logging::kPrefixCharInfo, format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGD(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(
|
|
xe::LogSrc::Uncategorized, xe::LogLevel::Debug,
|
|
xe::logging::kPrefixCharDebug, format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGCPU(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(xe::LogSrc::Cpu, xe::LogLevel::Info, 'C',
|
|
format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGAPU(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(xe::LogSrc::Apu, xe::LogLevel::Debug, 'A',
|
|
format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGGPU(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(xe::LogSrc::Gpu, xe::LogLevel::Debug, 'G',
|
|
format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGKERNEL(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(xe::LogSrc::Kernel, xe::LogLevel::Info, 'K',
|
|
format, args...);
|
|
}
|
|
|
|
template <typename... Args>
|
|
void XELOGFS(std::string_view format, const Args&... args) {
|
|
xe::logging::AppendLogLineFormat(xe::LogSrc::Uncategorized,
|
|
xe::LogLevel::Info, 'F', format, args...);
|
|
}
|
|
|
|
#else
|
|
|
|
#define __XELOGDUMMY \
|
|
do { \
|
|
} while (false)
|
|
|
|
#define XELOGE(...) __XELOGDUMMY
|
|
#define XELOGW(...) __XELOGDUMMY
|
|
#define XELOGI(...) __XELOGDUMMY
|
|
#define XELOGD(...) __XELOGDUMMY
|
|
#define XELOGCPU(...) __XELOGDUMMY
|
|
#define XELOGAPU(...) __XELOGDUMMY
|
|
#define XELOGGPU(...) __XELOGDUMMY
|
|
#define XELOGKERNEL(...) __XELOGDUMMY
|
|
#define XELOGFS(...) __XELOGDUMMY
|
|
|
|
#endif // ENABLE_LOGGING
|
|
|
|
#endif // XENIA_BASE_LOGGING_H_
|