2 * Copyright (c) 2000-2012 Apple 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.
57 * NOTICE: This file was modified by McAfee Research in 2004 to introduce
58 * support for mandatory and extensible security protections. This notice
59 * is included in support of clause 2.2 (b) of the Apple Public License,
61 * Copyright (c) 2005 SPARTA, Inc.
66 * File: ipc/ipc_init.c
70 * Functions to initialize the IPC system.
73 #include <mach_debug.h>
76 #include <mach/port.h>
77 #include <mach/message.h>
78 #include <mach/kern_return.h>
80 #include <kern/kern_types.h>
81 #include <kern/kalloc.h>
82 #include <kern/simple_lock.h>
83 #include <kern/mach_param.h>
84 #include <kern/ipc_host.h>
85 #include <kern/ipc_mig.h>
86 #include <kern/host_notify.h>
87 #include <kern/mk_timer.h>
88 #include <kern/misc_protos.h>
89 #include <kern/sync_lock.h>
90 #include <kern/sync_sema.h>
91 #include <vm/vm_map.h>
92 #include <vm/vm_kern.h>
94 #include <ipc/ipc_entry.h>
95 #include <ipc/ipc_space.h>
96 #include <ipc/ipc_object.h>
97 #include <ipc/ipc_port.h>
98 #include <ipc/ipc_pset.h>
99 #include <ipc/ipc_notify.h>
100 #include <ipc/ipc_kmsg.h>
101 #include <ipc/ipc_hash.h>
102 #include <ipc/ipc_init.h>
103 #include <ipc/ipc_table.h>
104 #include <ipc/ipc_voucher.h>
105 #include <ipc/ipc_importance.h>
107 #include <mach/machine/ndr_def.h> /* NDR_record */
109 vm_map_t ipc_kernel_map
;
110 vm_size_t ipc_kernel_map_size
= 1024 * 1024;
112 /* values to limit physical copy out-of-line memory descriptors */
113 vm_map_t ipc_kernel_copy_map
;
114 #define IPC_KERNEL_COPY_MAP_SIZE (8 * 1024 * 1024)
115 vm_size_t ipc_kernel_copy_map_size
= IPC_KERNEL_COPY_MAP_SIZE
;
116 vm_size_t ipc_kmsg_max_vm_space
= ((IPC_KERNEL_COPY_MAP_SIZE
* 7) / 8);
119 * values to limit inline message body handling
120 * avoid copyin/out limits - even after accounting for maximum descriptor expansion.
122 #define IPC_KMSG_MAX_SPACE (64 * 1024 * 1024) /* keep in sync with COPYSIZELIMIT_PANIC */
123 vm_size_t ipc_kmsg_max_body_space
= ((IPC_KMSG_MAX_SPACE
* 3)/4 - MAX_TRAILER_SIZE
);
130 lck_grp_t ipc_lck_grp
;
131 lck_attr_t ipc_lck_attr
;
133 static lck_grp_attr_t ipc_lck_grp_attr
;
135 extern void ikm_cache_init(void);
138 * Routine: ipc_bootstrap
140 * Initialization needed before the kernel task
149 lck_grp_attr_setdefault(&ipc_lck_grp_attr
);
150 lck_grp_init(&ipc_lck_grp
, "ipc", &ipc_lck_grp_attr
);
151 lck_attr_setdefault(&ipc_lck_attr
);
153 ipc_port_multiple_lock_init();
155 ipc_port_timestamp_data
= 0;
157 /* all IPC zones should be exhaustible */
159 ipc_space_zone
= zinit(sizeof(struct ipc_space
),
160 ipc_space_max
* sizeof(struct ipc_space
),
161 sizeof(struct ipc_space
),
163 zone_change(ipc_space_zone
, Z_NOENCRYPT
, TRUE
);
166 * populate all port(set) zones
168 ipc_object_zones
[IOT_PORT
] =
169 zinit(sizeof(struct ipc_port
),
170 ipc_port_max
* sizeof(struct ipc_port
),
171 sizeof(struct ipc_port
),
173 /* cant charge callers for port allocations (references passed) */
174 zone_change(ipc_object_zones
[IOT_PORT
], Z_CALLERACCT
, FALSE
);
175 zone_change(ipc_object_zones
[IOT_PORT
], Z_NOENCRYPT
, TRUE
);
177 ipc_object_zones
[IOT_PORT_SET
] =
178 zinit(sizeof(struct ipc_pset
),
179 ipc_pset_max
* sizeof(struct ipc_pset
),
180 sizeof(struct ipc_pset
),
182 zone_change(ipc_object_zones
[IOT_PORT_SET
], Z_NOENCRYPT
, TRUE
);
185 * Create the basic ipc_kmsg_t zone (the one we also cache)
186 * elements at the processor-level to avoid the locking.
188 ipc_kmsg_zone
= zinit(IKM_SAVED_KMSG_SIZE
,
189 ipc_port_max
* MACH_PORT_QLIMIT_DEFAULT
*
193 zone_change(ipc_kmsg_zone
, Z_CALLERACCT
, FALSE
);
195 /* create special spaces */
197 kr
= ipc_space_create_special(&ipc_space_kernel
);
198 assert(kr
== KERN_SUCCESS
);
201 kr
= ipc_space_create_special(&ipc_space_reply
);
202 assert(kr
== KERN_SUCCESS
);
204 /* initialize modules with hidden data structures */
207 ipc_port_debug_init();
213 #if IMPORTANCE_INHERITANCE
214 ipc_importance_init();
223 * XXX tunable, belongs in mach.message.h
225 #define MSG_OOL_SIZE_SMALL_MAX (2*PAGE_SIZE)
226 vm_size_t msg_ool_size_small
;
231 * Final initialization of the IPC system.
237 kern_return_t retval
;
240 retval
= kmem_suballoc(kernel_map
, &min
, ipc_kernel_map_size
,
241 TRUE
, VM_FLAGS_ANYWHERE
| VM_MAKE_TAG(VM_KERN_MEMORY_IPC
), &ipc_kernel_map
);
243 if (retval
!= KERN_SUCCESS
)
244 panic("ipc_init: kmem_suballoc of ipc_kernel_map failed");
246 retval
= kmem_suballoc(kernel_map
, &min
, ipc_kernel_copy_map_size
,
247 TRUE
, VM_FLAGS_ANYWHERE
| VM_MAKE_TAG(VM_KERN_MEMORY_IPC
), &ipc_kernel_copy_map
);
249 if (retval
!= KERN_SUCCESS
)
250 panic("ipc_init: kmem_suballoc of ipc_kernel_copy_map failed");
252 ipc_kernel_copy_map
->no_zero_fill
= TRUE
;
253 ipc_kernel_copy_map
->wait_for_space
= TRUE
;
256 * As an optimization, 'small' out of line data regions using a
257 * physical copy strategy are copied into kalloc'ed buffers.
258 * The value of 'small' is determined here. Requests kalloc()
259 * with sizes greater or equal to kalloc_max_prerounded may fail.
261 if (kalloc_max_prerounded
<= MSG_OOL_SIZE_SMALL_MAX
) {
262 msg_ool_size_small
= kalloc_max_prerounded
;
265 msg_ool_size_small
= MSG_OOL_SIZE_SMALL_MAX
;
267 /* account for overhead to avoid spilling over a page */
268 msg_ool_size_small
-= cpy_kdata_hdr_sz
;
276 * Routine: ipc_thread_call_init
278 * Initialize IPC logic that needs thread call support
282 ipc_thread_call_init(void)
284 #if IMPORTANCE_INHERITANCE
285 ipc_importance_thread_call_init();