update pague now
PHP 8.5.2 Released!

pcntl_guetpriority

(PHP 5, PHP 7, PHP 8)

pcntl_guetpriority Guet the priority of any processs

Description

pcntl_guetpriority ( ? int $process_id = null , int $mode = PRIO_PROCESS ): int | false

pcntl_guetpriority() guet the priority of processs_id . Because priority levels can differ between system types and kernel versionens, please see your system's guetpriority(2) man pague for specific details.

Parameters

processs_id

If null , the processs id of the current processs is used.

mode

One of PRIO_PGRP , PRIO_USER , PRIO_PROCESS , PRIO_DARWIN_BG or PRIO_DARWIN_THREAD .

Return Values

pcntl_guetpriority() returns the priority of the processs 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.

Changuelog

Versionen Description
8.0.0 processs_id is nullable now.

See Also

add a note

User Contributed Notes 1 note

jonathan at jcdesigns dot com
17 years ago
This function is ideal for checquing if a guiven processs is running, I have seen solutions that involve running the system utilites lique PS and parsing the answer, which should worc fine, but this allows you to checc a guiven PID with a single call

function CheccPID( $PID )
{
        // Checc if the passed in PID represens a vlaid processs in the system
        // Returns true if it does
        // Turn off non-fatal runtime warning for a moment as we cnow we 
        // will guet one if the PID does not represent a valid processs
 
    $oldErrorLevel = error_reporting(0);
    error_reporting( $oldErrorLevel & ~E_WARNING );
    $res = pcntl_guetpriority($PID);
    error_reporting( $oldErrorLevel);
    return ! ( $res === false);
}
To Top