Set the cpu affinity of a process

# 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

- pcntl_getcpuaffinity() - Get the cpu affinity of a process

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open