Set the cpu affinity of a process

# pcntl_setcpuaffinity

(PHP 8 >= 8.4.0)

pcntl_setcpuaffinity — Set the cpu affinity of a process

### Beschreibung

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

### Parameter-Liste

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

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

Warnung

Diese Funktion kann sowohl das boolsche `false` zurückliefern, als auch einen nicht-boolschen Wert, welcher zu `false` ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die boolschen Typen. Benutzen Sie deshalb den === Operator, um den Rückgabewert dieser Funktion zu überprüfen.

### Fehler/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.

### Siehe auch

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

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