mirror of
https://github.com/chromium/crashpad.git
synced 2025-03-10 06:36:02 +00:00
9b7ff0ea5a
disabled.
ClientInfo::set_system_crash_reporter_forwarding() can be used to
disable forwarding. The first module that is found with a non-default
value in this field will dictate whether forwarding is enabled or
disabled. It is possible to enable or disable reporting with this call,
as well as reset it to default, which will allow later modules a chance
to influence the behavior.
ClientInfo::set_crashpad_handler_behavior() is also provided, which can
be used to disable Crashpad’s handling of the exception. Most users
should not call this, but should use Settings::SetUploadsEnabled()
instead.
TEST=crashpad_snapshot_test \
CrashpadInfoClientOptions.*:MachOImageReader.Self_DyldImages; \
run_with_crashpad --handler crashpad_handler \
-a --database=/tmp/crashpad_db \
-a --url=https://clients2.google.com/cr/staging_report \
-a --annotation=prod=crashpad \
-a --annotation=ver=0.7.0 \
crashy_program
R=rsesek@chromium.org
Review URL: https://codereview.chromium.org/997713002
65 lines
2.7 KiB
C++
65 lines
2.7 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_SNAPSHOT_MAC_CRASHPAD_INFO_CLIENT_OPTIONS_H_
|
||
#define CRASHPAD_SNAPSHOT_MAC_CRASHPAD_INFO_CLIENT_OPTIONS_H_
|
||
|
||
#include "util/misc/tri_state.h"
|
||
|
||
namespace crashpad {
|
||
|
||
//! \brief Options represented in a client’s CrashpadInfo structure.
|
||
//!
|
||
//! The CrashpadInfo structure is not suitable to expose client options
|
||
//! in a generic way at the snapshot level. This structure duplicates
|
||
//! option-related fields from the client structure for general use within the
|
||
//! snapshot layer and by users of this layer.
|
||
//!
|
||
//! For objects of this type corresponding to a module, option values are taken
|
||
//! from the module’s CrashpadInfo structure directly. If the module has no such
|
||
//! such structure, option values appear unset.
|
||
//!
|
||
//! For objects of this type corresponding to an entire process, option values
|
||
//! are taken from the CrashpadInfo structures of modules within the process.
|
||
//! The first module found with a set value (enabled or disabled) will provide
|
||
//! an option value for the process. Different modules may provide values for
|
||
//! different options. If no module in the process sets a value for an option,
|
||
//! the option will appear unset for the process. If no module in the process
|
||
//! has a CrashpadInfo structure, all option values will appear unset.
|
||
struct CrashpadInfoClientOptions {
|
||
public:
|
||
//! \brief Converts `uint8_t` value to a TriState value.
|
||
//!
|
||
//! The process_types layer exposes TriState as a `uint8_t` rather than an
|
||
//! enum type. This function converts these values into the equivalent enum
|
||
//! values used in the snapshot layer.
|
||
//!
|
||
//! \return The TriState equivalent of \a crashpad_info_tri_state, if it is a
|
||
//! valid TriState value. Otherwise, logs a warning and returns
|
||
//! TriState::kUnset.
|
||
static TriState TriStateFromCrashpadInfo(uint8_t crashpad_info_tri_state);
|
||
|
||
CrashpadInfoClientOptions();
|
||
|
||
//! \sa CrashpadInfo::set_crashpad_handler_behavior()
|
||
TriState crashpad_handler_behavior;
|
||
|
||
//! \sa CrashpadInfo::set_system_crash_reporter_forwarding()
|
||
TriState system_crash_reporter_forwarding;
|
||
};
|
||
|
||
} // namespace crashpad
|
||
|
||
#endif // CRASHPAD_SNAPSHOT_MAC_CRASHPAD_INFO_CLIENT_OPTIONS_H_
|