2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
32 * Mach Operating System
33 * Copyright (c) 1991,1990,1989 Carnegie Mellon University
34 * All Rights Reserved.
36 * Permission to use, copy, modify and distribute this software and its
37 * documentation is hereby granted, provided that both the copyright
38 * notice and this permission notice appear in all copies of the
39 * software, derivative works or modified versions, and any portions
40 * thereof, and that both notices appear in supporting documentation.
42 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
43 * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
44 * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
46 * Carnegie Mellon requests users of this software to return to
48 * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
49 * School of Computer Science
50 * Carnegie Mellon University
51 * Pittsburgh PA 15213-3890
53 * any improvements or extensions that they make and grant Carnegie Mellon
54 * the rights to redistribute these changes.
59 * File: ipc/ipc_right.h
63 * Declarations of functions to manipulate IPC capabilities.
66 #ifndef _IPC_IPC_RIGHT_H_
67 #define _IPC_IPC_RIGHT_H_
69 #include <mach/boolean.h>
70 #include <mach/kern_return.h>
71 #include <ipc/ipc_port.h>
72 #include <ipc/ipc_entry.h>
74 #define ipc_right_lookup_read ipc_right_lookup_write
75 #define ipc_right_lookup_two_read ipc_right_lookup_two_write
77 typedef uint32_t ipc_right_copyin_flags_t
;
79 #define IPC_RIGHT_COPYIN_FLAGS_NONE 0x0
80 #define IPC_RIGHT_COPYIN_FLAGS_DEADOK 0x1
81 #define IPC_RIGHT_COPYIN_FLAGS_ALLOW_IMMOVABLE_SEND 0x2
82 #define IPC_RIGHT_COPYIN_FLAGS_ALLOW_DEAD_SEND_ONCE 0x4 /* allow copyin of a send once right to a dead port with no dead name requests */
84 /* Find an entry in a space, given the name */
85 extern kern_return_t
ipc_right_lookup_write(
87 mach_port_name_t name
,
90 /* Find two entries in a space, given two names */
91 extern kern_return_t
ipc_right_lookup_two_write(
93 mach_port_name_t name1
,
95 mach_port_name_t name2
,
96 ipc_entry_t
*entryp2
);
98 /* Translate (space, object) -> (name, entry) */
99 extern boolean_t
ipc_right_reverse(
102 mach_port_name_t
*namep
,
103 ipc_entry_t
*entryp
);
105 /* Make a notification request, returning the previous send-once right */
106 extern kern_return_t
ipc_right_request_alloc(
108 mach_port_name_t name
,
110 boolean_t send_possible
,
112 ipc_port_t
*previousp
);
114 /* Cancel a notification request and return the send-once right */
115 extern ipc_port_t
ipc_right_request_cancel(
118 mach_port_name_t name
,
121 #define ipc_right_request_cancel_macro(space, port, name, entry) \
122 ((entry->ie_request == IE_REQ_NONE) ? IP_NULL : \
123 ipc_right_request_cancel((space), (port), (name), (entry)))
125 /* Check if an entry is being used */
126 extern boolean_t
ipc_right_inuse(
128 mach_port_name_t name
,
131 /* Check if the port has died */
132 extern boolean_t
ipc_right_check(
135 mach_port_name_t name
,
137 ipc_right_copyin_flags_t flags
);
139 /* Clean up an entry in a dead space */
140 extern void ipc_right_terminate(
142 mach_port_name_t name
,
145 /* Destroy an entry in a space */
146 extern kern_return_t
ipc_right_destroy(
148 mach_port_name_t name
,
150 boolean_t check_guard
,
153 /* Release a send/send-once/dead-name user reference */
154 extern kern_return_t
ipc_right_dealloc(
156 mach_port_name_t name
,
159 /* Modify the user-reference count for a right */
160 extern kern_return_t
ipc_right_delta(
162 mach_port_name_t name
,
164 mach_port_right_t right
,
165 mach_port_delta_t delta
);
167 /* Destroy a receive right; Modify ref count for send rights */
168 extern kern_return_t
ipc_right_destruct(
170 mach_port_name_t name
,
172 mach_port_delta_t srdelta
,
175 /* Retrieve information about a right */
176 extern kern_return_t
ipc_right_info(
178 mach_port_name_t name
,
180 mach_port_type_t
*typep
,
181 mach_port_urefs_t
*urefsp
);
183 /* Check if a subsequent ipc_right_copyin of the reply port will succeed */
184 extern boolean_t
ipc_right_copyin_check_reply(
186 mach_port_name_t reply_name
,
187 ipc_entry_t reply_entry
,
188 mach_msg_type_name_t reply_type
);
190 /* Copyin a capability from a space */
191 extern kern_return_t
ipc_right_copyin(
193 mach_port_name_t name
,
195 mach_msg_type_name_t msgt_name
,
196 ipc_right_copyin_flags_t flags
,
197 ipc_object_t
*objectp
,
198 ipc_port_t
*sorightp
,
199 ipc_port_t
*releasep
,
201 mach_port_context_t context
,
202 mach_msg_guard_flags_t
*guard_flags
);
204 /* Copyin a pair of dispositions from a space */
205 extern kern_return_t
ipc_right_copyin_two(
207 mach_port_name_t name
,
209 mach_msg_type_name_t msgt_one
,
210 mach_msg_type_name_t msgt_two
,
211 ipc_object_t
*objectp
,
212 ipc_port_t
*sorightp
,
213 ipc_port_t
*releasep
);
215 /* Copyout a capability to a space */
216 extern kern_return_t
ipc_right_copyout(
218 mach_port_name_t name
,
220 mach_msg_type_name_t msgt_name
,
221 mach_port_context_t
*context
,
222 mach_msg_guard_flags_t
*guard_flags
,
223 ipc_object_t object
);
225 #endif /* _IPC_IPC_RIGHT_H_ */