Add and use scoped-right-returning wrappers for Mach bootstrap routines

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 <string>
+
 #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
@@ skipping 80 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 Makes a `boostrap_check_in()` call to the process’ bootstrap server.
+//!
+//! This function is provided to make it easier to call `bootstrap_check_in()`
+//! while avoiding accidental leaks of the returned receive right.
+//!
+//! \param[in] service_name The service name to check in.
+//!
+//! \return On success, a receive right to the service port. On failure,
+//!     `MACH_PORT_NULL` with a message logged.
+base::mac::ScopedMachReceiveRight BootstrapCheckIn(
+    const std::string& service_name);
+
+//! \brief Makes a `boostrap_look_up()` call to the process’ bootstrap server.
+//!
+//! This function is provided to make it easier to call `bootstrap_look_up()`
+//! while avoiding accidental leaks of the returned send right.
+//!
+//! \param[in] service_name The service name to look up.
+//!
+//! \return On success, a send right to the service port. On failure,
+//!     `MACH_PORT_NULL` with a message logged.
+base::mac::ScopedMachSendRight BootstrapLookUp(const std::string& service_name);
+
 //! \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_