15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2006-2009 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Support for collecting useful information when crashing. 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef BASE_CRASH_H_ 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define BASE_CRASH_H_ 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base { 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct CrashReason { 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CrashReason() : filename(0), line_number(0), message(0), depth(0) {} 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* filename; 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int line_number; 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* message; 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We'll also store a bit of stack trace context at the time of crash as 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // it may not be available later on. 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void* stack[32]; 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int depth; 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We'll try to store some trace information if it's available - this should 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // reflect information from TraceContext::Thread()->tracer()->ToString(). 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This field should probably not be set from within a signal handler or 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // low-level code unless absolutely safe to do so. 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char trace_info[512]; 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Stores "reason" as an explanation for why the process is about to 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// crash. The reason and its contents must remain live for the life 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// of the process. Only the first reason is kept. 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void SetCrashReason(const CrashReason* reason); 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns first reason passed to SetCrashReason(), or NULL. 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const CrashReason* GetCrashReason(); 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace base 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // BASE_CRASH_H_ 42