HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

pthread_setschedprio(3T) pthread_setschedprio(3T)

(Pthread Library)

NAME

pthread_setschedprio() - sets scheduling priority of a thread

SYNOPSIS

#include <pthread.h>

int pthread_setschedprio(pthread_t thread, int prio)

PARAMETERS

thread The thread whose scheduling priority is to be set.

prio The new priority for the thread.

DESCRIPTION

The pthread_setschedprio()

function sets the scheduling priority of thread to the value prio.If

the

pthread_setschedprio()

function fails, the scheduling priority of the target thread is not

changed.

RETURN VALUE

Upon successful completion,

pthread_setschedprio()

returns zero. Otherwise, an error number is

returned to indicate the error (the

errno variable is not set).

ERRORS

If any of the following occur, the pthread_setschedprio()

function returns the corresponding error

number:

[EINVAL] The value of prio is invalid for the scheduling policy of the speciﬁed thread.

[EPERM] The implementation does not allow the application to modify the priority to the value

speciﬁed.

[ESRCH] No thread could be found corresponding to thread.

AUTHOR

pthread_setschedprio()

is derived from the IEEE Std 1003.1-2001.