pthread_getschedparam(3)

pthread_getschedparam3

Thread scheduling parameter manipulation

Usage

#include <pthread.h>

int

pthread_setschedparam(pthread_t thread, int policy, const struct sched_param *param);

int

pthread_getschedparam(pthread_t thread, int *policy, struct sched_param *param);

Overview

The pthread_setschedparam() and pthread_getschedparam() functions set and get the scheduling parameters of individual threads. The scheduling policy for a thread can either be SCHED_FIFO (first in, first out), SCHED_RR (round-robin), or SCHED_OTHER (timesharing). Valid thread priorities (accessed via param->sched_priority) must be within the range returned by the sched_get_priority_min(2) and sched_get_priority_max(2) system calls.

Return values

If successful, these functions return 0. Otherwise, an error number is returned to indicate the error.

Errors

The pthread_setschedparam() function will fail if:

[EINVAL]

Invalid value for policy.

[ENOTSUP]

Invalid value for scheduling parameters.

[ESRCH]

Non-existent thread thread.

The pthread_getschedparam() function will fail if:

[ESRCH]

Non-existent thread thread.

Releases

149 releases since Mac OS X 10.2; the text changed 2 times.

  1. 10.2–10.4.11
  2. 10.5–10.11.6
  3. 10.12–26.5

Standards

The pthread_setschedparam() and pthread_getschedparam() functions conform to Version 2 of the Single UNIX Specification (“SUSv2”).

From libpthread 539.100.4 in macOS 26.5. Parsed by carta from the page's mdoc source.