blob: 4f40372c5b1a1673535167fe975d9640b0101fd9 [file] [log] [blame]
// Copyright 2014 The Crashpad Authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#include <fcntl.h>
#include <getopt.h>
#include <libgen.h>
#include <stdio.h>
#include <string.h>
#include <sys/types.h>
#include <unistd.h>
#include <algorithm>
#include <string>
#include <vector>
#include "base/files/scoped_file.h"
#include "base/logging.h"
#include "base/mac/mach_logging.h"
#include "tools/tool_support.h"
#include "util/mach/bootstrap.h"
#include "util/mach/exc_server_variants.h"
#include "util/mach/exception_behaviors.h"
#include "util/mach/exception_types.h"
#include "util/mach/mach_extensions.h"
#include "util/mach/mach_message.h"
#include "util/mach/mach_message_server.h"
#include "util/mach/symbolic_constants_mach.h"
#include "util/posix/symbolic_constants_posix.h"
#include "util/stdlib/string_number_conversion.h"
namespace crashpad {
namespace {
struct Options {
std::string file_path;
std::string mach_service;
FILE* file;
int timeout_secs;
bool has_timeout;
MachMessageServer::Persistent persistent;
};
class ExceptionServer : public UniversalMachExcServer::Interface {
public:
ExceptionServer(const Options& options,
const std::string& me,
int* exceptions_handled)
: UniversalMachExcServer::Interface(),
options_(options),
me_(me),
exceptions_handled_(exceptions_handled) {}
// UniversalMachExcServer::Interface:
virtual kern_return_t CatchMachException(
exception_behavior_t behavior,
exception_handler_t exception_port,
thread_t thread,
task_t task,
exception_type_t exception,
const mach_exception_data_type_t* code,
mach_msg_type_number_t code_count,
thread_state_flavor_t* flavor,
ConstThreadState old_state,
mach_msg_type_number_t old_state_count,
thread_state_t new_state,
mach_msg_type_number_t* new_state_count,
const mach_msg_trailer_t* trailer,
bool* destroy_complex_request) override {
*destroy_complex_request = true;
++*exceptions_handled_;
fprintf(options_.file,
"%s: behavior %s",
me_.c_str(),
ExceptionBehaviorToString(
behavior, kUseFullName | kUnknownIsNumeric | kUseOr).c_str());
kern_return_t kr;
if (ExceptionBehaviorHasIdentity(behavior)) {
// It’s not possible to call pid_for_task() once EXC_CORPSE_NOTIFY has
// been generated. It is possible to obtain the process ID by mapping the
// corpse kcdata area from the task’s address space at code[0] (size
// code[1]) and locating TASK_CRASHINFO_PID within that area. This area
// also includes TASK_CRASHINFO_CRASHED_THREADID which could be used
// instead of thread_info() below, and TASK_CRASHINFO_EXCEPTION_CODES
// which could be used to recover the exception codes passed to the
// EXC_CRASH handler. None of this is currently done because corpses are a
// new 10.11-only feature. See 10.11 <corpses/task_corpse.h> and
// <kern/kern_cdata.h>.
if (exception != EXC_CORPSE_NOTIFY) {
pid_t pid;
kr = pid_for_task(task, &pid);
if (kr != KERN_SUCCESS) {
fprintf(options_.file, "\n");
fflush(options_.file);
MACH_LOG(ERROR, kr) << "pid_for_task";
return KERN_FAILURE;
}
fprintf(options_.file, ", pid %d", pid);
}
thread_identifier_info identifier_info;
mach_msg_type_number_t count = THREAD_IDENTIFIER_INFO_COUNT;
kr = thread_info(thread,
THREAD_IDENTIFIER_INFO,
reinterpret_cast<thread_info_t>(&identifier_info),
&count);
if (kr != KERN_SUCCESS) {
fprintf(options_.file, "\n");
fflush(options_.file);
MACH_LOG(ERROR, kr) << "thread_info";
return KERN_FAILURE;
}
fprintf(options_.file, ", thread %lld", identifier_info.thread_id);
}
fprintf(
options_.file,
", exception %s, codes[%d]",
ExceptionToString(exception, kUseFullName | kUnknownIsNumeric).c_str(),
code_count);
for (size_t index = 0; index < code_count; ++index) {
fprintf(options_.file,
"%s %#llx",
index != 0 ? "," : "",
code[index]);
}
if (exception == EXC_CRASH) {
mach_exception_code_t original_code_0;
int signal;
exception_type_t original_exception =
ExcCrashRecoverOriginalException(code[0], &original_code_0, &signal);
fprintf(options_.file,
", original exception %s, original code[0] %lld, signal %s",
ExceptionToString(original_exception,
kUseFullName | kUnknownIsNumeric).c_str(),
original_code_0,
SignalToString(signal, kUseFullName | kUnknownIsNumeric).c_str());
}
if (ExceptionBehaviorHasState(behavior)) {
std::string flavor_string =
ThreadStateFlavorToString(*flavor, kUseFullName | kUnknownIsNumeric);
fprintf(options_.file,
", flavor %s, old_state_count %d",
flavor_string.c_str(),
old_state_count);
}
fprintf(options_.file, "\n");
fflush(options_.file);
if (exception != EXC_CRASH && exception != kMachExceptionSimulated) {
// Find another handler.
return KERN_FAILURE;
}
ExcServerCopyState(
behavior, old_state, old_state_count, new_state, new_state_count);
return ExcServerSuccessfulReturnValue(exception, behavior, false);
}
private:
const Options& options_;
const std::string& me_;
int* exceptions_handled_;
};
void Usage(const std::string& me) {
fprintf(stderr,
"Usage: %s -m SERVICE [OPTION]...\n"
"Catch Mach exceptions and display information about them.\n"
"\n"
" -f, --file=FILE append information to FILE instead of stdout\n"
" -m, --mach-service=SERVICE register SERVICE with the bootstrap server\n"
" -p, --persistent continue processing exceptions after the first\n"
" -t, --timeout=TIMEOUT run for a maximum of TIMEOUT seconds\n"
" --help display this help and exit\n"
" --version output version information and exit\n",
me.c_str());
ToolSupport::UsageTail(me);
}
int CatchExceptionToolMain(int argc, char* argv[]) {
const std::string me(basename(argv[0]));
enum OptionFlags {
// “Short” (single-character) options.
kOptionFile = 'f',
kOptionMachService = 'm',
kOptionPersistent = 'p',
kOptionTimeout = 't',
// Long options without short equivalents.
kOptionLastChar = 255,
// Standard options.
kOptionHelp = -2,
kOptionVersion = -3,
};
Options options = {};
static constexpr option long_options[] = {
{"file", required_argument, nullptr, kOptionFile},
{"mach-service", required_argument, nullptr, kOptionMachService},
{"persistent", no_argument, nullptr, kOptionPersistent},
{"timeout", required_argument, nullptr, kOptionTimeout},
{"help", no_argument, nullptr, kOptionHelp},
{"version", no_argument, nullptr, kOptionVersion},
{nullptr, 0, nullptr, 0},
};
int opt;
while ((opt = getopt_long(argc, argv, "f:m:pt:", long_options, nullptr)) !=
-1) {
switch (opt) {
case kOptionFile:
options.file_path = optarg;
break;
case kOptionMachService:
options.mach_service = optarg;
break;
case kOptionPersistent:
options.persistent = MachMessageServer::kPersistent;
break;
case kOptionTimeout:
if (!StringToNumber(optarg, &options.timeout_secs) ||
options.timeout_secs < 0) {
ToolSupport::UsageHint(me, "-t requires a zero or positive TIMEOUT");
return EXIT_FAILURE;
}
options.has_timeout = true;
break;
case kOptionHelp:
Usage(me);
return EXIT_SUCCESS;
case kOptionVersion:
ToolSupport::Version(me);
return EXIT_SUCCESS;
default:
ToolSupport::UsageHint(me, nullptr);
return EXIT_FAILURE;
}
}
argc -= optind;
argv += optind;
if (options.mach_service.empty()) {
ToolSupport::UsageHint(me, "-m is required");
return EXIT_FAILURE;
}
base::mac::ScopedMachReceiveRight
service_port(BootstrapCheckIn(options.mach_service));
if (service_port == kMachPortNull) {
return EXIT_FAILURE;
}
base::ScopedFILE file_owner;
if (options.file_path.empty()) {
options.file = stdout;
} else {
file_owner.reset(fopen(options.file_path.c_str(), "a"));
if (!file_owner.get()) {
PLOG(ERROR) << "fopen " << options.file_path;
return EXIT_FAILURE;
}
options.file = file_owner.get();
if (fcntl(fileno(options.file), F_SETFD, FD_CLOEXEC) == -1) {
PLOG(ERROR) << "fcntl " << options.file_path;
return EXIT_FAILURE;
}
}
int exceptions_handled = 0;
ExceptionServer exception_server(options, me, &exceptions_handled);
UniversalMachExcServer universal_mach_exc_server(&exception_server);
// Assume that if persistent mode has been requested, it’s desirable to ignore
// large messages and keep running.
MachMessageServer::ReceiveLarge receive_large =
(options.persistent == MachMessageServer::kPersistent)
? MachMessageServer::kReceiveLargeIgnore
: MachMessageServer::kReceiveLargeError;
mach_msg_timeout_t timeout_ms;
if (!options.has_timeout) {
timeout_ms = kMachMessageTimeoutWaitIndefinitely;
} else if (options.timeout_secs == 0) {
timeout_ms = kMachMessageTimeoutNonblocking;
} else {
timeout_ms = options.timeout_secs * 1000;
}
mach_msg_return_t mr = MachMessageServer::Run(&universal_mach_exc_server,
service_port.get(),
MACH_MSG_OPTION_NONE,
options.persistent,
receive_large,
timeout_ms);
if (mr == MACH_RCV_TIMED_OUT && options.has_timeout && options.persistent &&
exceptions_handled) {
// This is not an error: when exiting on timeout during persistent
// processing and at least one exception was handled, it’s considered a
// success.
} else if (mr != MACH_MSG_SUCCESS) {
MACH_LOG(ERROR, mr) << "MachMessageServer::Run";
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}
} // namespace
} // namespace crashpad
int main(int argc, char* argv[]) {
return crashpad::CatchExceptionToolMain(argc, argv);
}