## task_assign

Function - Assign a task to a processor set.

### SYNOPSIS

    kern_return_t   task_assign
                    (task_t                                    task,
                     processor_set_t                  processor_set,
                     boolean_t                       assign_threads);

### PARAMETERS

task
  [in task send right] The port for the task to be assigned.
processor_set
  [in processor-set-control send right] The control port for the processor set into which the task is to be assigned.
assign_threads
  [in scalar] True if this assignment should apply as well to the threads within the task.

### DESCRIPTION

The task_assign function assigns task to the set 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 assign_threads is TRUE, existing threads within the task will also be assigned to the processor set.

### RETURN VALUES

Only generic errors apply.

### RELATED INFORMATION

Functions: task_assign_default, task_get_assignment, processor_set_create, processor_set_info, thread_assign.