| OLD | NEW |
| (Empty) | |
| 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
| 2 // |
| 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
| 4 // you may not use this file except in compliance with the License. |
| 5 // You may obtain a copy of the License at |
| 6 // |
| 7 // http://www.apache.org/licenses/LICENSE-2.0 |
| 8 // |
| 9 // Unless required by applicable law or agreed to in writing, software |
| 10 // distributed under the License is distributed on an "AS IS" BASIS, |
| 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 // See the License for the specific language governing permissions and |
| 13 // limitations under the License. |
| 14 |
| 15 #include <mach/mach_types.defs> |
| 16 #include <mach/std_types.defs> |
| 17 |
| 18 // child_port provides an interface for port rights to be transferred between |
| 19 // tasks. Its expected usage is for processes to be able to pass port rights |
| 20 // across IPC boundaries. A child process may wish to give its parent a copy of |
| 21 // of a send right to its own task port, or a parent process may wish to give a |
| 22 // receive right to a child process that implements a server. |
| 23 // |
| 24 // This Mach subsystem defines the lowest-level interface for these rights to |
| 25 // be transferred. Most users will not user this interface directly, but will |
| 26 // use ChildPortHandshake, which builds on this interface by providing client |
| 27 // and server implementations, along with a protocol for establishing |
| 28 // communication in a parent-child process relationship. |
| 29 subsystem child_port 10011; |
| 30 |
| 31 serverprefix handle_; |
| 32 |
| 33 type child_port_server_t = mach_port_t; |
| 34 type child_port_token_t = uint64_t; |
| 35 |
| 36 import "util/mach/child_port_types.h"; |
| 37 |
| 38 // Sends a Mach port right across an IPC boundary. |
| 39 // |
| 40 // server[in]: The server to send the port right to. |
| 41 // token[in]: A random opaque token, generated by the server and communicated to |
| 42 // the client through some secure means such as a shared pipe. The client |
| 43 // includes the token in its request to prove its authenticity to the |
| 44 // server. This parameter is necessary for instances where the server must |
| 45 // publish its service broadly, such as via the bootstrap server. When this |
| 46 // is done, anyone with access to the bootstrap server will be able to gain |
| 47 // rights to communicate with |server|, and |token| serves as a shared |
| 48 // secret allowing the server to verify that it has received a request from |
| 49 // the intended client. |server| will reject requests with an invalid |
| 50 // |token|. |
| 51 // port[in]: A port right to transfer to the server. |
| 52 // |
| 53 // Return value: As this is a “simpleroutine”, the server does not respond to |
| 54 // the client request, and the client does not block waiting for a response |
| 55 // after sending its request. The return value is MACH_MSG_SUCCESS if the |
| 56 // request was queued for the server, without any indication of whether the |
| 57 // server considered the request valid or took any action. On data |
| 58 // validation or mach_msg() failure, another code will be returned |
| 59 // indicating the nature of the error. |
| 60 simpleroutine child_port_check_in(server: child_port_server_t; |
| 61 token: child_port_token_t; |
| 62 port: mach_port_poly_t); |
| OLD | NEW |