KVM: Restore missing powerpc API docs
authorAvi Kivity <avi@redhat.com>
Mon, 29 Aug 2011 13:27:08 +0000 (16:27 +0300)
committerAvi Kivity <avi@redhat.com>
Sun, 25 Sep 2011 16:52:18 +0000 (19:52 +0300)
Commit 371fefd6 lost a doc hunk somehow, restore it.

Signed-off-by: Avi Kivity <avi@redhat.com>
Documentation/virtual/kvm/api.txt

index 75cd8fba0cdef32c9d2300d83b800c6e83cc34ec..2d510b6a649ac78ea8f93853f7cecbd9d8ba08fa 100644 (file)
@@ -200,6 +200,19 @@ allocation of vcpu ids.  For example, if userspace wants
 single-threaded guest vcpus, it should make all vcpu ids be a multiple
 of the number of vcpus per vcore.
 
+On powerpc using book3s_hv mode, the vcpus are mapped onto virtual
+threads in one or more virtual CPU cores.  (This is because the
+hardware requires all the hardware threads in a CPU core to be in the
+same partition.)  The KVM_CAP_PPC_SMT capability indicates the number
+of vcpus per virtual core (vcore).  The vcore id is obtained by
+dividing the vcpu id by the number of vcpus per vcore.  The vcpus in a
+given vcore will always be in the same physical core as each other
+(though that might be a different physical core from time to time).
+Userspace can control the threading (SMT) mode of the guest by its
+allocation of vcpu ids.  For example, if userspace wants
+single-threaded guest vcpus, it should make all vcpu ids be a multiple
+of the number of vcpus per vcore.
+
 4.8 KVM_GET_DIRTY_LOG (vm ioctl)
 
 Capability: basic