# pcntl_setcpuaffinity

(PHP 8 >= 8.4.0)

pcntl_setcpuaffinity — Set the cpu affinity of a process

### Beschreibung

pcntl_setcpuaffinity(?int `$pid` = `null`, array `$hmask` = ?): bool

Sets the cpu affinity for the `pid` with the cpu affinity mask given by `hmask`.

### Parameter-Liste

`pid`
  If `null`, the current process ID is used.
`hmask`
  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 `hmask` is invalid. A ValueError is thrown if `pid` 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