Back to Darwin Xnu

Task Set Policy

osfmk/man/task_set_policy.html

latest2.0 KB
Original Source

task_set_policy


Function - Set target task's default scheduling policy state. (Protected Interface.)

SYNOPSIS

**kern\_return\_t task\_set\_policy**** (task\_t **task,** processor\_set\_t **processor\_set,** policy\_t **policy,** policy\_base\_t **base,** mach\_msg\_type\_number\_t **base\_count,** policy\_limit\_t **limit,** mach\_msg\_type\_number\_t **limit\_count,** boolean\_t **change\_threads** );**

PARAMETERS

task[in task send right] The task whose scheduling policy is to be set. processor_set[in processor-set-control send right] The control port for the processor set to which the task is currently assigned. policy[in scalar] Policy to be set. The values currently defined are POLICY_TIMESHARE , POLICY_RR (round robin) and POLICY_FIFO (firstin, first-out). base[pointer to in structure] Base policy specific data, policy_fifo_base , policy_rr_base or policy_timeshare_base. base_count[in scalar] The size of the buffer (in natural-sized units). limit[pointer to in structure] Policy specific limits, policy_fifo_limit , policy_rr_limit or policy_timeshare_limit. limit_count[in scalar] The size of the buffer (in natural-sized units). change_threads[in scalar] True if the scheduling attributes for all contained threads should be changed as well.

DESCRIPTION

The task_set_policy function sets the scheduling attributes, both base and limit, for task. policy may be any policy implemented by the processor set whether or not it is enabled.

RETURN VALUES

KERN_INVALID_PROCESSOR_SET processor_set is not the task's processor set control port.

Functions: processor_set_policy_control, thread_policy, thread_set_policy, task_policy.

Data Structures: policy_fifo_info, policy_rr_info, policy_timeshare_info.