array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.pcntl-getcpuaffinity.php', 1 => 'pcntl_getcpuaffinity', 2 => 'Get the cpu affinity of a process', ), 'up' => array ( 0 => 'ref.pcntl.php', 1 => 'PCNTL Functions', ), 'prev' => array ( 0 => 'function.pcntl-get-last-error.php', 1 => 'pcntl_get_last_error', ), 'next' => array ( 0 => 'function.pcntl-getpriority.php', 1 => 'pcntl_getpriority', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/pcntl/functions/pcntl-getcpuaffinity.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pcntl_getcpuaffinity

(PHP 8 >= 8.4.0)

pcntl_getcpuaffinity — Get the cpu affinity of a process

Description

pcntl_getcpuaffinity(?int $process_id = null): array|false

Retrieve the cpu affinity of the process_id.

Parameters

process_id
If null, the current process ID is used.

Return Values

Returns the cpu affinity mask of the process, or false on failure.

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.

Errors/Exceptions

A ValueError is thrown when process_id is an invalid process id or the cpu mask had failed to be created.

If process_id is a process for which the current user has no allowed permission, a E_WARNING is emitted.

See Also