array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.pcntl-setcpuaffinity.php', 1 => 'pcntl_setcpuaffinity', 2 => 'Set the cpu affinity of a process', ), 'up' => array ( 0 => 'ref.pcntl.php', 1 => 'PCNTL Functions', ), 'prev' => array ( 0 => 'function.pcntl-rfork.php', 1 => 'pcntl_rfork', ), 'next' => array ( 0 => 'function.pcntl-setpriority.php', 1 => 'pcntl_setpriority', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/pcntl/functions/pcntl-setcpuaffinity.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pcntl_setcpuaffinity

(PHP 8 >= 8.4.0)

pcntl_setcpuaffinity — Set the cpu affinity of a process

Description

pcntl_setcpuaffinity(?int $process_id = null, array $cpu_ids = []): bool

Sets the cpu affinity for the process_id with the cpu affinity mask given by cpu_ids.

Parameters

process_id
If null, the current process ID is used.
cpu_ids
The cpu affinity mask comprised of one or more cpu id for binding the process to.

Return Values

Returns true on success 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 TypeError is thrown if one of the cpu id from the cpu_ids is invalid. A ValueError is thrown if process_id is an invalid process id or the cpu mask had failed to be created.

See Also