man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

pthread_setschedprio(3C)

Name

pthread_setschedprio - dynamic thread scheduling parameters access

Synopsis

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

int pthread_setschedprio(pthread_t thread, int prio);

Description

The pthread_setschedprio() function sets the scheduling priority for the thread whose thread ID is given by thread to the value given by prio.

If the pthread_setschedprio() function fails, the scheduling priority of the target thread is not changed.

Return Values

If successful, the pthread_setschedprio() function returns 0; otherwise, an error number is returned to indicate the error.

Errors

The pthread_setschedprio() function will fail if:

EINVAL

The value of prio is invalid for the scheduling policy of the specified thread.

EPERM

The caller does not have the appropriate permission to set the priority to the value specified.

ESRCH

The value specified by thread does not refer to an existing 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_getschedparam(3C), attributes (5), standards(5)