Loading...
osfmk/man/task_create.html xnu-12377.121.6 /dev/null
--- xnu/xnu-12377.121.6/osfmk/man/task_create.html
+++ /dev/null
@@ -1,123 +0,0 @@
-<h2>task_create</h2>
-<hr>
-<p>
-<strong>Function</strong> - Create a new task.
-<h3>SYNOPSIS</h3>
-<pre>
-<strong>kern_return_t   task_create</strong>
-                <strong>(task_t</strong>                             <var>parent_task</var>,
-                 <strong>ledger_port_array_t</strong>                    <var>ledgers</var>,
-                 <strong>int</strong>                               <var>ledger_count</var>,
-                 <strong>boolean_t</strong>                       <var>inherit_memory</var>,
-                 <strong>task_t</strong>                              <var>child_task</var><strong>);</strong>
-</pre>
-<h3>PARAMETERS</h3>
-<dl>
-<p>
-<dt> <var>parent_task</var> 
-<dd>
-[in task send right]
-The port for the task from which to draw the child 
-task's port rights and address space.
-<p>
-<dt> <var>ledgers</var> 
-<dd>
-[pointer to in array of ledger send rights]
-Resource ledgers (on the
-destination host) from which the task will draw its resources.  The first
-element of this array is the wired kernel ledger, the second the paged 
-space ledger.  If the number of ledgers supplied does not match the
-required number or one or more is null, the parent task's ledger is used.
-<p>
-<dt> <var>ledger_count</var> 
-<dd>
-[in scalar]
-The number of ledger ports in the <var>ledgers</var> array.
-<p>
-<dt> <var>inherit_memory</var> 
-<dd>
-[in scalar]
-Address space inheritance indicator.  If true, the child task
-inherits the (inheritable) address space of the parent task.  If false, the
-kernel assigns the child task an empty address space.
-<p>
-<dt> <var>child_task</var> 
-<dd>
-[out task send right]
-The kernel-assigned port for the new task.
-</dl>
-<h3>DESCRIPTION</h3>
-<p>
-The <strong>task_create</strong> function creates a new task from <var>parent_task</var>
-and returns the name of the new task in <var>child_task</var>.  
-The child task acquires shared or copied parts of the parent's address space 
-(see <strong>vm_inherit</strong>).  The child task initially
-contains no threads.  The child task inherits the parent's security ID.
-<p>
-The child task receives the following "special" ports, which are created or
-copied for it at task creation:
-<dl>
-<dt> [task-self send right]
-<dd>
-The port by which the kernel knows the new child task 
-and allows it to be manipulated.  The child task holds a send right for this 
-port.  The port name is also returned to the calling task.
-<p>
-<dt> [bootstrap send right]
-<dd>
-The port to which the child task can send a message
-requesting return of any system service ports that it needs (for
-example, a port 
-to the Network Name Server or the Environment Manager).  The child task 
-inherits a send right for this port from the parent task.  The task can use 
-<strong>task_set_special_port</strong> to change this port.
-<p>
-<dt> [host-self send right]
-<dd>
-The port by which the child task requests information 
-about its host.  The child task inherits a send right for this port from the
-parent task.
-<p>
-<dt> [ledger send rights]
-<dd>
-The ports naming the ledgers from which the task draws 
-its resources.
-</dl>
-<p>
-The child task also inherits the following ports:
-<dl>
-<dt> [sample send right]
-<dd>
-The port to which PC sampling messages are to be sent.
-<p>
-<dt> [exception send rights]
-<dd>
-Ports to which exception messages are sent.
-<p>
-<dt> [registered send rights]
-<dd>
-Ports to system services.
-</dl>
-<h3>NOTES</h3>
-<p>
-The <strong>ledgers</strong> functionality mentioned above is not
-currently implemented.
-<h3>RETURN VALUES</h3>
-<p>
-Only generic errors apply.
-<h3>RELATED INFORMATION</h3>
-<p>
-Functions:
-<a href="task_create_security_token.html"><strong>task_create_security_token</strong></a>,
-<a href="task_resume.html"><strong>task_resume</strong></a>,
-<a href="task_set_special_port.html"><strong>task_set_special_port</strong></a>,
-<a href="task_suspend.html"><strong>task_suspend</strong></a>,
-<a href="task_terminate.html"><strong>task_terminate</strong></a>,
-<a href="task_threads.html"><strong>task_threads</strong></a>,
-<a href="thread_create.html"><strong>thread_create</strong></a>,
-<a href="thread_resume.html"><strong>thread_resume</strong></a>,
-<a href="vm_inherit.html"><strong>vm_inherit</strong></a>,
-<a href="task_sample.html"><strong>task_sample</strong></a>,
-<a href="task_set_exception_ports.html"><strong>task_set_exception_ports</strong></a>,
-<a href="mach_ports_register.html"><strong>mach_ports_register</strong></a>,
-<a href="host_security_set_task_token.html"><strong>host_security_set_task_token</strong></a>.