NAME

pthread_attr_setschedparam pthread_attr_getschedparam — set and get schedparam attribute

SYNOPSIS

#include <pthread.h>

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

DESCRIPTION

The functions pthread_attr_setschedparam() and pthread_attr_getschedparam() , respectively, set and get the scheduling parameter attributes in the attr argument. The contents of the param structure are defined in <sched.h> . For the SCHED_FIFO and SCHED_RR policies, the only required member of param is sched_priority .

RETURN VALUE

If successful, the pthread_attr_setschedparam() and pthread_attr_getschedparam() functions return zero. Otherwise, an error number is returned to indicate the error.

ERRORS

The pthread_attr_setschedparam() function may fail if:

[EINVAL]

The value of the attribute being set is not valid.

[ENOTSUP]

An attempt was made to set the attribute to an unsupported value.

The pthread_attr_setschedparam() and pthread_attr_getschedparam() functions will not return an error code of [EINTR].

EXAMPLES

None.

APPLICATION USAGE

After these attributes have been set, a thread can be created with the specified attributes using pthread_create(3) . Using these routines does not affect the current running thread.

FUTURE DIRECTIONS

None.

SEE ALSO

pthread_attr_init(3) , pthread_attr_setscope(3) , pthread_attr_setinheritsched(3) , pthread_attr_setschedpolicy(3) , pthread_create(3) , <pthread.h> , pthread_setschedparam(3) , <sched.h> .

DERIVATION

Derived from the POSIX Threads Extension (1003.1c-1995)