NAME

pthread_setschedparam, pthread_getschedparam — thread scheduling parameter manipulation

LIBRARY

POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS

#include <pthread.h>

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

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

DESCRIPTION

The pthread_setschedparam() and pthread_getschedparam() functions set and get the scheduling parameters of individual threads. The scheduling policy for a thread can be:

SCHED_FIFO

First in, first out.

SCHED_RR

Round-robin.

SCHED_OTHER

The system default.

The thread priority (accessed via param->sched_priority) must be at least PTHREAD_MIN_PRIORITY and no more than PTHREAD_MAX_PRIORITY.

RETURN VALUES

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

ERRORS

pthread_setschedparam() may fail if:

[EINVAL]

The value specified by policy is invalid.

[ENOTSUP]

Invalid value for scheduling parameters.

[ESRCH]

Non-existent thread thread.

pthread_getschedparam() may fail if:

[ESRCH]

Non-existent thread thread.

SEE ALSO

pthread_attr_getschedparam(3), sched(3)

STANDARDS

Both functions conform to IEEE Std 1003.1-2001 (“POSIX.1”).