Update Crashpad to 32981a3ee9d7c2769fb27afa038fe2e194cfa329

third_party/crashpad/crashpad/util/mach/child_port_handshake.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 200 matching lines @@
   //!    interpret and validate it, and if the message is valid, returns the
   //!    port right extracted from the message. If the message is not valid,
   //!    this method will continue waiting for a valid message. Valid messages
   //!    are properly formatted and have the correct token. The right carried in
   //!    a valid message will be returned. If a message is not valid, this
   //!    method will continue waiting for pipe EOF or a valid message.
   //!  - When notified of pipe EOF, returns `MACH_PORT_NULL`.
   //!  - Regardless of return value, destroys the server’s receive right and
   //!    closes the pipe.
   //!
+  //! \param[in] server_write_fd The write side of the pipe shared with the
+  //!     client process. This function takes ownership of this file descriptor,
+  //!     and will close it prior to returning.
   //! \param[in] port_right_type The port right type expected to be received
   //!     from the client. If the port right received from the client does not
   //!     match the expected type, the received port right will be destroyed,
   //!     and `MACH_PORT_NULL` will be returned.
   //!
   //! \return On success, the port right provided by the client. The caller
   //!     takes ownership of this right. On failure, `MACH_PORT_NULL`,
   //!     indicating that the client did not check in properly before
   //!     terminating, where termination is detected by detecting that the read
   //!     side of the shared pipe has closed. On failure, a message indicating
@@ skipping 15 matching lines @@
   //!  - Obtains a send right to the server by calling `bootstrap_look_up()`.
   //!  - Sends a check-in message to the server by calling
   //!    `child_port_check_in()`, providing the token and the user-supplied port
   //!    right.
   //!  - Deallocates the send right to the server, and closes the pipe.
   //!
   //! There is no return value because `child_port_check_in()` is a MIG
   //! `simpleroutine`, and the server does not send a reply. This allows
   //! check-in to occur without blocking to wait for a reply.
   //!
-  //! \param[in] pipe_read The “read” side of the pipe shared with the server
-  //!     process. This function takes ownership of this file descriptor, and
-  //!     will close it prior to returning.
+  //! \param[in] client_read_fd The “read” side of the pipe shared with the
+  //!     server process. This function takes ownership of this file descriptor,
+  //!     and will close it prior to returning.
   //! \param[in] port The port right that will be passed to the server by
   //!     `child_port_check_in()`.
   //! \param[in] right_type The right type to furnish the server with. If \a
   //!     port is a send right, this can be `MACH_MSG_TYPE_COPY_SEND` or
   //!     `MACH_MSG_TYPE_MOVE_SEND`. If \a port is a send-once right, this can
   //!     be `MACH_MSG_TYPE_MOVE_SEND_ONCE`. If \a port is a receive right, this
   //!     can be `MACH_MSG_TYPE_MAKE_SEND`, `MACH_MSG_TYPE_MAKE_SEND_ONCE`, or
   //!     `MACH_MSG_TYPE_MOVE_RECEIVE`.
   //!
   //! \return `true` on success, `false` on failure with a message logged. On
@@ skipping 49 matching lines @@
   base::ScopedFD server_write_fd_;
 
   friend class test::ChildPortHandshakeTest;
 
   DISALLOW_COPY_AND_ASSIGN(ChildPortHandshake);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_UTIL_MACH_CHILD_PORT_HANDSHAKE_H_