mirror of
https://github.com/chromium/crashpad.git
synced 2025-01-07 20:41:43 +08:00
71 lines
2.9 KiB
C
71 lines
2.9 KiB
C
|
// 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_TEST_MAC_MACH_ERRORS_H_
|
|||
|
|
#define CRASHPAD_UTIL_TEST_MAC_MACH_ERRORS_H_
|
|||
|
|
|
|||
|
|
#include <mach/mach.h>
|
|||
|
|
|
|||
|
|
#include <string>
|
|||
|
|
|
|||
|
|
namespace crashpad {
|
|||
|
|
namespace test {
|
|||
|
|
|
|||
|
|
// These functions format messages in a similar way to the logging macros in
|
|||
|
|
// base/mac/mach_logging.h. They exist to interoperate with gtest assertions,
|
|||
|
|
// which don’t interoperate with logging but can be streamed to.
|
|||
|
|
//
|
|||
|
|
// Where non-test code could do:
|
|||
|
|
// MACH_CHECK(kr == KERN_SUCCESS, kr) << "vm_deallocate";
|
|||
|
|
// gtest-based test code can do:
|
|||
|
|
// EXPECT_EQ(KERN_SUCCESS, kr) << MachErrorMessage(kr, "vm_deallocate");
|
|||
|
|
|
|||
|
|
//! \brief Formats a Mach error message.
|
|||
|
|
//!
|
|||
|
|
//! The returned string will combine the \a base string, if supplied, with a
|
|||
|
|
//! a textual and numeric description of the error.
|
|||
|
|
//!
|
|||
|
|
//! \param[in] mach_err The Mach error code, which may be a `kern_return_t` or
|
|||
|
|
//! related type.
|
|||
|
|
//! \param[in] base A string to prepend to the error description.
|
|||
|
|
//!
|
|||
|
|
//! \return A string of the format `"(os/kern) invalid address (1)"` if \a
|
|||
|
|
//! mach_err has the value `KERN_INVALID_ADDRESS` on a system where this is
|
|||
|
|
//! defined to be 1. If \a base is not empty, it will be prepended to this
|
|||
|
|
//! string, separated by a colon.
|
|||
|
|
std::string MachErrorMessage(mach_error_t mach_err,
|
|||
|
|
const std::string& base = std::string());
|
|||
|
|
|
|||
|
|
//! \brief Formats a bootstrap error message.
|
|||
|
|
//!
|
|||
|
|
//! The returned string will combine the \a base string, if supplied, with a
|
|||
|
|
//! a textual and numeric description of the error.
|
|||
|
|
//!
|
|||
|
|
//! \param[in] bootstrap_err The bootstrap error code.
|
|||
|
|
//! \param[in] base A string to prepend to the error description.
|
|||
|
|
//!
|
|||
|
|
//! \return A string of the format `"Permission denied (1100)"` if \a
|
|||
|
|
//! bootstrap_err has the value `BOOTSTRAP_NOT_PRIVILEGED` on a system where
|
|||
|
|
//! this is defined to be 1100. If \a base is not empty, it will be
|
|||
|
|
//! prepended to this string, separated by a colon. If \a bootstrap_err is
|
|||
|
|
//! not a valid bootstrap error code, it will be interpreted as a Mach error
|
|||
|
|
//! code in the manner of MachErrorMessage().
|
|||
|
|
std::string BootstrapErrorMessage(kern_return_t bootstrap_err,
|
|||
|
|
const std::string& base = std::string());
|
|||
|
|
|
|||
|
|
} // namespace test
|
|||
|
|
} // namespace crashpad
|
|||
|
|
|
|||
|
|
#endif // CRASHPAD_UTIL_TEST_MAC_MACH_ERRORS_H_
|