1<h2>bootstrap_ports</h2>
2<hr>
3<p>
4<strong>Function</strong> - Return send rights to the system's control ports.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t   bootstrap_ports</strong>
8                <strong>(mach_port_t</strong>                          <var>bootstrap</var>,
9                 <strong>bootstrap</strong>                         <var>host_control</var>,
10                 <strong>host_control</strong>                     <var>device_master</var>,
11                 <strong>device_master</strong>                <var>root_wired_ledger</var>,
12                 <strong>root_wired_ledger</strong>            <var>root_paged_ledger</var>,
13                 <strong>bootstrap</strong>                             <var>security</var><strong>);</strong>
14</pre>
15<h3>PARAMETERS</h3>
16<dl>
17<p>
18<dt> <var>bootstrap</var> 
19<dd>
20[in bootstrap send right]
21The bootstrap port obtained from \*Ltask_get_special_ports()\*O.
22<p>
23<dt> <var>host_priv</var> 
24<dd>
25[out host-control send right]
26The control port for the host.
27<p>
28<dt> <var>device_master</var> 
29<dd>
30[out device-master send right]
31The device master port.
32<p>
33<dt> <var>root_wired_ledger</var> 
34<dd>
35[out ledger send right]
36The root wired kernel memory ledger port.
37<p>
38<dt> <var>root_paged_ledger</var> 
39<dd>
40[out ledger send right]
41The root default memory managed space ledger 
42port.
43<p>
44<dt> <var>security</var> 
45<dd>
46[out security send right]
47The host security port, used for setting task 
48identity.
49</dl>
50<h3>DESCRIPTION</h3>
51<p>
52The <strong>bootstrap_ports</strong> function returns a send right to
53the host control, root
54ledger, host security and device master ports.  The kernel will respond
55to this message on the <strong>TASK_BOOTSTRAP_PORT</strong> given to the system bootstrap
56task (task 1) with the system privileged ports.  It is the 
57responsibility of the bootstrap task to manage the distribution
58of these rights to other servers.
59<p>
60An OS personality can serve as a server on the TASK_BOOTSTRAP_PORT
61for tasks or servers that it manages, and can regulate or interpose on
62the ports in any way it deems necessary.
63<h3>RETURN VALUES</h3>
64<p>
65Only generic errors apply.
66<h3>RELATED INFORMATION</h3>
67<p>
68Functions:
69<a href="device_open.html"><strong>device_open</strong></a>,
70<a href="host_get_clock_control.html"><strong>host_get_clock_control</strong></a>,
71<a href="host_get_clock_service.html"><strong>host_get_clock_service</strong></a>,
72<a href="host_processor_set_priv.html"><strong>host_processor_set_priv</strong></a>,
73<a href="host_processors.html"><strong>host_processors</strong></a>,
74<a href="ledger_create.html"><strong>ledger_create</strong></a>,
75<a href="task_set_security_token.html"><strong>task_set_security_token</strong></a>.
76