SETCPUSTATUS(2) — SYSTEM CALLS
NAME
setcpustatus − set enable status of all CPUs
SYNOPSIS
syscall(SYS_setcpustatus, status, width)
unsigned int status;
unsigned int width;
DESCRIPTION
setcpustatus() sets the enable status of all the CPUs in the machine. status is a bit mask that represents the status of each CPU in the system. Each bit in status which is set to a 1 indicates that CPU should be enabled. width is the number of valid bits in the CPU bit mask status.
The master CPU is always assigned CPU number 0. All slave CPUs are arbitrarily assigned a unique CPU number.
WARNING
The status of the master CPU may not be altered. A slaves status will be altered if possible.
This system call is only accessible via syscall(2).
RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise a value of −1 is returned and errno is set to indicate an error.
ERRORS
setcpustatus() will fail and the status of the CPUs will be unchanged if one or more of the following are true:
EPERM The effective user ID is not super-user.
EINVAL width specifies more CPUs than are in the machine.
SEE ALSO
syscall(2), getcpustatus(2), setcpustatus(2)
Solbourne Computer, Inc. — 13 Dec 1990