Name

stopcpu − stop a CPU

Syntax

stopcpu(cpunumber)
int cpunumber;

Description

The stopcpu system call stops the CPU specified by cpunumber.  Any nid-boot CPU can be stopped using this system call. Only a superuser can execute the stopcpu system call.

Return Values

The stopcpu call returns 0 if the CPU was stopped successfully, or else it returns -1 and sets errno appropriately.

Diagnostics

[EPERM] The caller is not a superuser

[EACCES] Trying to stop boot CPU

[EBUSY] The CPU is already stopped or no such CPU present

[EINVAL] Invalid value for cpunumber.  A value cpunumber is between 0 and 31. 

See Also

startcpu (2), startcpu (8), stopcpu (8)