## processor_set_max_priority

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

### SYNOPSIS

    #include< mach/mach_host.h>

    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.

### RELATED INFORMATION

Functions: thread_assign.