mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-25 19:25:43 +00:00
76021a664b
This patch includes multiple changes cleaning up various aspects of the crash reporter client and exception handler: * Some Unix-specific code was moved out from the base crashreporter client code and into the appropriate platform implementation * Functions used to open files in the crashreporter client now accept C++ `std::ios` flags instead of unreadable booleans * Useless character conversion routines were removed from the minidump-analyzer * Crash annotations are not serialized into a huge string anymore every time they change. They are all written out individually during an exception. * `WriteEscapedMozCrashReason()` uses the exception-safe `my_strlen()` instead of plain `strlen()` * The Windows-specific DLL-blocklist shutdown was removed from the Linux & macOS Breakpad callbacks * The `CrashReporterHost`, `CrashReporterClient` and `CrashReporterMetadataShmem` classes now take `nsACString` references instead of `nsCString` ones since they never modify their contents Differential Revision: https://phabricator.services.mozilla.com/D33267 --HG-- extra : moz-landing-system : lando
122 lines
4.6 KiB
C++
122 lines
4.6 KiB
C++
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#ifndef mozilla_ipc_CrashReporterHost_h
|
|
#define mozilla_ipc_CrashReporterHost_h
|
|
|
|
#include <functional>
|
|
|
|
#include "mozilla/UniquePtr.h"
|
|
#include "mozilla/ipc/Shmem.h"
|
|
#include "base/process.h"
|
|
#include "nsExceptionHandler.h"
|
|
#include "nsThreadUtils.h"
|
|
|
|
namespace mozilla {
|
|
namespace ipc {
|
|
|
|
// This is the newer replacement for CrashReporterParent. It is created in
|
|
// response to a InitCrashReporter message on a top-level actor, and simply
|
|
// holds the metadata shmem alive until the process ends. When the process
|
|
// terminates abnormally, the top-level should call GenerateCrashReport to
|
|
// automatically integrate metadata.
|
|
class CrashReporterHost {
|
|
typedef mozilla::ipc::Shmem Shmem;
|
|
typedef CrashReporter::AnnotationTable AnnotationTable;
|
|
|
|
public:
|
|
CrashReporterHost(GeckoProcessType aProcessType, const Shmem& aShmem,
|
|
CrashReporter::ThreadId aThreadId);
|
|
|
|
// Helper function for generating a crash report for a process that probably
|
|
// crashed (i.e., had an AbnormalShutdown in ActorDestroy). Returns true if
|
|
// the process has a minidump attached and we were able to generate a report.
|
|
bool GenerateCrashReport(base::ProcessId aPid);
|
|
|
|
// Given an existing minidump for a crashed child process, take ownership of
|
|
// it from IPDL. After this, FinalizeCrashReport may be called.
|
|
RefPtr<nsIFile> TakeCrashedChildMinidump(base::ProcessId aPid,
|
|
uint32_t* aOutSequence);
|
|
|
|
// Replace the stored minidump with a new one. After this,
|
|
// FinalizeCrashReport may be called.
|
|
bool AdoptMinidump(nsIFile* aFile, const AnnotationTable& aAnnotations);
|
|
|
|
// If a minidump was already captured (e.g. via the hang reporter), this
|
|
// finalizes the existing report by attaching metadata, writing out the
|
|
// .extra file and notifying the crash service.
|
|
bool FinalizeCrashReport();
|
|
|
|
// Generate a paired minidump. This does not take the crash report, as
|
|
// GenerateCrashReport does. After this, FinalizeCrashReport may be called.
|
|
//
|
|
// This calls TakeCrashedChildMinidump and FinalizeCrashReport.
|
|
template <typename Toplevel>
|
|
bool GenerateMinidumpAndPair(Toplevel* aToplevelProtocol,
|
|
nsIFile* aMinidumpToPair,
|
|
const nsACString& aPairName) {
|
|
ScopedProcessHandle childHandle;
|
|
#ifdef XP_MACOSX
|
|
childHandle = aToplevelProtocol->Process()->GetChildTask();
|
|
#else
|
|
if (!base::OpenPrivilegedProcessHandle(aToplevelProtocol->OtherPid(),
|
|
&childHandle.rwget())) {
|
|
NS_WARNING("Failed to open child process handle.");
|
|
return false;
|
|
}
|
|
#endif
|
|
|
|
nsCOMPtr<nsIFile> targetDump;
|
|
if (!CrashReporter::CreateMinidumpsAndPair(
|
|
childHandle, mThreadId, aPairName, aMinidumpToPair,
|
|
mExtraAnnotations, getter_AddRefs(targetDump))) {
|
|
return false;
|
|
}
|
|
|
|
return CrashReporter::GetIDFromMinidump(targetDump, mDumpID);
|
|
}
|
|
|
|
void AddAnnotation(CrashReporter::Annotation aKey, bool aValue);
|
|
void AddAnnotation(CrashReporter::Annotation aKey, int aValue);
|
|
void AddAnnotation(CrashReporter::Annotation aKey, unsigned int aValue);
|
|
void AddAnnotation(CrashReporter::Annotation aKey, const nsACString& aValue);
|
|
|
|
bool HasMinidump() const { return !mDumpID.IsEmpty(); }
|
|
const nsString& MinidumpID() const {
|
|
MOZ_ASSERT(HasMinidump());
|
|
return mDumpID;
|
|
}
|
|
|
|
private:
|
|
static void AsyncAddCrash(int32_t aProcessType, int32_t aCrashType,
|
|
const nsString& aChildDumpID);
|
|
|
|
// Get the nsICrashService crash type to use for an impending crash.
|
|
int32_t GetCrashType();
|
|
|
|
// This is a static helper function to notify the crash service that a
|
|
// crash has occurred. This can be called from any thread, and if not
|
|
// called from the main thread, will post a synchronous message to the
|
|
// main thread.
|
|
static void NotifyCrashService(GeckoProcessType aProcessType,
|
|
int32_t aCrashType,
|
|
const nsString& aChildDumpID);
|
|
|
|
private:
|
|
GeckoProcessType mProcessType;
|
|
Shmem mShmem;
|
|
CrashReporter::ThreadId mThreadId;
|
|
time_t mStartTime;
|
|
AnnotationTable mExtraAnnotations;
|
|
nsString mDumpID;
|
|
bool mFinalized;
|
|
};
|
|
|
|
} // namespace ipc
|
|
} // namespace mozilla
|
|
|
|
#endif // mozilla_ipc_CrashReporterHost_h
|