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.

SEE ALSO

pthread_create(3), pthread_attr_init(3), pthread_attr_setinheritsched(3)

STANDARDS

pthread_attr_setschedparam(), pthread_attr_getschedparam() conform to Version 2 of the Single UNIX Specification (“SUSv2”)