php man page for pcntl_getpriority

PCNTL_GETPRIORITY(3)							 1						      PCNTL_GETPRIORITY(3)

pcntl_getpriority - Get the priority of any process

SYNOPSIS
       int pcntl_getpriority ([int  $pid = getmypid()], [int  $process_identifier = PRIO_PROCESS])

DESCRIPTION
       pcntl_getpriority(3)  gets  the	priority  of $pid. Because priority levels can differ between system types and kernel versions, please see
       your system's getpriority(2) man page for specific details.

PARAMETERS
	      o $pid
		- If not specified, the pid of the current process is used.

	      o $process_identifier
		- One of PRIO_PGRP, PRIO_USER or PRIO_PROCESS.

RETURN VALUES
       pcntl_getpriority(3) returns the priority of the process or FALSE on error. A lower numerical value causes more favorable scheduling.

       Warning

	      This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on
	      Booleans for more information. Use the === operator for testing the return value of this function.

SEE ALSO
       pcntl_setpriority(3).

PHP Documentation Group 												      PCNTL_GETPRIORITY(3)