man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

pthread_attr_getschedpolicy(3C)

Name

pthread_attr_getschedpolicy, pthread_attr_setschedpolicy - get or set schedpolicy attribute

Synopsis

cc –mt [ flag... ] file... [ library... ]
#include <pthread.h>

int pthread_attr_getschedpolicy(const pthread_attr_t *restrict attr,
     int *restrict policy);
int pthread_attr_setschedpolicy(pthread_attr_t *attr, int policy);

Description

The functions pthread_attr_setschedpolicy() and pthread_attr_getschedpolicy(), respectively, set and get the schedpolicy attribute in the attr argument.

Supported values of policy include SCHED_FIFO, SCHED_RR and SCHED_OTHER, which are defined by the header sched.h. When threads executing with the scheduling policy SCHED_FIFO or SCHED_RR are waiting on a mutex, they acquire the mutex in priority order when the mutex is unlocked.

See sched.h(3HEAD) for a description of all defined policy values. Valid policy values can also be obtained from pthread_getschedparam(3C) and sched_getscheduler(3C).

Return Values

If successful, the pthread_attr_setschedpolicy() and pthread_attr_getschedpolicy() functions return 0. Otherwise, an error number is returned to indicate the error.

Errors

The pthread_attr_setschedpolicy() or pthread_attr_getschedpolicy() function may fail if:

EINVAL

attr or policy is invalid.

Usage

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

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See Also

pthread_attr_init(3C), pthread_attr_setscope(3C), pthread_attr_setinheritsched(3C), pthread_attr_setschedparam(3C), pthread_create(3C), pthread_getschedparam(3C), sched.h (3HEAD), sched_getscheduler(3C), attributes (5), standards(5)