Overview
KB
Technical FAQ
PHP Manual
CSS2 Manual
HTML Manual
JS Guide
JS Reference
PhpDock Manual
Nu-Coder Manual
PhpExpress Manual
PHP Joomla
Development
Learn PHP
 
<pcntl_getcpupcntl_getpriority>
^PCNTL FunctionsLast updated: Mon, 26 Oct 2026

pcntl_getcpuaffinity

(PHP 8 >= 8.4.0)

pcntl_getcpuaffinity — Get the cpu affinity of a process

Description

function 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


<pcntl_getcpupcntl_getpriority>
^PCNTL FunctionsLast updated: Mon, 26 Oct 2026