]> git.saurik.com Git - apple/xnu.git/blame_incremental - osfmk/ipc/ipc_right.h
projects / apple / xnu.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
xnu-6153.61.1.tar.gz
[apple/xnu.git] / osfmk / ipc / ipc_right.h
... / ...
CommitLineData
1/*
2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 *
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.
14 *
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
17 *
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.
25 *
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27 */
28/*
29 * @OSF_COPYRIGHT@
30 */
31/*
32 * Mach Operating System
33 * Copyright (c) 1991,1990,1989 Carnegie Mellon University
34 * All Rights Reserved.
35 *
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.
41 *
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.
45 *
46 * Carnegie Mellon requests users of this software to return to
47 *
48 * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
49 * School of Computer Science
50 * Carnegie Mellon University
51 * Pittsburgh PA 15213-3890
52 *
53 * any improvements or extensions that they make and grant Carnegie Mellon
54 * the rights to redistribute these changes.
55 */
56/*
57 */
58/*
59 * File: ipc/ipc_right.h
60 * Author: Rich Draves
61 * Date: 1989
62 *
63 * Declarations of functions to manipulate IPC capabilities.
64 */
65
66#ifndef _IPC_IPC_RIGHT_H_
67#define _IPC_IPC_RIGHT_H_
68
69#include <mach/boolean.h>
70#include <mach/kern_return.h>
71#include <ipc/ipc_port.h>
72#include <ipc/ipc_entry.h>
73
74#define ipc_right_lookup_read ipc_right_lookup_write
75#define ipc_right_lookup_two_read ipc_right_lookup_two_write
76
77typedef uint32_t ipc_right_copyin_flags_t;
78
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 */
83
84/* Find an entry in a space, given the name */
85extern kern_return_t ipc_right_lookup_write(
86 ipc_space_t space,
87 mach_port_name_t name,
88 ipc_entry_t *entryp);
89
90/* Find two entries in a space, given two names */
91extern kern_return_t ipc_right_lookup_two_write(
92 ipc_space_t space,
93 mach_port_name_t name1,
94 ipc_entry_t *entryp1,
95 mach_port_name_t name2,
96 ipc_entry_t *entryp2);
97
98/* Translate (space, object) -> (name, entry) */
99extern boolean_t ipc_right_reverse(
100 ipc_space_t space,
101 ipc_object_t object,
102 mach_port_name_t *namep,
103 ipc_entry_t *entryp);
104
105/* Make a notification request, returning the previous send-once right */
106extern kern_return_t ipc_right_request_alloc(
107 ipc_space_t space,
108 mach_port_name_t name,
109 boolean_t immediate,
110 boolean_t send_possible,
111 ipc_port_t notify,
112 ipc_port_t *previousp);
113
114/* Cancel a notification request and return the send-once right */
115extern ipc_port_t ipc_right_request_cancel(
116 ipc_space_t space,
117 ipc_port_t port,
118 mach_port_name_t name,
119 ipc_entry_t entry);
120
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)))
124
125/* Check if an entry is being used */
126extern boolean_t ipc_right_inuse(
127 ipc_space_t space,
128 mach_port_name_t name,
129 ipc_entry_t entry);
130
131/* Check if the port has died */
132extern boolean_t ipc_right_check(
133 ipc_space_t space,
134 ipc_port_t port,
135 mach_port_name_t name,
136 ipc_entry_t entry,
137 ipc_right_copyin_flags_t flags);
138
139/* Clean up an entry in a dead space */
140extern void ipc_right_terminate(
141 ipc_space_t space,
142 mach_port_name_t name,
143 ipc_entry_t entry);
144
145/* Destroy an entry in a space */
146extern kern_return_t ipc_right_destroy(
147 ipc_space_t space,
148 mach_port_name_t name,
149 ipc_entry_t entry,
150 boolean_t check_guard,
151 uint64_t guard);
152
153/* Release a send/send-once/dead-name user reference */
154extern kern_return_t ipc_right_dealloc(
155 ipc_space_t space,
156 mach_port_name_t name,
157 ipc_entry_t entry);
158
159/* Modify the user-reference count for a right */
160extern kern_return_t ipc_right_delta(
161 ipc_space_t space,
162 mach_port_name_t name,
163 ipc_entry_t entry,
164 mach_port_right_t right,
165 mach_port_delta_t delta);
166
167/* Destroy a receive right; Modify ref count for send rights */
168extern kern_return_t ipc_right_destruct(
169 ipc_space_t space,
170 mach_port_name_t name,
171 ipc_entry_t entry,
172 mach_port_delta_t srdelta,
173 uint64_t guard);
174
175/* Retrieve information about a right */
176extern kern_return_t ipc_right_info(
177 ipc_space_t space,
178 mach_port_name_t name,
179 ipc_entry_t entry,
180 mach_port_type_t *typep,
181 mach_port_urefs_t *urefsp);
182
183/* Check if a subsequent ipc_right_copyin of the reply port will succeed */
184extern boolean_t ipc_right_copyin_check_reply(
185 ipc_space_t space,
186 mach_port_name_t reply_name,
187 ipc_entry_t reply_entry,
188 mach_msg_type_name_t reply_type);
189
190/* Copyin a capability from a space */
191extern kern_return_t ipc_right_copyin(
192 ipc_space_t space,
193 mach_port_name_t name,
194 ipc_entry_t entry,
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,
200 int *assertcntp,
201 mach_port_context_t context,
202 mach_msg_guard_flags_t *guard_flags);
203
204/* Copyin a pair of dispositions from a space */
205extern kern_return_t ipc_right_copyin_two(
206 ipc_space_t space,
207 mach_port_name_t name,
208 ipc_entry_t entry,
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);
214
215/* Copyout a capability to a space */
216extern kern_return_t ipc_right_copyout(
217 ipc_space_t space,
218 mach_port_name_t name,
219 ipc_entry_t entry,
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);
224
225#endif /* _IPC_IPC_RIGHT_H_ */
mirror of XNU