osfmk/man/norma_task_create.html

   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]
  19 The port for the task from which to draw the child
  20 task's port rights, resource limits, and address space.
  21 <p>
  22 <dt> <var>inherit_memory</var>
  23 <dd>
  24 [in scalar]
  25 Address space inheritance indicator.  If true, the child task
  26 inherits the address space of the parent task.  If false, the kernel assigns
  27 the child task an empty address space.
  28 <p>
  29 <dt> <var>child_node</var>
  30 <dd>
  31 [in scalar]
  32 The 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]
  37 The kernel-assigned port name for the new task.
  38 </dl>
  39 <h3>DESCRIPTION</h3>
  40 <p>
  41 The <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
  43 new task in <var>child_task</var>.  The child
  44 task 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>
  47 By way of comparison, tasks created by the standard <strong>task_create</strong>
  48 primitive are created on the same node as the parent.
  49 <p>
  50 Other than being created on a different node, the new task has the same
  51 properties as if created by <strong>task_create</strong>.
  52 <h3>RETURN VALUES</h3>
  53 <p>
  54 Only generic errors apply.
  55 <h3>RELATED INFORMATION</h3>
  56 <p>
  57 Functions:
  58 <a href="task_create.html"><strong>task_create</strong></a>,
  59 <a href="norma_task_clone.html"><strong>norma_task_clone</strong></a>.