pcntl_setcpuaffinity

(PHP 8 >= 8.4.0)

pcntl_setcpuaffinity — Set the cpu affinity of a process

Description

function 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.

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