Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pthread_setschedprio(3C)

Name

pthread_setschedprio - dynamic thread scheduling parameters access

Synopsis

#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. It is not an error for the target thread to be a zombie thread.

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(7) for descriptions of the following attributes:

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

See Also

pthread_getschedparam(3C), attributes(7), standards(7)