NAME

pthread_attr_getschedparam, pthread_attr_setschedparam — thread attribute operations

SYNOPSIS

#include <pthread.h>

int
pthread_attr_getschedparam(const pthread_attr_t *restrict attr, struct sched_param *restrict param);

int
pthread_attr_setschedparam(pthread_attr_t *restrict attr, const struct sched_param *restrict param);

DESCRIPTION

Thread attributes are used to specify parameters to pthread_create(). One attribute object can be used in multiple calls to pthread_create(), with or without modifications between calls.

pthread_attr_getschedparam() and pthread_attr_setschedparam() get and set the scheduling parameters within the attr argument. See /usr/include/sched.h for the definition of struct sched_param. The sched_priority field of struct sched_param 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. pthread_attr_getschedparam(), on success, will copy the value of the thread's scheduling parameter attribute to the location pointed to by the second function parameter.

ERRORS

pthread_attr_getschedparam() will fail if:

[EINVAL]: Invalid value for attr.

pthread_attr_setschedparam() will fail if:

[EINVAL]: Invalid value for attr.
[ENOTSUP]: Invalid value for param.

STANDARDS