mac: Add CrashpadClient::UseSystemDefaultHandler()

util/mach/mach_extensions.h

 // Copyright 2014 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_UTIL_MACH_MACH_EXTENSIONS_H_
 #define CRASHPAD_UTIL_MACH_MACH_EXTENSIONS_H_
 
 #include <mach/mach.h>
 
+#include "base/mac/scoped_mach_port.h"
+
 namespace crashpad {
 
 //! \brief `MACH_PORT_NULL` with the correct type for a Mach port,
 //!     `mach_port_t`.
 //!
 //! For situations where implicit conversions between signed and unsigned types
 //! are not performed, use kMachPortNull instead of an explicit `implicit_cast`
 //! of `MACH_PORT_NULL` to `mach_port_t`. This is useful for logging and testing
 //! assertions.
 const mach_port_t kMachPortNull = MACH_PORT_NULL;
@@ skipping 78 matching lines @@
 //! `EXC_MASK_ALL`, and thus ExcMaskAll(), never includes the value of
 //! `EXC_MASK_CRASH` or `EXC_MASK_CORPSE_NOTIFY`. For situations where an
 //! exception mask corresponding to every possible exception understood by the
 //! running kernel is desired, use this function instead.
 //!
 //! Should new exception types be introduced in the future, this function will
 //! be updated to include their bits in the returned mask value when run time
 //! support is present.
 exception_mask_t ExcMaskValid();
 
+//! \brief Obtains the system’s default Mach exception handler for crash-type
+//!     exceptions.
+//!
+//! This is obtained by looking up `"com.apple.ReportCrash"` with the bootstrap
+//! server. The service name comes from the first launch agent loaded by
+//! `launchd` with a `MachServices` entry having `ExceptionServer` set. This
+//! launch agent is normally loaded from
+//! `/System/Library/LaunchAgents/com.apple.ReportCrash.plist`.
+//!
+//! \return On success, a send right to an `exception_handler_t` corresponding
+//!     to the system’s default crash reporter. On failure, `MACH_PORT_NULL`,
+//!     with a message logged.
+base::mac::ScopedMachSendRight SystemCrashReporterHandler();
+
 }  // namespace crashpad
 
 #endif  // CRASHPAD_UTIL_MACH_MACH_EXTENSIONS_H_