Guardian Procedure Calls Reference Manual

Parameters
TargetCPU
input
INT:value
specifies the CPU to which the action is directed. A value of -1 means all the CPUs in the local
system. When -1 is specified, the first CPU which encounters an error (other than a down CPU
error) results in that error being returned without attempting the setting on the other CPUs. It is
expected that if an error is returned for any CPU then it would be returned for all CPUs, given
the possible errors. Also, in the -1 case, a down CPU is ignored; the requested settings are
applied only to the up CPUs.
controlFlagsMask
input
INT(64):value
specifies a bit mask (with bit 0 being the high-order bit, and bit 63 being the low-order bit)
used in conjunction with the controlFlagsSetting parameter. A bit set to 1 in the
controlFlagsMask denotes that the corresponding bit in the controlFlagsSetting is
to be used. If the controlFlagsMask bit is set to 0 then no action is taken by this procedure
other than returning the current settings, and in this case no security checks are done (see
Considerations below). Mask bits 2-62 are reserved and must be zero.
controlFlagsSetting
input
INT(64):value
specifies a bit mask (with bit 0 being the high-order bit, and bit 63 being the low-order bit)
used in conjunction with the controlFlagsMask parameter. The controlFlagsSetting
bits are defined as follows):
Enables soft affinity balancing for the TargetCPU.1<0>
Disables soft affinity balancing for the TargetCPU.0
Enables DP2 balancing for the TargetCPU.1<1>
Disables DP2 balancing for the TargetCPU.0
Reserved and must be zero.0<2:62>
Ignored.0<63>
Brings the specified CPU or the system (if TargetCPU is -1) back to its initial state with respect
to process scheduling. Any actions indicated by any other valid bits in the mask/setting are
1
ignored, but an invalid mask bit value still generates an error. This procedure also clears all
associations established via IPUAFFINITY_SET_.
previousControlFlags
output
INT(64) .EXT:ref:1
returns the previous setting of all of the control bits. It includes all the flags, not just the ones
made active by the mask field. Bit 63 is always returned as 0. If a target CPU of -1 is specified,
then the previousControlFlags returned is undefined.
IPUAFFINITY_CONTROL_ Procedure 737