| OLD | NEW |
| (Empty) |
| 1 // Copyright 2017 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. | |
| 4 | |
| 5 #include "components/crash/content/app/fallback_crash_handler_win.h" | |
| 6 | |
| 7 #include <dbghelp.h> | |
| 8 | |
| 9 #include <algorithm> | |
| 10 #include <map> | |
| 11 #include <vector> | |
| 12 | |
| 13 #include "base/command_line.h" | |
| 14 #include "base/files/file.h" | |
| 15 #include "base/files/file_util.h" | |
| 16 #include "base/numerics/safe_conversions.h" | |
| 17 #include "base/process/process_handle.h" | |
| 18 #include "base/strings/string_number_conversions.h" | |
| 19 #include "base/win/scoped_handle.h" | |
| 20 #include "base/win/win_util.h" | |
| 21 #include "third_party/crashpad/crashpad/client/crash_report_database.h" | |
| 22 #include "third_party/crashpad/crashpad/client/settings.h" | |
| 23 #include "third_party/crashpad/crashpad/minidump/minidump_extensions.h" | |
| 24 | |
| 25 namespace crash_reporter { | |
| 26 | |
| 27 namespace { | |
| 28 | |
| 29 using FilePosition = uint32_t; | |
| 30 const FilePosition kInvalidFilePos = static_cast<FilePosition>(-1); | |
| 31 | |
| 32 using StringStringMap = std::map<std::string, std::string>; | |
| 33 | |
| 34 // This class is a helper to edit minidump files written by MiniDumpWriteDump. | |
| 35 // It assumes the minidump file it operates on has a directory entry pointing to | |
| 36 // a CrashpadInfo entry, which it updates to point to the SimpleDictionary data | |
| 37 // it appends to the file contents. | |
| 38 class MinidumpUpdater { | |
| 39 public: | |
| 40 MinidumpUpdater(); | |
| 41 | |
| 42 // Reads the existing directory from |file|. | |
| 43 bool Initialize(base::File* file); | |
| 44 | |
| 45 // Appends the simple dictionary with |crash_keys| to the file, and updates | |
| 46 // the CrashpadInfo with its location. | |
| 47 bool AppendSimpleDictionary(const StringStringMap& crash_keys); | |
| 48 | |
| 49 private: | |
| 50 // Writes |data_len| bytes from |data| to the file at the current location. | |
| 51 bool WriteData(const void* data, size_t data_len); | |
| 52 bool WriteAndAdvance(const void* data, | |
| 53 size_t data_len, | |
| 54 FilePosition* position); | |
| 55 | |
| 56 base::File* file_; | |
| 57 std::vector<MINIDUMP_DIRECTORY> directory_; | |
| 58 }; | |
| 59 | |
| 60 MinidumpUpdater::MinidumpUpdater() : file_(nullptr) {} | |
| 61 | |
| 62 bool MinidumpUpdater::Initialize(base::File* file) { | |
| 63 DCHECK(file && file->IsValid()); | |
| 64 DCHECK(!file_); | |
| 65 | |
| 66 // Read the file header. | |
| 67 MINIDUMP_HEADER header = {}; | |
| 68 int bytes_read = | |
| 69 file->Read(0, reinterpret_cast<char*>(&header), sizeof(header)); | |
| 70 if (bytes_read != sizeof(header)) | |
| 71 return false; | |
| 72 if (header.Signature != MINIDUMP_SIGNATURE || header.NumberOfStreams == 0) | |
| 73 return false; | |
| 74 | |
| 75 // Read the stream directory. | |
| 76 directory_.resize(header.NumberOfStreams); | |
| 77 int bytes_to_read = header.NumberOfStreams * sizeof(directory_[0]); | |
| 78 bytes_read = | |
| 79 file->Read(header.StreamDirectoryRva, | |
| 80 reinterpret_cast<char*>(&directory_[0]), bytes_to_read); | |
| 81 if (bytes_read != bytes_to_read) | |
| 82 return false; | |
| 83 | |
| 84 // Crashpad has some fairly unreasonable checking on the minidump header and | |
| 85 // directory. Match with those checks for now to allow Crashpad to read the | |
| 86 // CrashpadInfo and upload these dumps. | |
| 87 | |
| 88 // Start by removing any unused directory entries. | |
| 89 // TODO(siggi): Fix Crashpad to ignore unused streams. | |
| 90 directory_.erase(std::remove_if(directory_.begin(), directory_.end(), | |
| 91 [](const MINIDUMP_DIRECTORY& entry) { | |
| 92 return entry.StreamType == UnusedStream; | |
| 93 })); | |
| 94 | |
| 95 // Update the header. | |
| 96 // TODO(siggi): Fix Crashpad's version checking. | |
| 97 header.Version = MINIDUMP_VERSION; | |
| 98 header.NumberOfStreams = base::saturated_cast<ULONG32>(directory_.size()); | |
| 99 | |
| 100 // Write back the potentially shortened and packed dictionary. | |
| 101 int bytes_to_write = header.NumberOfStreams * sizeof(directory_[0]); | |
| 102 int bytes_written = | |
| 103 file->Write(header.StreamDirectoryRva, | |
| 104 reinterpret_cast<char*>(&directory_[0]), bytes_to_write); | |
| 105 if (bytes_written != bytes_to_write) | |
| 106 return false; | |
| 107 | |
| 108 // Write back the header. | |
| 109 bytes_written = | |
| 110 file->Write(0, reinterpret_cast<char*>(&header), sizeof(header)); | |
| 111 if (bytes_written != sizeof(header)) | |
| 112 return false; | |
| 113 | |
| 114 // Success, stash the file. | |
| 115 file_ = file; | |
| 116 | |
| 117 return true; | |
| 118 } | |
| 119 | |
| 120 bool MinidumpUpdater::AppendSimpleDictionary( | |
| 121 const StringStringMap& crash_keys) { | |
| 122 DCHECK(file_); | |
| 123 | |
| 124 // Start by finding the Crashpad directory entry and reading the CrashpadInfo. | |
| 125 FilePosition crashpad_info_pos = 0; | |
| 126 crashpad::MinidumpCrashpadInfo crashpad_info; | |
| 127 for (const auto& entry : directory_) { | |
| 128 if (entry.StreamType == crashpad::kMinidumpStreamTypeCrashpadInfo) { | |
| 129 // This file is freshly written, so it must contain the same version | |
| 130 // CrashpadInfo structure this code compiled against. | |
| 131 if (entry.Location.DataSize != sizeof(crashpad_info)) | |
| 132 return false; | |
| 133 | |
| 134 crashpad_info_pos = entry.Location.Rva; | |
| 135 break; | |
| 136 } | |
| 137 } | |
| 138 | |
| 139 // No CrashpadInfo directory entry found. | |
| 140 if (crashpad_info_pos == 0) | |
| 141 return false; | |
| 142 | |
| 143 int bytes_read = | |
| 144 file_->Read(crashpad_info_pos, reinterpret_cast<char*>(&crashpad_info), | |
| 145 sizeof(crashpad_info)); | |
| 146 if (bytes_read != sizeof(crashpad_info)) | |
| 147 return false; | |
| 148 | |
| 149 if (crashpad_info.version != crashpad::MinidumpCrashpadInfo::kVersion) | |
| 150 return false; | |
| 151 | |
| 152 // Seek to the tail of the file, where we're going to extend it. | |
| 153 FilePosition next_available_byte = file_->Seek(base::File::FROM_END, 0); | |
| 154 if (next_available_byte == kInvalidFilePos) | |
| 155 return false; | |
| 156 | |
| 157 // Write the key/value pairs and collect their locations. | |
| 158 std::vector<crashpad::MinidumpSimpleStringDictionaryEntry> entries; | |
| 159 for (const auto& kv : crash_keys) { | |
| 160 crashpad::MinidumpSimpleStringDictionaryEntry entry = {0}; | |
| 161 | |
| 162 entry.key = next_available_byte; | |
| 163 uint32_t key_len = base::saturated_cast<uint32_t>(kv.first.size()); | |
| 164 if (!WriteAndAdvance(&key_len, sizeof(key_len), &next_available_byte) || | |
| 165 !WriteAndAdvance(&kv.first[0], key_len, &next_available_byte)) { | |
| 166 return false; | |
| 167 } | |
| 168 | |
| 169 entry.value = next_available_byte; | |
| 170 uint32_t value_len = base::saturated_cast<uint32_t>(kv.second.size()); | |
| 171 if (!WriteAndAdvance(&value_len, sizeof(value_len), &next_available_byte) || | |
| 172 !WriteAndAdvance(&kv.second[0], value_len, &next_available_byte)) { | |
| 173 return false; | |
| 174 } | |
| 175 | |
| 176 entries.push_back(entry); | |
| 177 } | |
| 178 | |
| 179 // Write the dictionary array itself - note the array is count-prefixed. | |
| 180 FilePosition dict_pos = next_available_byte; | |
| 181 uint32_t entry_count = base::saturated_cast<uint32_t>(entries.size()); | |
| 182 if (!WriteAndAdvance(&entry_count, sizeof(entry_count), | |
| 183 &next_available_byte) || | |
| 184 !WriteAndAdvance(&entries[0], entry_count * sizeof(entries[0]), | |
| 185 &next_available_byte)) { | |
| 186 return false; | |
| 187 } | |
| 188 | |
| 189 // Touch up the CrashpadInfo and write it back to the file. | |
| 190 crashpad_info.simple_annotations.DataSize = next_available_byte - dict_pos; | |
| 191 crashpad_info.simple_annotations.Rva = dict_pos; | |
| 192 | |
| 193 int bytes_written = file_->Write( | |
| 194 crashpad_info_pos, reinterpret_cast<const char*>(&crashpad_info), | |
| 195 sizeof(crashpad_info)); | |
| 196 if (bytes_written != sizeof(crashpad_info)) | |
| 197 return false; | |
| 198 | |
| 199 return true; | |
| 200 } | |
| 201 | |
| 202 bool MinidumpUpdater::WriteData(const void* data, size_t data_len) { | |
| 203 DCHECK(file_); | |
| 204 DCHECK(data); | |
| 205 DCHECK_NE(0U, data_len); | |
| 206 | |
| 207 if (data_len > INT_MAX) | |
| 208 return false; | |
| 209 | |
| 210 int bytes_to_write = static_cast<int>(data_len); | |
| 211 int written_bytes = file_->WriteAtCurrentPos( | |
| 212 reinterpret_cast<const char*>(data), bytes_to_write); | |
| 213 if (written_bytes == -1) | |
| 214 return false; | |
| 215 | |
| 216 return true; | |
| 217 } | |
| 218 | |
| 219 bool MinidumpUpdater::WriteAndAdvance(const void* data, | |
| 220 size_t data_len, | |
| 221 FilePosition* position) { | |
| 222 DCHECK(position); | |
| 223 DCHECK_EQ(file_->Seek(base::File::FROM_CURRENT, 0), *position); | |
| 224 | |
| 225 if (!WriteData(data, data_len)) | |
| 226 return false; | |
| 227 | |
| 228 *position += base::saturated_cast<FilePosition>(data_len); | |
| 229 return true; | |
| 230 } | |
| 231 | |
| 232 // Writes a minidump file for |process| to |dump_file| with embedded | |
| 233 // CrashpadInfo, containing |crash_keys|, |client_id| and |report_id|. | |
| 234 // The |dump_file| must be open for read as well as write. | |
| 235 bool MiniDumpWriteDumpWithCrashpadInfo(const base::Process& process, | |
| 236 uint32_t minidump_type, | |
| 237 MINIDUMP_EXCEPTION_INFORMATION* exc_info, | |
| 238 const StringStringMap& crash_keys, | |
| 239 const crashpad::UUID& client_id, | |
| 240 const crashpad::UUID& report_id, | |
| 241 base::File* dump_file) { | |
| 242 DCHECK(process.IsValid()); | |
| 243 DCHECK(exc_info); | |
| 244 DCHECK(dump_file && dump_file->IsValid()); | |
| 245 | |
| 246 // The CrashpadInfo structure and its associated directory entry are injected | |
| 247 // into the minidump, to minimize the work to patching up the dump. | |
| 248 crashpad::MinidumpCrashpadInfo crashpad_info; | |
| 249 crashpad_info.version = crashpad::MinidumpCrashpadInfo::kVersion; | |
| 250 crashpad_info.client_id = client_id; | |
| 251 crashpad_info.report_id = report_id; | |
| 252 | |
| 253 MINIDUMP_USER_STREAM crashpad_info_stream = { | |
| 254 crashpad::kMinidumpStreamTypeCrashpadInfo, // Type | |
| 255 sizeof(crashpad_info), // BufferSize | |
| 256 &crashpad_info // Buffer | |
| 257 }; | |
| 258 MINIDUMP_USER_STREAM_INFORMATION user_stream_info = { | |
| 259 1, // UserStreamCount | |
| 260 &crashpad_info_stream // UserStreamArray | |
| 261 }; | |
| 262 | |
| 263 // Write the minidump to the provided dump file. | |
| 264 if (!MiniDumpWriteDump( | |
| 265 process.Handle(), // Process handle. | |
| 266 process.Pid(), // Process Id. | |
| 267 dump_file->GetPlatformFile(), // File handle. | |
| 268 static_cast<MINIDUMP_TYPE>(minidump_type), // Minidump type. | |
| 269 exc_info, // Exception Param | |
| 270 &user_stream_info, // UserStreamParam, | |
| 271 nullptr)) { // CallbackParam | |
| 272 return false; | |
| 273 } | |
| 274 | |
| 275 // Retouch the minidump to make it Crashpad compatible. | |
| 276 MinidumpUpdater updater; | |
| 277 if (!updater.Initialize(dump_file)) | |
| 278 return false; | |
| 279 if (!updater.AppendSimpleDictionary(crash_keys)) | |
| 280 return false; | |
| 281 | |
| 282 return true; | |
| 283 } | |
| 284 | |
| 285 // Appends the full contents of |source| to |dest| from the current position | |
| 286 // of |dest|. | |
| 287 bool AppendFileContents(base::File* source, base::PlatformFile dest) { | |
| 288 DCHECK(source && source->IsValid()); | |
| 289 DCHECK_NE(base::kInvalidPlatformFile, dest); | |
| 290 | |
| 291 // Rewind the source. | |
| 292 if (source->Seek(base::File::FROM_BEGIN, 0) == kInvalidFilePos) | |
| 293 return false; | |
| 294 | |
| 295 std::vector<char> buf; | |
| 296 buf.resize(1024); | |
| 297 while (true) { | |
| 298 int bytes_read = | |
| 299 source->ReadAtCurrentPos(&buf[0], static_cast<int>(buf.size())); | |
| 300 if (bytes_read == -1) | |
| 301 return false; | |
| 302 if (bytes_read == 0) | |
| 303 break; | |
| 304 | |
| 305 DWORD bytes_written = 0; | |
| 306 // Due to handle instrumentation, the destination can't be wrapped in | |
| 307 // a base::File, so we go basic Win32 API here. | |
| 308 if (!WriteFile(dest, &buf[0], bytes_read, &bytes_written, nullptr) || | |
| 309 static_cast<int>(bytes_written) != bytes_read) { | |
| 310 return false; | |
| 311 } | |
| 312 } | |
| 313 | |
| 314 return true; | |
| 315 } | |
| 316 | |
| 317 } // namespace | |
| 318 | |
| 319 FallbackCrashHandler::FallbackCrashHandler() | |
| 320 : thread_id_(base::kInvalidThreadId), exception_ptrs_(0UL) {} | |
| 321 | |
| 322 FallbackCrashHandler::~FallbackCrashHandler() {} | |
| 323 | |
| 324 bool FallbackCrashHandler::ParseCommandLine(const base::CommandLine& cmd_line) { | |
| 325 // Retrieve the handle to the process to dump. | |
| 326 unsigned int uint_process; | |
| 327 if (!base::StringToUint(cmd_line.GetSwitchValueASCII("process"), | |
| 328 &uint_process)) { | |
| 329 return false; | |
| 330 } | |
| 331 | |
| 332 // Before taking ownership of the supposed handle, see whether it's really | |
| 333 // a process handle. | |
| 334 base::ProcessHandle process_handle = base::win::Uint32ToHandle(uint_process); | |
| 335 if (base::GetProcId(process_handle) == base::kNullProcessId) | |
| 336 return false; | |
| 337 | |
| 338 // Retrieve the thread id argument. | |
| 339 unsigned thread_id = 0; | |
| 340 if (!base::StringToUint(cmd_line.GetSwitchValueASCII("thread"), &thread_id)) { | |
| 341 return false; | |
| 342 } | |
| 343 | |
| 344 // Retrieve the "exception-pointers" argument. | |
| 345 uint64_t uint_exc_ptrs = 0; | |
| 346 if (!base::StringToUint64(cmd_line.GetSwitchValueASCII("exception-pointers"), | |
| 347 &uint_exc_ptrs)) { | |
| 348 return false; | |
| 349 } | |
| 350 exception_ptrs_ = static_cast<uintptr_t>(uint_exc_ptrs); | |
| 351 | |
| 352 // Retrieve the "database" argument. | |
| 353 database_dir_ = cmd_line.GetSwitchValuePath("database"); | |
| 354 if (database_dir_.empty()) | |
| 355 return false; | |
| 356 | |
| 357 // Everything checks out, take ownership of the process handle. | |
| 358 process_ = base::Process(process_handle); | |
| 359 | |
| 360 return true; | |
| 361 } | |
| 362 | |
| 363 bool FallbackCrashHandler::GenerateCrashDump(const std::string& product, | |
| 364 const std::string& version, | |
| 365 const std::string& channel, | |
| 366 const std::string& process_type) { | |
| 367 std::unique_ptr<crashpad::CrashReportDatabase> database = | |
| 368 crashpad::CrashReportDatabase::InitializeWithoutCreating(database_dir_); | |
| 369 | |
| 370 if (!database) | |
| 371 return false; | |
| 372 | |
| 373 crashpad::CrashReportDatabase::NewReport* report = nullptr; | |
| 374 crashpad::CrashReportDatabase::OperationStatus status = | |
| 375 database->PrepareNewCrashReport(&report); | |
| 376 if (status != crashpad::CrashReportDatabase::kNoError) | |
| 377 return false; | |
| 378 | |
| 379 // Make sure we release the report on early exit. | |
| 380 crashpad::CrashReportDatabase::CallErrorWritingCrashReport on_error( | |
| 381 database.get(), report); | |
| 382 | |
| 383 // TODO(siggi): Go big on the detail here for Canary/Dev channels. | |
| 384 const uint32_t kMinidumpType = MiniDumpWithUnloadedModules | | |
| 385 MiniDumpWithProcessThreadData | | |
| 386 MiniDumpWithThreadInfo; | |
| 387 | |
| 388 MINIDUMP_EXCEPTION_INFORMATION exc_info = {}; | |
| 389 exc_info.ThreadId = thread_id_; | |
| 390 exc_info.ExceptionPointers = | |
| 391 reinterpret_cast<EXCEPTION_POINTERS*>(exception_ptrs_); | |
| 392 exc_info.ClientPointers = TRUE; // ExceptionPointers in client. | |
| 393 | |
| 394 // Mandatory crash keys. These will be read by Crashpad and used as | |
| 395 // http request parameters for the upload. Keys and values need to match | |
| 396 // server side configuration. | |
| 397 #if defined(ARCH_CPU_64_BITS) | |
| 398 const char* platform = "Win64"; | |
| 399 #else | |
| 400 const char* platform = "Win32"; | |
| 401 #endif | |
| 402 std::map<std::string, std::string> crash_keys = {{"prod", product}, | |
| 403 {"ver", version}, | |
| 404 {"channel", channel}, | |
| 405 {"plat", platform}, | |
| 406 {"ptype", process_type}}; | |
| 407 | |
| 408 crashpad::UUID client_id; | |
| 409 crashpad::Settings* settings = database->GetSettings(); | |
| 410 if (settings) { | |
| 411 // If GetSettings() or GetClientID() fails client_id will be left at its | |
| 412 // default value, all zeroes, which is appropriate. | |
| 413 settings->GetClientID(&client_id); | |
| 414 } | |
| 415 | |
| 416 base::FilePath dump_file_path; | |
| 417 if (!base::CreateTemporaryFile(&dump_file_path)) | |
| 418 return false; | |
| 419 | |
| 420 // Open the file with delete on close, to try and ensure it's cleaned up on | |
| 421 // any kind of failure. | |
| 422 base::File dump_file(dump_file_path, base::File::FLAG_OPEN | | |
| 423 base::File::FLAG_READ | | |
| 424 base::File::FLAG_WRITE | | |
| 425 base::File::FLAG_DELETE_ON_CLOSE); | |
| 426 if (!dump_file.IsValid()) | |
| 427 return false; | |
| 428 | |
| 429 // Write the minidump to the temp file, and then copy the data to the | |
| 430 // Crashpad-provided handle, as the latter is only open for write. | |
| 431 if (!MiniDumpWriteDumpWithCrashpadInfo(process_, kMinidumpType, &exc_info, | |
| 432 crash_keys, client_id, report->uuid, | |
| 433 &dump_file) || | |
| 434 !AppendFileContents(&dump_file, report->handle)) { | |
| 435 return false; | |
| 436 } | |
| 437 | |
| 438 on_error.Disarm(); | |
| 439 | |
| 440 crashpad::UUID report_id = {}; | |
| 441 status = database->FinishedWritingCrashReport(report, &report_id); | |
| 442 if (status != crashpad::CrashReportDatabase::kNoError) | |
| 443 return false; | |
| 444 | |
| 445 return true; | |
| 446 } | |
| 447 | |
| 448 } // namespace crash_reporter | |
| OLD | NEW |