projects / apple / xnu.git / blame
| Commit | Line | Data |
|---|---|---|
| 13fec989 A |
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>. |