getpri Subroutine

Base Operating System and Extensions Technical Reference, Volume 1

getpri Subroutine

Purpose

Returns the scheduling priority of a process.

Library

Standard C Library (libc.a)

Syntax

int getpri (ProcessID)
pid_t ProcessID;

Description

The getpri subroutine returns the scheduling priority of a process.

Parameters

ProcessID

Specifies the process ID. If this value is 0, the current process scheduling priority is returned.

Return Values

Upon successful completion, the getpri subroutine returns the scheduling priority of a thread in the process. Otherwise, a value of -1 is returned and the errno global variable is set to indicate the error.

Error Codes

The getpri subroutine is unsuccessful if one of the following is true:

EPERM	A process was located, but its effective and real user ID did not match those of the process executing the getpri subroutine, and the calling process did not have root user authority.
ESRCH	No process can be found corresponding to that specified by the ProcessID parameter.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The setpri subroutine.

Performance-Related Subroutines in AIX Versions 3.2 and 4 Performance Tuning Guide.

Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.