Update Crashpad to 32981a3ee9d7c2769fb27afa038fe2e194cfa329

third_party/crashpad/crashpad/util/mach/exc_server_variants.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,
@@ skipping 46 matching lines @@
     //!
     //! For convenience in implementation, these different “behaviors” of
     //! exception messages are all mapped to a single interface method. The
     //! exception’s original “behavior” is specified in the \a behavior
     //! parameter. Only parameters that were supplied in the request message
     //! are populated, other parameters are set to reasonable default values.
     //!
     //! This behaves equivalently to a `catch_exception_raise_state_identity()`
     //! function used with `exc_server()`, or a
     //! `catch_mach_exception_raise_state_identity()` function used with
-    //! `mach_exc_server()`. The meanings of most parameters are identical to
-    //! their meanings to these functions.
+    //! `mach_exc_server()`. Except as noted, the parameters and return value
+    //! are equivalent to those of these other functions.
     //!
     //! \param[in] behavior `EXCEPTION_DEFAULT`, `EXCEPTION_STATE`,
     //!     or `EXCEPTION_STATE_IDENTITY`, possibly with `MACH_EXCEPTION_CODES`
     //!     ORed in. This identifies which exception request message was
     //!     processed and thus which other parameters are valid.
+    //! \param[in] exception_port
+    //! \param[in] thread
+    //! \param[in] task
+    //! \param[in] exception
+    //! \param[in] code
+    //! \param[in] code_count
+    //! \param[in,out] flavor
+    //! \param[in] old_state
+    //! \param[in] old_state_count
+    //! \param[out] new_state
+    //! \param[out] new_state_count
     //! \param[in] trailer The trailer received with the request message.
-    //! \param[out] destroy_request `true` if the request message is to be
-    //!     destroyed even when this method returns success. See
+    //! \param[out] destroy_complex_request `true` if the request message is to
+    //!     be destroyed even when this method returns success. See
     //!     MachMessageServer::Interface.
+    //!
+    //! \return A code indicating whether the exception was handled. See
+    //!     ExcServerSuccessfulReturnValue() for success codes. On failure,
+    //!     a code such as `KERN_FAILURE`.
     virtual kern_return_t CatchMachException(
         exception_behavior_t behavior,
         exception_handler_t exception_port,
         thread_t thread,
         task_t task,
         exception_type_t exception,
         const mach_exception_data_type_t* code,
         mach_msg_type_number_t code_count,
         thread_state_flavor_t* flavor,
         ConstThreadState old_state,
@@ skipping 106 matching lines @@
 //!     from the \a old_state parameter of
 //!     internal::SimplifiedExcServer::Interface::CatchException(), for example.
 //! \param[in] old_state_count The number of significant `natural_t` words in \a
 //!     old_state. This may be taken directly from the \a old_state_count
 //!     parameter of internal::SimplifiedExcServer::Interface::CatchException(),
 //!     for example.
 //! \param[out] new_state The state value to be set. This may be taken directly
 //!     from the \a new_state parameter of
 //!     internal::SimplifiedExcServer::Interface::CatchException(), for example.
 //!     This parameter is untouched if \a behavior is not state-carrying.
-//! \param[inout] new_state_count On entry, the number of `natural_t` words
+//! \param[in,out] new_state_count On entry, the number of `natural_t` words
 //!     available to be written to in \a new_state. On return, the number of
 //!     significant `natural_t` words in \a new_state. This may be taken
 //!     directly from the \a new_state_count parameter of
 //!     internal::SimplifiedExcServer::Interface::CatchException(), for example.
 //!     This parameter is untouched if \a behavior is not state-carrying. If \a
 //!     \a behavior is state-carrying, this parameter should be at least as
 //!     large as \a old_state_count.
 void ExcServerCopyState(exception_behavior_t behavior,
                         ConstThreadState old_state,
                         mach_msg_type_number_t old_state_count,
                         thread_state_t new_state,
                         mach_msg_type_number_t* new_state_count);
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_UTIL_MACH_EXC_SERVER_VARIANTS_H_