getprio()

Get the priority of a given process

Synopsis:

#include <sched.h>

int getprio( pid_t pid );

Arguments:

pid: The process ID of the process whose priority you want to get.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The getprio() function returns the current priority of thread 1 in process pid. If pid is zero, the priority of the calling thread is returned.

Note: In order to get the priority for a thread whose real or saved user ID is different from the calling process's real or effective user ID, your process must have the PROCMGR_AID_SCHEDULE ability enabled. For more information, see procmgr_ability().

Returns:

The priority, or -1 if an error occurred (errno is set).

Errors:

EPERM: The calling process doesn't have sufficient privilege to get the scheduling policy; see procmgr_ability().
ESRCH: The process pid doesn't exist.

Classification:

QNX 4

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes

Caveats:

The getprio() and setprio() functions are included in the libraries for porting QNX 4 applications. For new programs, use pthread_getschedparam().