task_assign_default.html   [plain text]

<strong>Function</strong> - Assign a task to the default processor set.
<strong>kern_return_t   task_assign_default</strong>
                <strong>(task_t</strong>                                    <var>task</var>,
                 <strong>boolean_t</strong>                       <var>assign_threads</var><strong>);</strong>
<dt> <var>task</var> 
[in task send right]
The port for the task to be assigned.
<dt> <var>assign_threads</var> 
[in scalar]
True if this assignment should apply as well to the threads 
within the task.
The <strong>task_assign_default</strong> function assigns <var>task</var> to the
default processor set.
After the assignment is completed, newly created threads within
this task will be 
assigned to this processor set.  Any previous assignment of the
task is nullified. 
If <var>assign_threads</var> is <strong>TRUE</strong>, existing threads within the 
task will also be assigned to the processor set.
This variant of <strong>task_assign</strong> exists because the control
port for the default
processor set is privileged, and therefore not available to most tasks.
Only generic errors apply.
<a href="task_assign.html"><strong>task_assign</strong></a>,
<a href="task_get_assignment.html"><strong>task_get_assignment</strong></a>,
<a href="processor_set_create.html"><strong>processor_set_create</strong></a>,
<a href="processor_set_info.html"><strong>processor_set_info</strong></a>,
<a href="thread_assign.html"><strong>thread_assign</strong></a>.