1<h2>norma_task_create</h2>
2<hr>
3<p>
4<strong>Function</strong> - Create a remote task using task_create semantics.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t   norma_task_create</strong>
8                <strong>(task_t</strong>                             <var>parent_task</var>,
9                 <strong>boolean_t</strong>                       <var>inherit_memory</var>,
10                 <strong>int</strong>                                 <var>child_node</var>,
11                 <strong>task_t</strong>                              <var>child_task</var><strong>);</strong>
12</pre>
13<h3>PARAMETERS</h3>
14<dl>
15<p>
16<dt> <var>parent_task</var> 
17<dd>
18[in task send right]
19The port for the task from which to draw the child 
20task's port rights, resource limits, and address space.
21<p>
22<dt> <var>inherit_memory</var> 
23<dd>
24[in scalar]
25Address space inheritance indicator.  If true, the child task
26inherits the address space of the parent task.  If false, the kernel assigns 
27the child task an empty address space.
28<p>
29<dt> <var>child_node</var> 
30<dd>
31[in scalar]
32The node index of the node on which to create the child.
33<p>
34<dt> <var>child_task</var> 
35<dd>
36[out task send right]
37The kernel-assigned port name for the new task.
38</dl>
39<h3>DESCRIPTION</h3>
40<p>
41The <strong>norma_task_create</strong> function creates a new task from
42<var>parent_task</var> on the specified <var>node</var> and returns the name of the 
43new task in <var>child_task</var>.  The child 
44task acquires shared or copied parts of the parent's address space (see
45<strong>vm_inherit</strong>).  The child task initially contains no threads.
46<p>
47By way of comparison, tasks created by the standard <strong>task_create</strong>
48primitive are created on the same node as the parent.
49<p>
50Other than being created on a different node, the new task has the same
51properties as if created by <strong>task_create</strong>.
52<h3>RETURN VALUES</h3>
53<p>
54Only generic errors apply.
55<h3>RELATED INFORMATION</h3>
56<p>
57Functions:
58<a href="task_create.html"><strong>task_create</strong></a>,
59<a href="norma_task_clone.html"><strong>norma_task_clone</strong></a>.
60