mirror of
https://github.com/chromium/crashpad.git
synced 2025-03-10 06:36:02 +00:00
1aa478d161
This change was partially scripted and partially done manually with vim regex + manually placing the deleted constructors. The script change looked for destructors in the public: section of a class, if that existed the deleted constructors would go before the destructor. For manual placement I looked for any constructor in the public: section of the corresponding class. If there wasn't one, then it would ideally have gone as the first entry except below enums, classes and typedefs. This may not have been perfect, but is hopefully good enough. Fingers crossed. #include "base/macros.h" is removed from files that don't use ignore_result, which is the only other thing defined in base/macros.h. Bug: chromium:1010217 Change-Id: I099526255a40b1ac1264904b4ece2f3f503c9418 Reviewed-on: https://chromium-review.googlesource.com/c/crashpad/crashpad/+/3171034 Reviewed-by: Mark Mentovai <mark@chromium.org> Commit-Queue: Peter Boström <pbos@chromium.org>
88 lines
3.7 KiB
C++
88 lines
3.7 KiB
C++
// Copyright 2017 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_TEST_MAC_EXCEPTION_SWALLOWER_H_
|
||
#define CRASHPAD_TEST_MAC_EXCEPTION_SWALLOWER_H_
|
||
|
||
#include <memory>
|
||
|
||
|
||
namespace crashpad {
|
||
namespace test {
|
||
|
||
//! \brief Swallows `EXC_CRASH` and `EXC_CORPSE_NOTIFY` exceptions in test child
|
||
//! processes.
|
||
//!
|
||
//! This class is intended to be used by test code that crashes intentionally.
|
||
//!
|
||
//! On macOS, the system’s crash reporter normally saves crash reports for all
|
||
//! crashes in test code, by virtue of being set as the `EXC_CRASH` or
|
||
//! `EXC_CORPSE_NOTIFY` handler. This litters the user’s
|
||
//! `~/Library/Logs/DiagnosticReports` directory and can be time-consuming.
|
||
//! Reports generated for code that crashes intentionally have no value, and
|
||
//! many Crashpad tests do crash intentionally.
|
||
//!
|
||
//! Instantiate an ExceptionSwallower object in a parent test process (a process
|
||
//! where `TEST()`, `TEST_F()`, and `TEST_P()` execute) to create an exception
|
||
//! swallower server running on a dedicated thread. A service mapping for this
|
||
//! server will be published with the bootstrap server and made available in the
|
||
//! `CRASHPAD_EXCEPTION_SWALLOWER_SERVICE` environment variable. In a child
|
||
//! process, call SwallowExceptions() to look up this service and set it as the
|
||
//! `EXC_CRASH` and `EXC_CORPSE_NOTIFY` handler. When these exceptions are
|
||
//! raised in the child process, they’ll be handled by the exception swallower
|
||
//! server, which performs no action but reports that exceptions were
|
||
//! successfully handled so that the system’s crash reporter, ReportCrash, will
|
||
//! not be invoked.
|
||
//!
|
||
//! At most one ExceptionSwallower may be instantiated in a process at a time.
|
||
//! If `CRASHPAD_EXCEPTION_SWALLOWER_SERVICE` is already set, ExceptionSwallower
|
||
//! leaves it in place and takes no additional action.
|
||
//!
|
||
//! Crashpad’s ASSERT_DEATH_CRASH(), EXPECT_DEATH_CRASH(), ASSERT_DEATH_CHECK(),
|
||
//! and EXPECT_DEATH_CHECK() macros make use of this class on macOS, as does the
|
||
//! Multiprocess test interface.
|
||
class ExceptionSwallower {
|
||
public:
|
||
ExceptionSwallower();
|
||
|
||
ExceptionSwallower(const ExceptionSwallower&) = delete;
|
||
ExceptionSwallower& operator=(const ExceptionSwallower&) = delete;
|
||
|
||
~ExceptionSwallower();
|
||
|
||
//! \brief In a test child process, arranges to swallow `EXC_CRASH` and
|
||
//! `EXC_CORPSE_NOTIFY` exceptions.
|
||
//!
|
||
//! This must be called in a test child process. It must not be called from a
|
||
//! parent test process directly. Parent test processes are those that execute
|
||
//! `TEST()`, `TEST_F()`, and `TEST_P()`. Test child processes execute
|
||
//! ASSERT_DEATH_CRASH(), EXPECT_DEATH_CRASH(), ASSERT_DEATH_CHECK(),
|
||
//! EXPECT_DEATH_CHECK(), and Multiprocess::RunChild().
|
||
//!
|
||
//! It is an error to call this in a test child process without having first
|
||
//! instantiated an ExceptionSwallower object in a parent test project. It is
|
||
//! also an error to call this in a parent test process.
|
||
static void SwallowExceptions();
|
||
|
||
private:
|
||
class ExceptionSwallowerThread;
|
||
|
||
std::unique_ptr<ExceptionSwallowerThread> exception_swallower_thread_;
|
||
};
|
||
|
||
} // namespace test
|
||
} // namespace crashpad
|
||
|
||
#endif // CRASHPAD_TEST_MAC_EXCEPTION_SWALLOWER_H_
|