hw/cpu/cluster.h

7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * You should have received a copy of the GNU General Public License
29  * A cluster is a group of CPUs which are all identical and have the same view
30  * of the rest of the system. It is mainly an internal QEMU representation and
31  * does not necessarily match with the notion of clusters on the real hardware.
34  * Arm big.LITTLE system) they should be in different clusters. If the CPUs do
35  * not have the same view of memory (for example the main CPU and a management
39  * adding the CPUs to it as QOM child objects (e.g. using the
41  * The CPUs may be either direct children of the cluster object, or indirect
42  * children (e.g. children of children of the cluster object).
44  * All CPUs must be added as children before the cluster is realized.
46  * object and no way for the parent to be notified when a new child is added
47  * to it, so this restriction is not checked for, but the system will not
48  * behave correctly if it is not adhered to. The cluster will assert that
53  * to be in a cluster with all the other "loose" CPUs, so all CPUs that are
61  * This limit is imposed by TCG, which puts the cluster ID into an
62  * 8 bit field (and uses all-1s for the default "not in any cluster").
68  * @cluster_id: The cluster ID. This value is for internal use only and should
69  *   not be exposed directly to the user or to the guest.