Back to Darwin Xnu

Processor Set Max Priority

osfmk/man/processor_set_max_priority.html

latest1.5 KB
Original Source

processor_set_max_priority


Function - Sets the maximum scheduling priority for a processor set.

SYNOPSIS

**#include&lt mach/mach\_host.h&gt**** kern\_return\_t processor\_set\_max\_priority****(processor\_set\_t**processor\_set, **int** priority, **boolean\_t** change\_threads**);**

PARAMETERS

processor_set[in processor-set-control port] The control port for the processor set whose maximum scheduling priority is to be set. priority[in scalar] The new priority for the processor set. change_threads[in scalar] True if the maximum priority of existing threads assigned to this processor set should also be changed.

DESCRIPTION

The processor_set_max_priority function sets the maximum scheduling priority for processor_set. The maximum priority of a processor set is used only when creating new threads. A new thread's maximum priority is set to that of its assigned processor set. When assigned to a processor set, a thread's maximum priority is reduced, if necessary, to that of its new processor set; its current priority is also reduced, as needed. Changing the maximum priority of a processor set does not affect the priority of the currently assigned threads unless change_threads is TRUE. If this priority change violates the maximum priority of some threads, their maximum priorities will be reduced to match.

RETURN VALUES

Only generic errors apply.

Functions: thread_assign.