blob: 40966f51c7e3f9fd486afac3e24c9a9cc98a4cbe [file] [log] [blame]
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#import "chrome/app/breakpad_mac.h"
#include <CoreFoundation/CoreFoundation.h>
#import <Foundation/Foundation.h>
#include "base/auto_reset.h"
#include "base/base_switches.h"
#import "base/basictypes.h"
#include "base/command_line.h"
#include "base/file_path.h"
#include "base/file_util.h"
#import "base/logging.h"
#include "base/mac/mac_util.h"
#include "base/mac/scoped_cftyperef.h"
#import "base/mac/scoped_nsautorelease_pool.h"
#include "base/path_service.h"
#include "base/sys_string_conversions.h"
#import "breakpad/src/client/mac/Framework/Breakpad.h"
#include "chrome/common/child_process_logging.h"
#include "chrome/common/chrome_paths.h"
#include "chrome/common/chrome_switches.h"
#include "chrome/common/env_vars.h"
#include "chrome/installer/util/google_update_settings.h"
#include "policy/policy_constants.h"
namespace {
BreakpadRef gBreakpadRef = NULL;
void SetCrashKeyValue(NSString* key, NSString* value) {
// Comment repeated from header to prevent confusion:
// IMPORTANT: On OS X, the key/value pairs are sent to the crash server
// out of bounds and not recorded on disk in the minidump, this means
// that if you look at the minidump file locally you won't see them!
if (gBreakpadRef == NULL) {
BreakpadAddUploadParameter(gBreakpadRef, key, value);
void ClearCrashKeyValue(NSString* key) {
if (gBreakpadRef == NULL) {
BreakpadRemoveUploadParameter(gBreakpadRef, key);
bool FatalMessageHandler(int severity, const char* file, int line,
size_t message_start, const std::string& str) {
// Do not handle non-FATAL.
if (severity != logging::LOG_FATAL)
return false;
// In case of OOM condition, this code could be reentered when
// constructing and storing the key. Using a static is not
// thread-safe, but if multiple threads are in the process of a
// fatal crash at the same time, this should work.
static bool guarded = false;
if (guarded)
return false;
AutoReset<bool> guard(&guarded, true);
// Only log last path component. This matches
if (file) {
const char* slash = strrchr(file, '/');
if (slash)
file = slash + 1;
NSString* fatal_key = @"LOG_FATAL";
NSString* fatal_value =
[NSString stringWithFormat:@"%s:%d: %s",
file, line, str.c_str() + message_start];
SetCrashKeyValue(fatal_key, fatal_value);
// Rather than including the code to force the crash here, allow the
// caller to do it.
return false;
} // namespace
bool IsCrashReporterEnabled() {
return gBreakpadRef != NULL;
// Only called for a branded build of
void InitCrashReporter() {
base::mac::ScopedNSAutoreleasePool autorelease_pool;
// Check whether crash reporting should be enabled. If enterprise
// configuration management controls crash reporting, it takes precedence.
// Otherwise, check whether the user has consented to stats and crash
// reporting. The browser process can make this determination directly.
// Helper processes may not have access to the disk or to the same data as
// the browser process, so the browser passes the decision to them on the
// command line.
NSBundle* main_bundle = base::mac::MainAppBundle();
bool is_browser = !base::mac::IsBackgroundOnlyProcess();
bool enable_breakpad = false;
CommandLine* command_line = CommandLine::ForCurrentProcess();
if (is_browser) {
// Since the configuration management infrastructure is possibly not
// initialized when this code runs, read the policy preference directly.
base::mac::ScopedCFTypeRef<CFStringRef> key(
Boolean key_valid;
Boolean metrics_reporting_enabled = CFPreferencesGetAppBooleanValue(key,
kCFPreferencesCurrentApplication, &key_valid);
if (key_valid &&
CFPreferencesAppValueIsForced(key, kCFPreferencesCurrentApplication)) {
// Controlled by configuration manangement.
enable_breakpad = metrics_reporting_enabled;
} else {
// Controlled by the user. The crash reporter may be enabled by
// preference or through an environment variable, but the kDisableBreakpad
// switch overrides both.
enable_breakpad = GoogleUpdateSettings::GetCollectStatsConsent() ||
getenv(env_vars::kHeadless) != NULL;
enable_breakpad &= !command_line->HasSwitch(switches::kDisableBreakpad);
} else {
// This is a helper process, check the command line switch.
enable_breakpad = command_line->HasSwitch(switches::kEnableCrashReporter);
if (!enable_breakpad) {
LOG_IF(INFO, is_browser) << "Breakpad disabled";
// Tell Breakpad where crash_inspector and crash_report_sender are.
NSString* resource_path = [main_bundle resourcePath];
NSString *inspector_location =
[resource_path stringByAppendingPathComponent:@"crash_inspector"];
NSString *reporter_bundle_location =
[resource_path stringByAppendingPathComponent:@""];
NSString *reporter_location =
[[NSBundle bundleWithPath:reporter_bundle_location] executablePath];
NSDictionary* info_dictionary = [main_bundle infoDictionary];
NSMutableDictionary *breakpad_config =
[[info_dictionary mutableCopy] autorelease];
[breakpad_config setObject:inspector_location
[breakpad_config setObject:reporter_location
// In the main application (the browser process), crashes can be passed to
// the system's Crash Reporter. This allows the system to notify the user
// when the application crashes, and provide the user with the option to
// restart it.
if (is_browser)
[breakpad_config setObject:@"NO" forKey:@BREAKPAD_SEND_AND_EXIT];
// By setting the BREAKPAD_DUMP_LOCATION environment variable, an alternate
// location to write brekapad crash dumps can be set.
const char* alternate_minidump_location = getenv("BREAKPAD_DUMP_LOCATION");
if (alternate_minidump_location) {
FilePath alternate_minidump_location_path(alternate_minidump_location);
if (!file_util::PathExists(alternate_minidump_location_path)) {
LOG(ERROR) << "Directory " << alternate_minidump_location <<
" doesn't exist";
} else {
if (is_browser) {
// Print out confirmation message to the stdout, but only print
// from browser process so we don't flood the terminal.
LOG(WARNING) << "Breakpad dumps will now be written in " <<
FilePath dir_crash_dumps;
PathService::Get(chrome::DIR_CRASH_DUMPS, &dir_crash_dumps);
[breakpad_config setObject:base::SysUTF8ToNSString(dir_crash_dumps.value())
// Initialize Breakpad.
gBreakpadRef = BreakpadCreate(breakpad_config);
if (!gBreakpadRef) {
LOG(ERROR) << "Breakpad initializaiton failed";
// Set Breakpad metadata values. These values are added to Info.plist during
// the branded Google build.
SetCrashKeyValue(@"ver", [info_dictionary objectForKey:@BREAKPAD_VERSION]);
SetCrashKeyValue(@"prod", [info_dictionary objectForKey:@BREAKPAD_PRODUCT]);
SetCrashKeyValue(@"plat", @"OS X");
// Enable child process crashes to include the page URL.
// TODO: Should this only be done for certain process types?
if (!is_browser) {
// Get the guid from the command line switch.
std::string guid =
void InitCrashProcessInfo() {
if (gBreakpadRef == NULL) {
// Determine the process type.
NSString* process_type = @"browser";
std::string process_type_switch =
if (!process_type_switch.empty()) {
process_type = base::SysUTF8ToNSString(process_type_switch);
// Store process type in crash dump.
SetCrashKeyValue(@"ptype", process_type);