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”)