Index: util/mach/mach_message_util.h |
diff --git a/util/mach/mach_message_util.h b/util/mach/mach_message_util.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..afe598188d6a998f86d0c5fd64696c1097fc8d8c |
--- /dev/null |
+++ b/util/mach/mach_message_util.h |
@@ -0,0 +1,53 @@ |
+// 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_MESSAGE_UTIL_H_ |
+#define CRASHPAD_UTIL_MACH_MACH_MESSAGE_UTIL_H_ |
+ |
+#include <mach/mach.h> |
+ |
+namespace crashpad { |
+ |
+//! \brief Initializes a reply message for a MIG server routine based on its |
+//! corresponding request. |
+//! |
+//! If a request is handled by a server routine, it may be necessary to revise |
+//! some of the fields set by this function, such as `msgh_size` and any fields |
+//! defined in a routine’s reply structure type. |
+//! |
+//! \param[in] in_header The request message to base the reply on. |
+//! \param[out] out_header The reply message to initialize. \a out_header will |
+//! be treated as a `mig_reply_error_t*` and all of its fields will be set |
+//! except for `RetCode`, which must be set by SetMIGReplyError(). This |
+//! argument is accepted as a `mach_msg_header_t*` instead of a |
+//! `mig_reply_error_t*` because that is the type that callers are expected |
+//! to possess in the C API. |
+void PrepareMIGReplyFromRequest(const mach_msg_header_t* in_header, |
+ mach_msg_header_t* out_header); |
+ |
+//! \brief Sets the error code in a reply message for a MIG server routine. |
+//! |
+//! \param[inout] out_header The reply message to operate on. \a out_header will |
+//! be treated as a `mig_reply_error_t*` and its `RetCode` field will be |
+//! set. This argument is accepted as a `mach_msg_header_t*` instead of a |
+//! `mig_reply_error_t*` because that is the type that callers are expected |
+//! to possess in the C API. |
+//! \param[in] error The error code to store in \a out_header. |
+//! |
+//! \sa PrepareMIGReplyFromRequest() |
+void SetMIGReplyError(mach_msg_header_t* out_header, kern_return_t error); |
+ |
+} // namespace crashpad |
+ |
+#endif // CRASHPAD_UTIL_MACH_MACH_MESSAGE_UTIL_H_ |