pthread_getprio

Obtains the current priority of a thread.

Syntax

pthread_getprio( thread );

Argument Data Type Access

thread opaque pthread_t read

C Binding

int
pthread_getprio (
pthread_t thread);

Arguments

thread: Thread whose priority is obtained.

Description

This routine obtains the current priority of a thread. The current priority is different from the initial priority of the thread if the pthread_setprio routine is called.

The exact effect of different priority values depends upon the scheduling policy assigned to the thread.

Return Values

The current priority value of the thread specified in thread is returned. See the description of pthread_ setprio for valid values.

If an error condition occurs, this routine returns -1 and sets errno to the corresponding error value. Possible return values are as follows:

Return Error Description

Priority Successful completion. value -1 [EINVAL] The value specified by thread is invalid.