X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/13fec9890cf095cc781fdf7b8917cb03bf32dd4c..f427ee49d309d8fc33ebf3042c3a775f2f530ded:/osfmk/man/norma_task_clone.html diff --git a/osfmk/man/norma_task_clone.html b/osfmk/man/norma_task_clone.html deleted file mode 100755 index 737acb899..000000000 --- a/osfmk/man/norma_task_clone.html +++ /dev/null @@ -1,78 +0,0 @@ -

norma_task_clone

-
-

-Function - Create a remote task that shares access to parent task's memory regardless of inheritance attributes. -

SYNOPSIS

-
-kern_return_t   norma_task_clone
-                (task_t                             parent_task,
-                 boolean_t                       inherit_memory,
-                 int                                 child_node,
-                 task_t                              child_task);
-
-

PARAMETERS

-
-

-

parent_task -
-[in task send right] -The port for the task from which to draw the child -task's port rights, resource limits, and address space. -

-

inherit_memory -
-[in scalar] -Address space inheritance indicator. If true, the child task -inherits the address space of the parent task. If false, the kernel assigns -the child task an empty address space. -

-

child_node -
-[in scalar] -The node index of the node on which to create the child. -

-

child_task -
-[out task send right] -The kernel-assigned port name for the new task. -
-

DESCRIPTION

-

-The norma_task_clone function "clones" a new task from -parent_task on the specified node and returns the name -of the new task in child_task. The child -task acquires shared parts of the parent's -address space (see vm_inherit) -regardless of the inheritance set for the parent's memory regions, although the -inheritance for the child's regions will be set to that of the -parent's regions. The child -task initially contains no threads. -

-By way of comparison, tasks created by the standard task_create -primitive are created on the same node as the parent. -

-Other than being created on a different node, the new task has the same -properties as if created by task_create. -

NOTES

-

-This call differs from norma_task_create in that the -inheritance set for the -parent's memory regions is ignored; the child always shares memory with the -parent. -

-This call is intended to support process migration, where the inheritance -semantics of norma_task_create would break migrated -programs that depended upon -sharing relationships remaining after migration. -

-This call is not a true task migration call, in that it does -not migrate the port -space, threads, and other non-address-space attributes of the task. -

RETURN VALUES

-

-Only generic errors apply. -

RELATED INFORMATION

-

-Functions: -task_create, -norma_task_create.