mirror of
https://github.com/chromium/crashpad.git
synced 2025-01-17 12:58:16 +08:00
4145699874
Implemented the AddAttachment(), InitializeAttachments(), CleanDatabase() functions on Windows. Added attachment=FILE_NAME option to the handler, and "attachments" argument for Windows and Linux to StartHandler function. On crash it will create the corresponding attachments in the database and copy content of the specified files to the database. Bug: b/157144387 Change-Id: Ia238de39028e07112a7b971b5b7d5e71a5864f53 Reviewed-on: https://chromium-review.googlesource.com/c/crashpad/crashpad/+/2248099 Commit-Queue: Joshua Peraza <jperaza@chromium.org> Reviewed-by: Joshua Peraza <jperaza@chromium.org>
91 lines
3.8 KiB
C++
91 lines
3.8 KiB
C++
// Copyright 2015 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.
|
|
|
|
#ifndef CRASHPAD_HANDLER_WIN_CRASH_REPORT_EXCEPTION_HANDLER_H_
|
|
#define CRASHPAD_HANDLER_WIN_CRASH_REPORT_EXCEPTION_HANDLER_H_
|
|
|
|
#include <windows.h>
|
|
|
|
#include <map>
|
|
#include <string>
|
|
|
|
#include "base/macros.h"
|
|
#include "handler/user_stream_data_source.h"
|
|
#include "util/win/exception_handler_server.h"
|
|
|
|
namespace crashpad {
|
|
|
|
class CrashReportDatabase;
|
|
class CrashReportUploadThread;
|
|
|
|
//! \brief An exception handler that writes crash reports for exception messages
|
|
//! to a CrashReportDatabase.
|
|
class CrashReportExceptionHandler final
|
|
: public ExceptionHandlerServer::Delegate {
|
|
public:
|
|
//! \brief Creates a new object that will store crash reports in \a database.
|
|
//!
|
|
//! \param[in] database The database to store crash reports in. Weak.
|
|
//! \param[in] upload_thread The upload thread to notify when a new crash
|
|
//! report is written into \a database. Report upload is skipped if this
|
|
//! value is `nullptr`.
|
|
//! \param[in] process_annotations A map of annotations to insert as
|
|
//! process-level annotations into each crash report that is written. Do
|
|
//! not confuse this with module-level annotations, which are under the
|
|
//! control of the crashing process, and are used to implement Chrome's
|
|
//! "crash keys." Process-level annotations are those that are beyond the
|
|
//! control of the crashing process, which must reliably be set even if
|
|
//! the process crashes before it's able to establish its own annotations.
|
|
//! To interoperate with Breakpad servers, the recommended practice is to
|
|
//! specify values for the `"prod"` and `"ver"` keys as process
|
|
//! annotations.
|
|
//! \param[in] attachments A vector of file paths that should be captured with
|
|
//! each report at the time of the crash.
|
|
//! \param[in] user_stream_data_sources Data sources to be used to extend
|
|
//! crash reports. For each crash report that is written, the data sources
|
|
//! are called in turn. These data sources may contribute additional
|
|
//! minidump streams. `nullptr` if not required.
|
|
CrashReportExceptionHandler(
|
|
CrashReportDatabase* database,
|
|
CrashReportUploadThread* upload_thread,
|
|
const std::map<std::string, std::string>* process_annotations,
|
|
const std::vector<base::FilePath>* attachments,
|
|
const UserStreamDataSources* user_stream_data_sources);
|
|
|
|
~CrashReportExceptionHandler();
|
|
|
|
// ExceptionHandlerServer::Delegate:
|
|
|
|
//! \brief Processes an exception message by writing a crash report to this
|
|
//! object's CrashReportDatabase.
|
|
void ExceptionHandlerServerStarted() override;
|
|
unsigned int ExceptionHandlerServerException(
|
|
HANDLE process,
|
|
WinVMAddress exception_information_address,
|
|
WinVMAddress debug_critical_section_address) override;
|
|
|
|
private:
|
|
CrashReportDatabase* database_; // weak
|
|
CrashReportUploadThread* upload_thread_; // weak
|
|
const std::map<std::string, std::string>* process_annotations_; // weak
|
|
const std::vector<base::FilePath>* attachments_; // weak
|
|
const UserStreamDataSources* user_stream_data_sources_; // weak
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(CrashReportExceptionHandler);
|
|
};
|
|
|
|
} // namespace crashpad
|
|
|
|
#endif // CRASHPAD_HANDLER_WIN_CRASH_REPORT_EXCEPTION_HANDLER_H_
|