Add ChildPortServer, a MachMessageServer::Interface implementation for the child_port subsystem

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 82 matching lines @@
         const natural_t* old_state,
         mach_msg_type_number_t old_state_count,
         thread_state_t new_state,
         mach_msg_type_number_t* new_state_count,
         bool* destroy_request) = 0;
 
    protected:
     ~Interface() {}
   };
 
+  //! \brief Constructs an object of this class.
+  //!
+  //! \param[in] interface The interface to dispatch requests to. Weak.
   explicit ExcServer(Interface* interface);
 
   // MachMessageServer::Interface:
 
   bool MachMessageServerFunction(const mach_msg_header_t* in_header,
                                  mach_msg_header_t* out_header,
                                  bool* destroy_complex_request) override;
 
   mach_msg_size_t MachMessageServerRequestSize() override;
   mach_msg_size_t MachMessageServerReplySize() override;
@@ skipping 69 matching lines @@
         const natural_t* old_state,
         mach_msg_type_number_t old_state_count,
         thread_state_t new_state,
         mach_msg_type_number_t* new_state_count,
         bool* destroy_request) = 0;
 
    protected:
     ~Interface() {}
   };
 
+  //! \brief Constructs an object of this class.
+  //!
+  //! \param[in] interface The interface to dispatch requests to. Weak.
   explicit MachExcServer(Interface* interface);
 
   // MachMessageServer::Interface:
 
   bool MachMessageServerFunction(const mach_msg_header_t* in_header,
                                  mach_msg_header_t* out_header,
                                  bool* destroy_complex_request) override;
 
   mach_msg_size_t MachMessageServerRequestSize() override;
   mach_msg_size_t MachMessageServerReplySize() override;
@@ skipping 39 matching lines @@
         const natural_t* old_state,
         mach_msg_type_number_t old_state_count,
         thread_state_t new_state,
         mach_msg_type_number_t* new_state_count,
         bool* destroy_complex_request) = 0;
 
    protected:
     ~Interface() {}
   };
 
+  //! \brief Constructs an object of this class.
+  //!
+  //! \param[in] interface The interface to dispatch requests to. Weak.
   explicit SimplifiedExcServer(Interface* interface);
 
   // ExcServer::Interface:
 
   kern_return_t CatchExceptionRaise(exception_handler_t exception_port,
                                     thread_t thread,
                                     task_t task,
                                     exception_type_t exception,
                                     const exception_data_type_t* code,
                                     mach_msg_type_number_t code_count,
@@ skipping 73 matching lines @@
         const natural_t* old_state,
         mach_msg_type_number_t old_state_count,
         thread_state_t new_state,
         mach_msg_type_number_t* new_state_count,
         bool* destroy_complex_request) = 0;
 
    protected:
     ~Interface() {}
   };
 
+  //! \brief Constructs an object of this class.
+  //!
+  //! \param[in] interface The interface to dispatch requests to. Weak.
   explicit SimplifiedMachExcServer(Interface* interface);
 
   // MachExcServer::Interface:
 
   kern_return_t CatchMachExceptionRaise(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,
@@ skipping 41 matching lines @@
 //! field, from `exception_data_type_t` to `mach_exception_data_type_t`.
 //! This is achieved by implementing SimplifiedExcServer::Interface and having
 //! it forward translated messages to SimplifiedMachExcServer::Interface, which
 //! is left unimplemented here so that users of this class can provide their own
 //! implementations.
 class UniversalMachExcServer
     : public MachMessageServer::Interface,
       public internal::SimplifiedExcServer::Interface,
       public internal::SimplifiedMachExcServer::Interface {
  public:
+  //! \brief Constructs an object of this class.
   UniversalMachExcServer();
 
   // MachMessageServer::Interface:
 
   bool MachMessageServerFunction(const mach_msg_header_t* in_header,
                                  mach_msg_header_t* out_header,
                                  bool* destroy_complex_request) override;
 
   mach_msg_size_t MachMessageServerRequestSize() override;
   mach_msg_size_t MachMessageServerReplySize() override;
@@ skipping 101 matching lines @@
 //!     \a behavior is not a state-carrying behavior, or when it is a
 //!     state-carrying behavior and \a set_thread_state is `true`.
 //!     `MACH_RCV_PORT_DIED` is used when \a behavior is a state-carrying
 //!     behavior and \a set_thread_state is `false`.
 kern_return_t ExcServerSuccessfulReturnValue(exception_behavior_t behavior,
                                              bool set_thread_state);
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_UTIL_MACH_EXC_SERVER_VARIANTS_H_