1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #include "base/logging.h"
10 typedef HANDLE FileHandle;
11 typedef HANDLE MutexHandle;
12 // Windows warns on using write(). It prefers _write().
13 #define write(fd, buf, count) _write(fd, buf, static_cast<unsigned int>(count))
14 // Windows doesn't define STDERR_FILENO. Define it here.
15 #define STDERR_FILENO 2
16 #elif defined(OS_MACOSX)
17 #include <mach/mach.h>
18 #include <mach/mach_time.h>
19 #include <mach-o/dyld.h>
20 #elif defined(OS_POSIX)
22 #include <sys/time.h> // timespec doesn't seem to be in <time.h>
24 #include <sys/syscall.h>
36 #define MAX_PATH PATH_MAX
37 typedef FILE* FileHandle;
38 typedef pthread_mutex_t* MutexHandle;
48 #include "base/base_switches.h"
49 #include "base/command_line.h"
50 #include "base/debug/alias.h"
51 #include "base/debug/debugger.h"
52 #include "base/debug/stack_trace.h"
53 #include "base/posix/eintr_wrapper.h"
54 #include "base/strings/string_piece.h"
55 #include "base/strings/string_util.h"
56 #include "base/strings/stringprintf.h"
57 #include "base/strings/utf_string_conversions.h"
58 #include "base/synchronization/lock_impl.h"
59 #include "base/threading/platform_thread.h"
60 #include "base/vlog.h"
62 #include "base/safe_strerror_posix.h"
65 #if defined(OS_ANDROID)
66 #include <android/log.h>
73 VlogInfo* g_vlog_info = NULL;
74 VlogInfo* g_vlog_info_prev = NULL;
76 const char* const log_severity_names[LOG_NUM_SEVERITIES] = {
77 "INFO", "WARNING", "ERROR", "ERROR_REPORT", "FATAL" };
79 const char* log_severity_name(int severity)
81 if (severity >= 0 && severity < LOG_NUM_SEVERITIES)
82 return log_severity_names[severity];
86 int min_log_level = 0;
88 LoggingDestination logging_destination = LOG_DEFAULT;
90 // For LOG_ERROR and above, always print to stderr.
91 const int kAlwaysPrintErrorLevel = LOG_ERROR;
93 // Which log file to use? This is initialized by InitLogging or
94 // will be lazily initialized to the default value when it is
97 typedef std::wstring PathString;
99 typedef std::string PathString;
101 PathString* log_file_name = NULL;
103 // this file is lazily opened and the handle may be NULL
104 FileHandle log_file = NULL;
106 // what should be prepended to each message?
107 bool log_process_id = false;
108 bool log_thread_id = false;
109 bool log_timestamp = true;
110 bool log_tickcount = false;
112 // Should we pop up fatal debug messages in a dialog?
113 bool show_error_dialogs = false;
115 // An assert handler override specified by the client to be called instead of
116 // the debug message dialog and process termination.
117 LogAssertHandlerFunction log_assert_handler = NULL;
118 // An report handler override specified by the client to be called instead of
119 // the debug message dialog.
120 LogReportHandlerFunction log_report_handler = NULL;
121 // A log message handler that gets notified of every log message we process.
122 LogMessageHandlerFunction log_message_handler = NULL;
124 // Helper functions to wrap platform differences.
126 int32 CurrentProcessId() {
128 return GetCurrentProcessId();
129 #elif defined(OS_POSIX)
136 return GetTickCount();
137 #elif defined(OS_MACOSX)
138 return mach_absolute_time();
139 #elif defined(OS_NACL)
140 // NaCl sadly does not have _POSIX_TIMERS enabled in sys/features.h
141 // So we have to use clock() for now.
143 #elif defined(OS_POSIX)
145 clock_gettime(CLOCK_MONOTONIC, &ts);
147 uint64 absolute_micro =
148 static_cast<int64>(ts.tv_sec) * 1000000 +
149 static_cast<int64>(ts.tv_nsec) / 1000;
151 return absolute_micro;
155 void DeleteFilePath(const PathString& log_name) {
157 DeleteFile(log_name.c_str());
158 #elif defined (OS_NACL)
159 // Do nothing; unlink() isn't supported on NaCl.
161 unlink(log_name.c_str());
165 PathString GetDefaultLogFile() {
167 // On Windows we use the same path as the exe.
168 wchar_t module_name[MAX_PATH];
169 GetModuleFileName(NULL, module_name, MAX_PATH);
171 PathString log_file = module_name;
172 PathString::size_type last_backslash =
173 log_file.rfind('\\', log_file.size());
174 if (last_backslash != PathString::npos)
175 log_file.erase(last_backslash + 1);
176 log_file += L"debug.log";
178 #elif defined(OS_POSIX)
179 // On other platforms we just use the current directory.
180 return PathString("debug.log");
184 // This class acts as a wrapper for locking the logging files.
185 // LoggingLock::Init() should be called from the main thread before any logging
186 // is done. Then whenever logging, be sure to have a local LoggingLock
187 // instance on the stack. This will ensure that the lock is unlocked upon
188 // exiting the frame.
189 // LoggingLocks can not be nested.
200 static void Init(LogLockingState lock_log, const PathChar* new_log_file) {
203 lock_log_file = lock_log;
204 if (lock_log_file == LOCK_LOG_FILE) {
207 std::wstring safe_name;
209 safe_name = new_log_file;
211 safe_name = GetDefaultLogFile();
212 // \ is not a legal character in mutex names so we replace \ with /
213 std::replace(safe_name.begin(), safe_name.end(), '\\', '/');
214 std::wstring t(L"Global\\");
216 log_mutex = ::CreateMutex(NULL, FALSE, t.c_str());
218 if (log_mutex == NULL) {
220 // Keep the error code for debugging
221 int error = GetLastError(); // NOLINT
222 base::debug::BreakDebugger();
224 // Return nicely without putting initialized to true.
230 log_lock = new base::internal::LockImpl();
236 static void LockLogging() {
237 if (lock_log_file == LOCK_LOG_FILE) {
239 ::WaitForSingleObject(log_mutex, INFINITE);
240 // WaitForSingleObject could have returned WAIT_ABANDONED. We don't
241 // abort the process here. UI tests might be crashy sometimes,
242 // and aborting the test binary only makes the problem worse.
243 // We also don't use LOG macros because that might lead to an infinite
244 // loop. For more info see http://crbug.com/18028.
245 #elif defined(OS_POSIX)
246 pthread_mutex_lock(&log_mutex);
254 static void UnlockLogging() {
255 if (lock_log_file == LOCK_LOG_FILE) {
257 ReleaseMutex(log_mutex);
258 #elif defined(OS_POSIX)
259 pthread_mutex_unlock(&log_mutex);
266 // The lock is used if log file locking is false. It helps us avoid problems
267 // with multiple threads writing to the log file at the same time. Use
268 // LockImpl directly instead of using Lock, because Lock makes logging calls.
269 static base::internal::LockImpl* log_lock;
271 // When we don't use a lock, we are using a global mutex. We need to do this
272 // because LockFileEx is not thread safe.
274 static MutexHandle log_mutex;
275 #elif defined(OS_POSIX)
276 static pthread_mutex_t log_mutex;
279 static bool initialized;
280 static LogLockingState lock_log_file;
284 bool LoggingLock::initialized = false;
286 base::internal::LockImpl* LoggingLock::log_lock = NULL;
288 LogLockingState LoggingLock::lock_log_file = LOCK_LOG_FILE;
292 MutexHandle LoggingLock::log_mutex = NULL;
293 #elif defined(OS_POSIX)
294 pthread_mutex_t LoggingLock::log_mutex = PTHREAD_MUTEX_INITIALIZER;
297 // Called by logging functions to ensure that debug_file is initialized
298 // and can be used for writing. Returns false if the file could not be
299 // initialized. debug_file will be NULL in this case.
300 bool InitializeLogFileHandle() {
304 if (!log_file_name) {
305 // Nobody has called InitLogging to specify a debug log file, so here we
306 // initialize the log file name to a default.
307 log_file_name = new PathString(GetDefaultLogFile());
310 if ((logging_destination & LOG_TO_FILE) != 0) {
312 log_file = CreateFile(log_file_name->c_str(), GENERIC_WRITE,
313 FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
314 OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
315 if (log_file == INVALID_HANDLE_VALUE || log_file == NULL) {
316 // try the current directory
317 log_file = CreateFile(L".\\debug.log", GENERIC_WRITE,
318 FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
319 OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
320 if (log_file == INVALID_HANDLE_VALUE || log_file == NULL) {
325 SetFilePointer(log_file, 0, 0, FILE_END);
326 #elif defined(OS_POSIX)
327 log_file = fopen(log_file_name->c_str(), "a");
328 if (log_file == NULL)
336 void CloseFile(FileHandle log) {
344 void CloseLogFileUnlocked() {
354 LoggingSettings::LoggingSettings()
355 : logging_dest(LOG_DEFAULT),
357 lock_log(LOCK_LOG_FILE),
358 delete_old(APPEND_TO_OLD_LOG_FILE) {}
360 bool BaseInitLoggingImpl(const LoggingSettings& settings) {
362 // Can log only to the system debug log.
363 CHECK_EQ(settings.logging_dest & ~LOG_TO_SYSTEM_DEBUG_LOG, 0);
365 CommandLine* command_line = CommandLine::ForCurrentProcess();
366 // Don't bother initializing g_vlog_info unless we use one of the
368 if (command_line->HasSwitch(switches::kV) ||
369 command_line->HasSwitch(switches::kVModule)) {
370 // NOTE: If g_vlog_info has already been initialized, it might be in use
371 // by another thread. Don't delete the old VLogInfo, just create a second
372 // one. We keep track of both to avoid memory leak warnings.
373 CHECK(!g_vlog_info_prev);
374 g_vlog_info_prev = g_vlog_info;
377 new VlogInfo(command_line->GetSwitchValueASCII(switches::kV),
378 command_line->GetSwitchValueASCII(switches::kVModule),
382 logging_destination = settings.logging_dest;
384 // ignore file options unless logging to file is set.
385 if ((logging_destination & LOG_TO_FILE) == 0)
388 LoggingLock::Init(settings.lock_log, settings.log_file);
389 LoggingLock logging_lock;
391 // Calling InitLogging twice or after some log call has already opened the
392 // default log file will re-initialize to the new options.
393 CloseLogFileUnlocked();
396 log_file_name = new PathString();
397 *log_file_name = settings.log_file;
398 if (settings.delete_old == DELETE_OLD_LOG_FILE)
399 DeleteFilePath(*log_file_name);
401 return InitializeLogFileHandle();
404 void SetMinLogLevel(int level) {
405 min_log_level = std::min(LOG_ERROR_REPORT, level);
408 int GetMinLogLevel() {
409 return min_log_level;
412 int GetVlogVerbosity() {
413 return std::max(-1, LOG_INFO - GetMinLogLevel());
416 int GetVlogLevelHelper(const char* file, size_t N) {
418 // Note: g_vlog_info may change on a different thread during startup
419 // (but will always be valid or NULL).
420 VlogInfo* vlog_info = g_vlog_info;
422 vlog_info->GetVlogLevel(base::StringPiece(file, N - 1)) :
426 void SetLogItems(bool enable_process_id, bool enable_thread_id,
427 bool enable_timestamp, bool enable_tickcount) {
428 log_process_id = enable_process_id;
429 log_thread_id = enable_thread_id;
430 log_timestamp = enable_timestamp;
431 log_tickcount = enable_tickcount;
434 void SetShowErrorDialogs(bool enable_dialogs) {
435 show_error_dialogs = enable_dialogs;
438 void SetLogAssertHandler(LogAssertHandlerFunction handler) {
439 log_assert_handler = handler;
442 void SetLogReportHandler(LogReportHandlerFunction handler) {
443 log_report_handler = handler;
446 void SetLogMessageHandler(LogMessageHandlerFunction handler) {
447 log_message_handler = handler;
450 LogMessageHandlerFunction GetLogMessageHandler() {
451 return log_message_handler;
454 // MSVC doesn't like complex extern templates and DLLs.
455 #if !defined(COMPILER_MSVC)
456 // Explicit instantiations for commonly used comparisons.
457 template std::string* MakeCheckOpString<int, int>(
458 const int&, const int&, const char* names);
459 template std::string* MakeCheckOpString<unsigned long, unsigned long>(
460 const unsigned long&, const unsigned long&, const char* names);
461 template std::string* MakeCheckOpString<unsigned long, unsigned int>(
462 const unsigned long&, const unsigned int&, const char* names);
463 template std::string* MakeCheckOpString<unsigned int, unsigned long>(
464 const unsigned int&, const unsigned long&, const char* names);
465 template std::string* MakeCheckOpString<std::string, std::string>(
466 const std::string&, const std::string&, const char* name);
469 // Displays a message box to the user with the error message in it.
470 // Used for fatal messages, where we close the app simultaneously.
471 // This is for developers only; we don't use this in circumstances
472 // (like release builds) where users could see it, since users don't
473 // understand these messages anyway.
474 void DisplayDebugMessageInDialog(const std::string& str) {
478 if (!show_error_dialogs)
482 // For Windows programs, it's possible that the message loop is
483 // messed up on a fatal error, and creating a MessageBox will cause
484 // that message loop to be run. Instead, we try to spawn another
485 // process that displays its command line. We look for "Debug
486 // Message.exe" in the same directory as the application. If it
487 // exists, we use it, otherwise, we use a regular message box.
488 wchar_t prog_name[MAX_PATH];
489 GetModuleFileNameW(NULL, prog_name, MAX_PATH);
490 wchar_t* backslash = wcsrchr(prog_name, '\\');
493 wcscat_s(prog_name, MAX_PATH, L"debug_message.exe");
495 std::wstring cmdline = base::UTF8ToWide(str);
499 STARTUPINFO startup_info;
500 memset(&startup_info, 0, sizeof(startup_info));
501 startup_info.cb = sizeof(startup_info);
503 PROCESS_INFORMATION process_info;
504 if (CreateProcessW(prog_name, &cmdline[0], NULL, NULL, false, 0, NULL,
505 NULL, &startup_info, &process_info)) {
506 WaitForSingleObject(process_info.hProcess, INFINITE);
507 CloseHandle(process_info.hThread);
508 CloseHandle(process_info.hProcess);
510 // debug process broken, let's just do a message box
511 MessageBoxW(NULL, &cmdline[0], L"Fatal error",
512 MB_OK | MB_ICONHAND | MB_TOPMOST);
515 // We intentionally don't implement a dialog on other platforms.
516 // You can just look at stderr.
521 LogMessage::SaveLastError::SaveLastError() : last_error_(::GetLastError()) {
524 LogMessage::SaveLastError::~SaveLastError() {
525 ::SetLastError(last_error_);
527 #endif // defined(OS_WIN)
529 LogMessage::LogMessage(const char* file, int line, LogSeverity severity,
531 : severity_(severity), file_(file), line_(line) {
535 LogMessage::LogMessage(const char* file, int line)
536 : severity_(LOG_INFO), file_(file), line_(line) {
540 LogMessage::LogMessage(const char* file, int line, LogSeverity severity)
541 : severity_(severity), file_(file), line_(line) {
545 LogMessage::LogMessage(const char* file, int line, std::string* result)
546 : severity_(LOG_FATAL), file_(file), line_(line) {
548 stream_ << "Check failed: " << *result;
552 LogMessage::LogMessage(const char* file, int line, LogSeverity severity,
554 : severity_(severity), file_(file), line_(line) {
556 stream_ << "Check failed: " << *result;
560 LogMessage::~LogMessage() {
561 #if !defined(NDEBUG) && !defined(OS_NACL) && !defined(__UCLIBC__)
562 if (severity_ == LOG_FATAL) {
563 // Include a stack trace on a fatal.
564 base::debug::StackTrace trace;
565 stream_ << std::endl; // Newline to separate from log message.
566 trace.OutputToStream(&stream_);
569 stream_ << std::endl;
570 std::string str_newline(stream_.str());
572 // Give any log message handler first dibs on the message.
573 if (log_message_handler &&
574 log_message_handler(severity_, file_, line_,
575 message_start_, str_newline)) {
576 // The handler took care of it, no further processing.
580 if ((logging_destination & LOG_TO_SYSTEM_DEBUG_LOG) != 0) {
582 OutputDebugStringA(str_newline.c_str());
583 #elif defined(OS_ANDROID)
584 android_LogPriority priority =
585 (severity_ < 0) ? ANDROID_LOG_VERBOSE : ANDROID_LOG_UNKNOWN;
588 priority = ANDROID_LOG_INFO;
591 priority = ANDROID_LOG_WARN;
594 case LOG_ERROR_REPORT:
595 priority = ANDROID_LOG_ERROR;
598 priority = ANDROID_LOG_FATAL;
601 __android_log_write(priority, "chromium", str_newline.c_str());
603 ignore_result(fwrite(str_newline.data(), str_newline.size(), 1, stderr));
605 } else if (severity_ >= kAlwaysPrintErrorLevel) {
606 // When we're only outputting to a log file, above a certain log level, we
607 // should still output to stderr so that we can better detect and diagnose
608 // problems with unit tests, especially on the buildbots.
609 ignore_result(fwrite(str_newline.data(), str_newline.size(), 1, stderr));
614 if ((logging_destination & LOG_TO_FILE) != 0) {
615 // We can have multiple threads and/or processes, so try to prevent them
616 // from clobbering each other's writes.
617 // If the client app did not call InitLogging, and the lock has not
618 // been created do it now. We do this on demand, but if two threads try
619 // to do this at the same time, there will be a race condition to create
620 // the lock. This is why InitLogging should be called from the main
621 // thread at the beginning of execution.
622 LoggingLock::Init(LOCK_LOG_FILE, NULL);
623 LoggingLock logging_lock;
624 if (InitializeLogFileHandle()) {
626 SetFilePointer(log_file, 0, 0, SEEK_END);
629 static_cast<const void*>(str_newline.c_str()),
630 static_cast<DWORD>(str_newline.length()),
634 ignore_result(fwrite(
635 str_newline.data(), str_newline.size(), 1, log_file));
641 if (severity_ == LOG_FATAL) {
642 // Ensure the first characters of the string are on the stack so they
643 // are contained in minidumps for diagnostic purposes.
644 char str_stack[1024];
645 str_newline.copy(str_stack, arraysize(str_stack));
646 base::debug::Alias(str_stack);
648 if (log_assert_handler) {
649 // Make a copy of the string for the handler out of paranoia.
650 log_assert_handler(std::string(stream_.str()));
652 // Don't use the string with the newline, get a fresh version to send to
653 // the debug message process. We also don't display assertions to the
654 // user in release mode. The enduser can't do anything with this
655 // information, and displaying message boxes when the application is
656 // hosed can cause additional problems.
658 DisplayDebugMessageInDialog(stream_.str());
660 // Crash the process to generate a dump.
661 base::debug::BreakDebugger();
663 } else if (severity_ == LOG_ERROR_REPORT) {
664 // We are here only if the user runs with --enable-dcheck in release mode.
665 if (log_report_handler) {
666 log_report_handler(std::string(stream_.str()));
668 DisplayDebugMessageInDialog(stream_.str());
673 // writes the common header info to the stream
674 void LogMessage::Init(const char* file, int line) {
675 base::StringPiece filename(file);
676 size_t last_slash_pos = filename.find_last_of("\\/");
677 if (last_slash_pos != base::StringPiece::npos)
678 filename.remove_prefix(last_slash_pos + 1);
680 // TODO(darin): It might be nice if the columns were fixed width.
684 stream_ << CurrentProcessId() << ':';
686 stream_ << base::PlatformThread::CurrentId() << ':';
688 time_t t = time(NULL);
689 struct tm local_time = {0};
691 localtime_s(&local_time, &t);
693 localtime_r(&t, &local_time);
695 struct tm* tm_time = &local_time;
696 stream_ << std::setfill('0')
697 << std::setw(2) << 1 + tm_time->tm_mon
698 << std::setw(2) << tm_time->tm_mday
700 << std::setw(2) << tm_time->tm_hour
701 << std::setw(2) << tm_time->tm_min
702 << std::setw(2) << tm_time->tm_sec
706 stream_ << TickCount() << ':';
708 stream_ << log_severity_name(severity_);
710 stream_ << "VERBOSE" << -severity_;
712 stream_ << ":" << filename << "(" << line << ")] ";
714 message_start_ = stream_.tellp();
718 // This has already been defined in the header, but defining it again as DWORD
719 // ensures that the type used in the header is equivalent to DWORD. If not,
720 // the redefinition is a compile error.
721 typedef DWORD SystemErrorCode;
724 SystemErrorCode GetLastSystemErrorCode() {
726 return ::GetLastError();
727 #elif defined(OS_POSIX)
730 #error Not implemented
735 BASE_EXPORT std::string SystemErrorCodeToString(SystemErrorCode error_code) {
736 const int error_message_buffer_size = 256;
737 char msgbuf[error_message_buffer_size];
738 DWORD flags = FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS;
739 DWORD len = FormatMessageA(flags, NULL, error_code, 0, msgbuf,
740 arraysize(msgbuf), NULL);
742 // Messages returned by system end with line breaks.
743 return base::CollapseWhitespaceASCII(msgbuf, true) +
744 base::StringPrintf(" (0x%X)", error_code);
746 return base::StringPrintf("Error (0x%X) while retrieving error. (0x%X)",
747 GetLastError(), error_code);
749 #elif defined(OS_POSIX)
750 BASE_EXPORT std::string SystemErrorCodeToString(SystemErrorCode error_code) {
751 return safe_strerror(error_code);
754 #error Not implemented
759 Win32ErrorLogMessage::Win32ErrorLogMessage(const char* file,
761 LogSeverity severity,
764 log_message_(file, line, severity) {
767 Win32ErrorLogMessage::~Win32ErrorLogMessage() {
768 stream() << ": " << SystemErrorCodeToString(err_);
769 // We're about to crash (CHECK). Put |err_| on the stack (by placing it in a
770 // field) and use Alias in hopes that it makes it into crash dumps.
771 DWORD last_error = err_;
772 base::debug::Alias(&last_error);
774 #elif defined(OS_POSIX)
775 ErrnoLogMessage::ErrnoLogMessage(const char* file,
777 LogSeverity severity,
780 log_message_(file, line, severity) {
783 ErrnoLogMessage::~ErrnoLogMessage() {
784 stream() << ": " << SystemErrorCodeToString(err_);
788 void CloseLogFile() {
789 LoggingLock logging_lock;
790 CloseLogFileUnlocked();
793 void RawLog(int level, const char* message) {
794 if (level >= min_log_level) {
795 size_t bytes_written = 0;
796 const size_t message_len = strlen(message);
798 while (bytes_written < message_len) {
800 write(STDERR_FILENO, message + bytes_written,
801 message_len - bytes_written));
803 // Give up, nothing we can do now.
809 if (message_len > 0 && message[message_len - 1] != '\n') {
811 rv = HANDLE_EINTR(write(STDERR_FILENO, "\n", 1));
813 // Give up, nothing we can do now.
820 if (level == LOG_FATAL)
821 base::debug::BreakDebugger();
824 // This was defined at the beginning of this file.
828 std::wstring GetLogFileFullPath() {
830 return *log_file_name;
831 return std::wstring();
835 } // namespace logging
837 std::ostream& operator<<(std::ostream& out, const wchar_t* wstr) {
838 return out << base::WideToUTF8(std::wstring(wstr));