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.  —  1 November 1988