X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..39236c6e673c41db228275375ab7fdb0f837b292:/osfmk/man/bootstrap_ports.html

diff --git a/osfmk/man/bootstrap_ports.html b/osfmk/man/bootstrap_ports.html
old mode 100755
new mode 100644
index 3d5030e00..1b5b2fe1a
--- a/osfmk/man/bootstrap_ports.html
+++ b/osfmk/man/bootstrap_ports.html
@@ -1 +1,75 @@
-<h2>bootstrap_ports</h2>
<hr>
<p>
<strong>Function</strong> - Return send rights to the system's control ports.
<h3>SYNOPSIS</h3>
<pre>
<strong>kern_return_t   bootstrap_ports</strong>
                <strong>(mach_port_t</strong>                          <var>bootstrap</var>,
                 <strong>bootstrap</strong>                         <var>host_control</var>,
                 <strong>host_control</strong>                     <var>device_master</var>,
                 <strong>device_master</strong>                <var>root_wired_ledger</var>,
                 <strong>root_wired_ledger</strong>            <var>root_paged_ledger</var>,
                 <strong>bootstrap</strong>                             <var>security</var><strong>);</strong>
</pre>
<h3>PARAMETERS</h3>
<dl>
<p>
<dt> <var>bootstrap</var> 
<dd>
[in bootstrap send right]
The bootstrap port obtained from \*Ltask_get_special_ports()\*O.
<p>
<dt> <var>host_priv</var> 
<dd>
[out host-control send right]
The control port for the host.
<p>
<dt> <var>device_master</var> 
<dd>
[out device-master send right]
The device master port.
<p>
<dt> <var>root_wired_ledger</var> 
<dd>
[out ledger send right]
The root wired kernel memory ledger port.
<p>
<dt> <var>root_paged_ledger</var> 
<dd>
[out ledger send right]
The root default memory managed space ledger 
port.
<p>
<dt> <var>security</var> 
<dd>
[out security send right]
The host security port, used for setting task 
identity.
</dl>
<h3>DESCRIPTION</h3>
<p>
The <strong>bootstrap_ports</strong> function returns a send right to
the host control, root
ledger, host security and device master ports.  The kernel will respond
to this message on the <strong>TASK_BOOTSTRAP_PORT</strong> given to the system bootstrap
task (task 1) with the system privileged ports.  It is the 
responsibility of the bootstrap task to manage the distribution
of these rights to other servers.
<p>
An OS personality can serve as a server on the TASK_BOOTSTRAP_PORT
for tasks or servers that it manages, and can regulate or interpose on
the ports in any way it deems necessary.
<h3>RETURN VALUES</h3>
<p>
Only generic errors apply.
<h3>RELATED INFORMATION</h3>
<p>
Functions:
<a href="device_open.html"><strong>device_open</strong></a>,
<a href="host_get_clock_control.html"><strong>host_get_clock_control</strong></a>,
<a href="host_get_clock_service.html"><strong>host_get_clock_service</strong></a>,
<a href="host_processor_set_priv.html"><strong>host_processor_set_priv</strong></a>,
<a href="host_processors.html"><strong>host_processors</strong></a>,
<a href="ledger_create.html"><strong>ledger_create</strong></a>,
<a href="task_set_security_token.html"><strong>task_set_security_token</strong></a>.
\ No newline at end of file
+<h2>bootstrap_ports</h2>
+<hr>
+<p>
+<strong>Function</strong> - Return send rights to the system's control ports.
+<h3>SYNOPSIS</h3>
+<pre>
+<strong>kern_return_t   bootstrap_ports</strong>
+                <strong>(mach_port_t</strong>                          <var>bootstrap</var>,
+                 <strong>bootstrap</strong>                         <var>host_control</var>,
+                 <strong>host_control</strong>                     <var>device_master</var>,
+                 <strong>device_master</strong>                <var>root_wired_ledger</var>,
+                 <strong>root_wired_ledger</strong>            <var>root_paged_ledger</var>,
+                 <strong>bootstrap</strong>                             <var>security</var><strong>);</strong>
+</pre>
+<h3>PARAMETERS</h3>
+<dl>
+<p>
+<dt> <var>bootstrap</var> 
+<dd>
+[in bootstrap send right]
+The bootstrap port obtained from \*Ltask_get_special_ports()\*O.
+<p>
+<dt> <var>host_priv</var> 
+<dd>
+[out host-control send right]
+The control port for the host.
+<p>
+<dt> <var>device_master</var> 
+<dd>
+[out device-master send right]
+The device master port.
+<p>
+<dt> <var>root_wired_ledger</var> 
+<dd>
+[out ledger send right]
+The root wired kernel memory ledger port.
+<p>
+<dt> <var>root_paged_ledger</var> 
+<dd>
+[out ledger send right]
+The root default memory managed space ledger 
+port.
+<p>
+<dt> <var>security</var> 
+<dd>
+[out security send right]
+The host security port, used for setting task 
+identity.
+</dl>
+<h3>DESCRIPTION</h3>
+<p>
+The <strong>bootstrap_ports</strong> function returns a send right to
+the host control, root
+ledger, host security and device master ports.  The kernel will respond
+to this message on the <strong>TASK_BOOTSTRAP_PORT</strong> given to the system bootstrap
+task (task 1) with the system privileged ports.  It is the 
+responsibility of the bootstrap task to manage the distribution
+of these rights to other servers.
+<p>
+An OS personality can serve as a server on the TASK_BOOTSTRAP_PORT
+for tasks or servers that it manages, and can regulate or interpose on
+the ports in any way it deems necessary.
+<h3>RETURN VALUES</h3>
+<p>
+Only generic errors apply.
+<h3>RELATED INFORMATION</h3>
+<p>
+Functions:
+<a href="device_open.html"><strong>device_open</strong></a>,
+<a href="host_get_clock_control.html"><strong>host_get_clock_control</strong></a>,
+<a href="host_get_clock_service.html"><strong>host_get_clock_service</strong></a>,
+<a href="host_processor_set_priv.html"><strong>host_processor_set_priv</strong></a>,
+<a href="host_processors.html"><strong>host_processors</strong></a>,
+<a href="ledger_create.html"><strong>ledger_create</strong></a>,
+<a href="task_set_security_token.html"><strong>task_set_security_token</strong></a>.