[Qemu-devel] [PULL 00/36] spapr-next queue 20150923

[Qemu-devel] [PULL 00/36] spapr-next queue 20150923

[David Gibson]

The following changes since commit 27c7275a56948f48f536e2d1599b22355f5714ac:

  Merge remote-tracking branch 'remotes/kraxel/tags/pull-ipxe-20150903-1' into staging (2015-09-22 19:22:23 +0100)

are available in the git repository at:

  git://github.com/dgibson/qemu.git tags/spapr-next-20150923

for you to fetch changes up to d76548a98f4e18d3c65a3d921bbb70caf9be6138:

  sPAPR: Enable EEH on VFIO PCI device only (2015-09-23 10:51:11 +1000)

Apologies for the breakage in the previous pull request, this should fix it.

----------------------------------------------------------------
sPAPR Patch Queue: 2015-09-23

Highlights:
    * pseries-2.5 machine type
    * Memory hotplug for "pseries" guests
    * Fixes to the PAPR Dynamic Reconfiguration hotplug code
    * Several PAPR compliance fixes
    * New SLOF with:
        * GPT support
        * Much faster VGA handling

----------------------------------------------------------------
Alexey Kardashevskiy (3):
      pseries: Update SLOF firmware image to qemu-slof-20150813
      spapr: Enable in-kernel H_SET_MODE handling
      spapr: Use QEMU limit for maximum CPUs number

Andrew Jones (1):
      spapr: add dumpdtb support

Bharata B Rao (12):
      spapr: Provide an error message when migration fails due to htab_shift mismatch
      spapr_rtas: Prevent QEMU crash during hotplug without a prior device_add
      spapr: Initialize hotplug memory address space
      spapr: Support ibm,dynamic-reconfiguration-memory
      spapr: Make hash table size a factor of maxram_size
      spapr: Memory hotplug support
      spapr: Don't allow memory hotplug to memory less nodes
      spapr: Provide better error message when slots exceed max allowed
      spapr: Populate ibm,associativity-lookup-arrays correctly for non-NUMA
      spapr: Revert to memory@XXXX representation for non-hotplugged memory
      spapr: Support hotplug by specifying DRC count
      spapr: Move memory hotplug to RTAS_LOG_V6_HP_ID_DRC_COUNT type

David Gibson (6):
      spapr: Create pseries-2.5 machine
      spapr_drc: Fix potential undefined behaviour
      pseries: Fix incorrect calculation of threads per socket for chip-id
      spapr: Don't use QOM [*] syntax for DR connectors.
      spapr: Add LMB DR connectors
      spapr: Fix default NUMA node allocation for threads

Gavin Shan (3):
      sPAPR: Introduce rtas_ldq()
      sPAPR: Revert don't enable EEH on emulated PCI devices
      sPAPR: Enable EEH on VFIO PCI device only

Laurent Vivier (1):
      pseries: define coldplugged devices as "configured"

Michael Roth (3):
      spapr_pci: fix device tree props for MSI/MSI-X
      spapr_drc: don't allow 'empty' DRCs to be unisolated or allocated
      spapr_drc: use RTAS return codes for methods called by RTAS

Sam Bobroff (4):
      spapr: Add /ibm,partition-name
      spapr: Add /rtas/ibm,change-msix-capable
      spapr: Make ibm, change-msi respect 3 return values
      spapr: SPLPAR Characteristics

Thomas Huth (3):
      ppc/spapr: Use qemu_log_mask() for hcall_dprintf()
      ppc/spapr: Fix buffer overflow in spapr_populate_drconf_memory()
      ppc/spapr: Implement H_RANDOM hypercall in QEMU

 default-configs/ppc64-softmmu.mak |   1 +
 docs/specs/ppc-spapr-hotplug.txt  |  48 ++++
 hw/ppc/Makefile.objs              |   2 +-
 hw/ppc/spapr.c                    | 483 ++++++++++++++++++++++++++++++++++----
 hw/ppc/spapr_drc.c                |  67 ++++--
 hw/ppc/spapr_events.c             |  51 +++-
 hw/ppc/spapr_hcall.c              |  54 ++++-
 hw/ppc/spapr_pci.c                |  47 ++--
 hw/ppc/spapr_pci_vfio.c           |   2 +-
 hw/ppc/spapr_rng.c                | 186 +++++++++++++++
 hw/ppc/spapr_rtas.c               |  57 +++--
 include/hw/ppc/spapr.h            |  57 ++++-
 include/hw/ppc/spapr_drc.h        |  29 +--
 pc-bios/README                    |   2 +-
 pc-bios/slof.bin                  | Bin 912720 -> 915584 bytes
 roms/SLOF                         |   2 +-
 target-ppc/kvm.c                  |  14 ++
 target-ppc/kvm_ppc.h              |  10 +
 18 files changed, 955 insertions(+), 157 deletions(-)
 create mode 100644 hw/ppc/spapr_rng.c

[Qemu-devel] [PULL 01/36] spapr: Provide an error message when migration fails due to htab_shift mismatch

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Include an error message when migration fails due to mismatch in
htab_shift values at source and target. This should provide a bit more
verbose message in addition to the current migration failure message
that reads like:

qemu-system-ppc64: error while loading state for instance 0x0 of device 'spapr/htab'

After this patch, the failure message will look like this:

qemu-system-ppc64: htab_shift mismatch: source 29 target 24
qemu-system-ppc64: error while loading state for instance 0x0 of device 'spapr/htab'

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 05926a3..dd58eb4 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -1329,6 +1329,8 @@ static int htab_load(QEMUFile *f, void *opaque, int version_id)
     if (section_hdr) {
         /* First section, just the hash shift */
         if (spapr->htab_shift != section_hdr) {
+            error_report("htab_shift mismatch: source %d target %d",
+                         section_hdr, spapr->htab_shift);
             return -EINVAL;
         }
         return 0;
-- 
2.4.3

[Qemu-devel] [PULL 02/36] spapr: Create pseries-2.5 machine

[David Gibson]

Add pseries-2.5 machine version.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
[Altered to merge before memory hotplug -- dwg]
[Altered to work with b9f072d01 -- dwg]
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index dd58eb4..df76cb7 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -1976,7 +1976,7 @@ static void spapr_machine_2_4_class_init(ObjectClass *oc, void *data)
 
     mc->desc = "pSeries Logical Partition (PAPR compliant) v2.4";
     mc->alias = "pseries";
-    mc->is_default = 1;
+    mc->is_default = 0;
 }
 
 static const TypeInfo spapr_machine_2_4_info = {
@@ -1985,6 +1985,22 @@ static const TypeInfo spapr_machine_2_4_info = {
     .class_init    = spapr_machine_2_4_class_init,
 };
 
+static void spapr_machine_2_5_class_init(ObjectClass *oc, void *data)
+{
+    MachineClass *mc = MACHINE_CLASS(oc);
+
+    mc->name = "pseries-2.5";
+    mc->desc = "pSeries Logical Partition (PAPR compliant) v2.5";
+    mc->alias = "pseries";
+    mc->is_default = 1;
+}
+
+static const TypeInfo spapr_machine_2_5_info = {
+    .name          = MACHINE_TYPE_NAME("pseries-2.5"),
+    .parent        = TYPE_SPAPR_MACHINE,
+    .class_init    = spapr_machine_2_5_class_init,
+};
+
 static void spapr_machine_register_types(void)
 {
     type_register_static(&spapr_machine_info);
@@ -1992,6 +2008,7 @@ static void spapr_machine_register_types(void)
     type_register_static(&spapr_machine_2_2_info);
     type_register_static(&spapr_machine_2_3_info);
     type_register_static(&spapr_machine_2_4_info);
+    type_register_static(&spapr_machine_2_5_info);
 }
 
 type_init(spapr_machine_register_types)
-- 
2.4.3

[Qemu-devel] [PULL 03/36] spapr: Add /ibm,partition-name

[David Gibson]

From: Sam Bobroff <sam.bobroff@au1.ibm.com>

QEMU has a notion of the guest name, so if it's present we might as
well put that into the device tree as /ibm,partition-name.

This is specificed by PAPR.

Signed-off-by: Sam Bobroff <sam.bobroff@au1.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index df76cb7..09962c4 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -375,6 +375,11 @@ static void *spapr_create_fdt_skel(hwaddr initrd_base,
     _FDT((fdt_property_string(fdt, "vm,uuid", buf)));
     g_free(buf);
 
+    if (qemu_get_vm_name()) {
+        _FDT((fdt_property_string(fdt, "ibm,partition-name",
+                                  qemu_get_vm_name())));
+    }
+
     _FDT((fdt_property_cell(fdt, "#address-cells", 0x2)));
     _FDT((fdt_property_cell(fdt, "#size-cells", 0x2)));
 
-- 
2.4.3

[Qemu-devel] [PULL 04/36] spapr: Add /rtas/ibm, change-msix-capable

[David Gibson]

From: Sam Bobroff <sam.bobroff@au1.ibm.com>

QEMU is MSI-X capable and makes it available via ibm,change-msi, so
we should indicate this by adding /rtas/ibm,change-msix-capable to the
device tree.

This is specificed by PAPR.

Signed-off-by: Sam Bobroff <sam.bobroff@au1.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 09962c4..ed0abd8 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -432,6 +432,10 @@ static void *spapr_create_fdt_skel(hwaddr initrd_base,
     _FDT((fdt_property_cell(fdt, "rtas-event-scan-rate",
                             RTAS_EVENT_SCAN_RATE)));
 
+    if (msi_supported) {
+        _FDT((fdt_property(fdt, "ibm,change-msix-capable", NULL, 0)));
+    }
+
     /*
      * According to PAPR, rtas ibm,os-term does not guarantee a return
      * back to the guest cpu.
-- 
2.4.3

[Qemu-devel] [PULL 05/36] spapr: Make ibm, change-msi respect 3 return values

[David Gibson]

From: Sam Bobroff <sam.bobroff@au1.ibm.com>

Currently, rtas_ibm_change_msi() always returns four values even if
less are specified.

Correct this by only returning the fourth parameter if it was
requested.

This is specified by PAPR.

Signed-off-by: Sam Bobroff <sam.bobroff@au1.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_pci.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/hw/ppc/spapr_pci.c b/hw/ppc/spapr_pci.c
index a2feb4c..6782fd0 100644
--- a/hw/ppc/spapr_pci.c
+++ b/hw/ppc/spapr_pci.c
@@ -375,7 +375,9 @@ out:
     rtas_st(rets, 0, RTAS_OUT_SUCCESS);
     rtas_st(rets, 1, req_num);
     rtas_st(rets, 2, ++seq_num);
-    rtas_st(rets, 3, ret_intr_type);
+    if (nret > 3) {
+        rtas_st(rets, 3, ret_intr_type);
+    }
 
     trace_spapr_pci_rtas_ibm_change_msi(config_addr, func, req_num, irq);
 }
-- 
2.4.3

[Qemu-devel] [PULL 06/36] spapr: SPLPAR Characteristics

[David Gibson]

From: Sam Bobroff <sam.bobroff@au1.ibm.com>

Improve the SPLPAR Characteristics information:

    Add MaxPlatProcs: set to max_cpus, the maximum CPUs that could be
    addded to the system.
    Add DesMem: set to the initial memory of the system.
    Add DesProcs: set to smp_cpus, the inital number of CPUs in the
    system.

These tokens and values are specified by PAPR.

Signed-off-by: Sam Bobroff <sam.bobroff@au1.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_rtas.c | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/hw/ppc/spapr_rtas.c b/hw/ppc/spapr_rtas.c
index 9869bc9..5cbf9a0 100644
--- a/hw/ppc/spapr_rtas.c
+++ b/hw/ppc/spapr_rtas.c
@@ -34,6 +34,7 @@
 #include "hw/ppc/spapr.h"
 #include "hw/ppc/spapr_vio.h"
 #include "qapi-event.h"
+#include "hw/boards.h"
 
 #include <libfdt.h>
 #include "hw/ppc/spapr_drc.h"
@@ -240,8 +241,14 @@ static void rtas_ibm_get_system_parameter(PowerPCCPU *cpu,
 
     switch (parameter) {
     case RTAS_SYSPARM_SPLPAR_CHARACTERISTICS: {
-        char *param_val = g_strdup_printf("MaxEntCap=%d,MaxPlatProcs=%d",
-                                          max_cpus, smp_cpus);
+        char *param_val = g_strdup_printf("MaxEntCap=%d,"
+                                          "DesMem=%llu,"
+                                          "DesProcs=%d,"
+                                          "MaxPlatProcs=%d",
+                                          max_cpus,
+                                          current_machine->ram_size / M_BYTE,
+                                          smp_cpus,
+                                          max_cpus);
         rtas_st_buffer(buffer, length, (uint8_t *)param_val, strlen(param_val));
         g_free(param_val);
         break;
-- 
2.4.3

[Qemu-devel] [PULL 07/36] spapr: add dumpdtb support

[David Gibson]

From: Andrew Jones <drjones@redhat.com>

dumpdtb (-machine dumpdtb=<file>) allows one to inspect the generated
device tree of machine types that generate device trees. This is
useful for a) seeing what's there b) debugging/testing device tree
generator patches. It can be used as follows

$QEMU_CMDLINE -machine dumpdtb=dtb
dtc -I dtb -O dts dtb

Signed-off-by: Andrew Jones <drjones@redhat.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index ed0abd8..a69d7e4 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -30,6 +30,7 @@
 #include "hw/fw-path-provider.h"
 #include "elf.h"
 #include "net/net.h"
+#include "sysemu/device_tree.h"
 #include "sysemu/block-backend.h"
 #include "sysemu/cpus.h"
 #include "sysemu/kvm.h"
@@ -831,6 +832,7 @@ static void spapr_finalize_fdt(sPAPRMachineState *spapr,
         exit(1);
     }
 
+    qemu_fdt_dumpdtb(fdt, fdt_totalsize(fdt));
     cpu_physical_memory_write(fdt_addr, fdt, fdt_totalsize(fdt));
 
     g_free(bootlist);
-- 
2.4.3

[Qemu-devel] [PULL 08/36] spapr_drc: Fix potential undefined behaviour

[David Gibson]

The DRC_INDEX_ID_MASK macro does a left shift on ~0, which is a signed
quantity, and therefore undefined behaviour according to the C spec.  In
particular this causes warnings from the clang sanitizer.

This fixes it by calculating the same mask without using ~0 (I think the
new method is a more common idiom for generating masks anyway).  For good
measure I also use 1ULL to force the expression's type to unsigned long
long, which should be good for assigning to anything we're going to want
to.

Reported-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Reviewed-by: Alexey Kardashevskiy <aik@ozlabs.ru>
---
 hw/ppc/spapr_drc.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/hw/ppc/spapr_drc.c b/hw/ppc/spapr_drc.c
index ee87432..8cbcf4d 100644
--- a/hw/ppc/spapr_drc.c
+++ b/hw/ppc/spapr_drc.c
@@ -32,7 +32,7 @@
 
 #define DRC_CONTAINER_PATH "/dr-connector"
 #define DRC_INDEX_TYPE_SHIFT 28
-#define DRC_INDEX_ID_MASK (~(~0 << DRC_INDEX_TYPE_SHIFT))
+#define DRC_INDEX_ID_MASK ((1ULL << DRC_INDEX_TYPE_SHIFT) - 1)
 
 static sPAPRDRConnectorTypeShift get_type_shift(sPAPRDRConnectorType type)
 {
-- 
2.4.3

[Qemu-devel] [PULL 09/36] ppc/spapr: Use qemu_log_mask() for hcall_dprintf()

[David Gibson]

From: Thomas Huth <thuth@redhat.com>

To see the output of the hcall_dprintf statements, you currently have
to enable the DEBUG_SPAPR_HCALLS macro in include/hw/ppc/spapr.h.
This is ugly because a) not every user who wants to debug guest
problems can or wants to recompile QEMU to be able to see such issues,
and b) since this macro is disabled by default, the code in the
hcall_dprintf() brackets tends to bitrot until somebody temporarily
enables that macro again.
Since the hcall_dprintf statements except one indicate guest
problems, let's always use qemu_log_mask(LOG_GUEST_ERROR, ...) for
this macro instead. One spot indicated an unimplemented host feature,
so this is changed into qemu_log_mask(LOG_UNIMP, ...) instead. Now
it's possible to see all those messages by simply adding the CLI
parameter "-d guest_errors,unimp", without the need to re-compile
the binary.

Signed-off-by: Thomas Huth <thuth@redhat.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_hcall.c   |  3 ++-
 include/hw/ppc/spapr.h | 11 +++--------
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/hw/ppc/spapr_hcall.c b/hw/ppc/spapr_hcall.c
index 652ddf6..71fc9f2 100644
--- a/hw/ppc/spapr_hcall.c
+++ b/hw/ppc/spapr_hcall.c
@@ -971,7 +971,8 @@ target_ulong spapr_hypercall(PowerPCCPU *cpu, target_ulong opcode,
         }
     }
 
-    hcall_dprintf("Unimplemented hcall 0x" TARGET_FMT_lx "\n", opcode);
+    qemu_log_mask(LOG_UNIMP, "Unimplemented SPAPR hcall 0x" TARGET_FMT_lx "\n",
+                  opcode);
     return H_FUNCTION;
 }
 
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index 91a61ab..d250967 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -353,15 +353,10 @@ typedef struct sPAPRDeviceTreeUpdateHeader {
     uint32_t version_id;
 } sPAPRDeviceTreeUpdateHeader;
 
-/*#define DEBUG_SPAPR_HCALLS*/
-
-#ifdef DEBUG_SPAPR_HCALLS
-#define hcall_dprintf(fmt, ...) \
-    do { fprintf(stderr, "%s: " fmt, __func__, ## __VA_ARGS__); } while (0)
-#else
 #define hcall_dprintf(fmt, ...) \
-    do { } while (0)
-#endif
+    do { \
+        qemu_log_mask(LOG_GUEST_ERROR, "%s: " fmt, __func__, ## __VA_ARGS__); \
+    } while (0)
 
 typedef target_ulong (*spapr_hcall_fn)(PowerPCCPU *cpu, sPAPRMachineState *sm,
                                        target_ulong opcode,
-- 
2.4.3

[Qemu-devel] [PULL 10/36] spapr_rtas: Prevent QEMU crash during hotplug without a prior device_add

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

If drmgr is used in the guest to hotplug a device before a device_add
has been issued via the QEMU monitor, QEMU segfaults in configure_connector
call. This occurs due to accessing of NULL FDT which otherwise would have
been created and associated with the DRC during device_add command.

Check for NULL FDT and return failure from configure_connector call.
As per PAPR+, an error value of -9003 seems appropriate for this failure.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Cc: Michael Roth <mdroth@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_rtas.c        |  6 ++++++
 include/hw/ppc/spapr_drc.h | 15 ++++++++-------
 2 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/hw/ppc/spapr_rtas.c b/hw/ppc/spapr_rtas.c
index 5cbf9a0..2f8e25c 100644
--- a/hw/ppc/spapr_rtas.c
+++ b/hw/ppc/spapr_rtas.c
@@ -522,6 +522,12 @@ static void rtas_ibm_configure_connector(PowerPCCPU *cpu,
 
     drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
     fdt = drck->get_fdt(drc, NULL);
+    if (!fdt) {
+        DPRINTF("rtas_ibm_configure_connector: Missing FDT for DRC index: %xh\n",
+                drc_index);
+        rc = SPAPR_DR_CC_RESPONSE_NOT_CONFIGURABLE;
+        goto out;
+    }
 
     ccs = spapr_ccs_find(spapr, drc_index);
     if (!ccs) {
diff --git a/include/hw/ppc/spapr_drc.h b/include/hw/ppc/spapr_drc.h
index 60cda35..28ffeae 100644
--- a/include/hw/ppc/spapr_drc.h
+++ b/include/hw/ppc/spapr_drc.h
@@ -119,13 +119,14 @@ typedef enum {
 } sPAPRDREntitySense;
 
 typedef enum {
-    SPAPR_DR_CC_RESPONSE_NEXT_SIB       = 1, /* currently unused */
-    SPAPR_DR_CC_RESPONSE_NEXT_CHILD     = 2,
-    SPAPR_DR_CC_RESPONSE_NEXT_PROPERTY  = 3,
-    SPAPR_DR_CC_RESPONSE_PREV_PARENT    = 4,
-    SPAPR_DR_CC_RESPONSE_SUCCESS        = 0,
-    SPAPR_DR_CC_RESPONSE_ERROR          = -1,
-    SPAPR_DR_CC_RESPONSE_CONTINUE       = -2,
+    SPAPR_DR_CC_RESPONSE_NEXT_SIB         = 1, /* currently unused */
+    SPAPR_DR_CC_RESPONSE_NEXT_CHILD       = 2,
+    SPAPR_DR_CC_RESPONSE_NEXT_PROPERTY    = 3,
+    SPAPR_DR_CC_RESPONSE_PREV_PARENT      = 4,
+    SPAPR_DR_CC_RESPONSE_SUCCESS          = 0,
+    SPAPR_DR_CC_RESPONSE_ERROR            = -1,
+    SPAPR_DR_CC_RESPONSE_CONTINUE         = -2,
+    SPAPR_DR_CC_RESPONSE_NOT_CONFIGURABLE = -9003,
 } sPAPRDRCCResponse;
 
 typedef void (spapr_drc_detach_cb)(DeviceState *d, void *opaque);
-- 
2.4.3

[Qemu-devel] [PULL 11/36] sPAPR: Introduce rtas_ldq()

[David Gibson]

From: Gavin Shan <gwshan@linux.vnet.ibm.com>

This introduces rtas_ldq() to load 64-bits parameter from continuous
two 4-bytes memory chunk of RTAS parameter buffer, to simplify the
code.

Signed-off-by: Gavin Shan <gwshan@linux.vnet.ibm.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_pci.c     | 20 ++++++++++----------
 include/hw/ppc/spapr.h |  5 +++++
 2 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/hw/ppc/spapr_pci.c b/hw/ppc/spapr_pci.c
index 6782fd0..54292c9 100644
--- a/hw/ppc/spapr_pci.c
+++ b/hw/ppc/spapr_pci.c
@@ -140,7 +140,7 @@ static void rtas_ibm_read_pci_config(PowerPCCPU *cpu, sPAPRMachineState *spapr,
         return;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     size = rtas_ld(args, 3);
     addr = rtas_ld(args, 0);
 
@@ -206,7 +206,7 @@ static void rtas_ibm_write_pci_config(PowerPCCPU *cpu, sPAPRMachineState *spapr,
         return;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     val = rtas_ld(args, 4);
     size = rtas_ld(args, 3);
     addr = rtas_ld(args, 0);
@@ -269,7 +269,7 @@ static void rtas_ibm_change_msi(PowerPCCPU *cpu, sPAPRMachineState *spapr,
                                 target_ulong rets)
 {
     uint32_t config_addr = rtas_ld(args, 0);
-    uint64_t buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    uint64_t buid = rtas_ldq(args, 1);
     unsigned int func = rtas_ld(args, 3);
     unsigned int req_num = rtas_ld(args, 4); /* 0 == remove all */
     unsigned int seq_num = rtas_ld(args, 5);
@@ -391,7 +391,7 @@ static void rtas_ibm_query_interrupt_source_number(PowerPCCPU *cpu,
                                                    target_ulong rets)
 {
     uint32_t config_addr = rtas_ld(args, 0);
-    uint64_t buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    uint64_t buid = rtas_ldq(args, 1);
     unsigned int intr_src_num = -1, ioa_intr_num = rtas_ld(args, 3);
     sPAPRPHBState *phb = NULL;
     PCIDevice *pdev = NULL;
@@ -440,7 +440,7 @@ static void rtas_ibm_set_eeh_option(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     addr = rtas_ld(args, 0);
     option = rtas_ld(args, 3);
 
@@ -484,7 +484,7 @@ static void rtas_ibm_get_config_addr_info2(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     sphb = spapr_pci_find_phb(spapr, buid);
     if (!sphb) {
         goto param_error_exit;
@@ -539,7 +539,7 @@ static void rtas_ibm_read_slot_reset_state2(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     sphb = spapr_pci_find_phb(spapr, buid);
     if (!sphb) {
         goto param_error_exit;
@@ -584,7 +584,7 @@ static void rtas_ibm_set_slot_reset(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     option = rtas_ld(args, 3);
     sphb = spapr_pci_find_phb(spapr, buid);
     if (!sphb) {
@@ -619,7 +619,7 @@ static void rtas_ibm_configure_pe(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     sphb = spapr_pci_find_phb(spapr, buid);
     if (!sphb) {
         goto param_error_exit;
@@ -654,7 +654,7 @@ static void rtas_ibm_slot_error_detail(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    buid = ((uint64_t)rtas_ld(args, 1) << 32) | rtas_ld(args, 2);
+    buid = rtas_ldq(args, 1);
     sphb = spapr_pci_find_phb(spapr, buid);
     if (!sphb) {
         goto param_error_exit;
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index d250967..cbe3463 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -489,6 +489,11 @@ static inline uint32_t rtas_ld(target_ulong phys, int n)
     return ldl_be_phys(&address_space_memory, ppc64_phys_to_real(phys + 4*n));
 }
 
+static inline uint64_t rtas_ldq(target_ulong phys, int n)
+{
+    return (uint64_t)rtas_ld(phys, n) << 32 | rtas_ld(phys, n + 1);
+}
+
 static inline void rtas_st(target_ulong phys, int n, uint32_t val)
 {
     stl_be_phys(&address_space_memory, ppc64_phys_to_real(phys + 4*n), val);
-- 
2.4.3

[Qemu-devel] [PULL 12/36] pseries: define coldplugged devices as "configured"

[David Gibson]

From: Laurent Vivier <lvivier@redhat.com>

When a device is hotplugged, attach() sets "configured" to
false, waiting an action from the OS to configure it and then
to call ibm,configure-connector. On ibm,configure-connector,
the hypervisor sets "configured" to true.

In case of coldplugged device, attach() sets "configured" to
false, but firmware and OS never call the ibm,configure-connector
in this case, so it remains set to false.

It could be harmless, but when we unplug a device, hypervisor
waits the device becomes configured because for it, a not configured
device is a device being configured, so it waits the end of configuration
to unplug it... and it never happens, so it is never unplugged.

This patch set by default coldplugged device to "configured=true",
hotplugged device to "configured=false".

Signed-off-by: Laurent Vivier <lvivier@redhat.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_drc.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/hw/ppc/spapr_drc.c b/hw/ppc/spapr_drc.c
index 8cbcf4d..9ce844a 100644
--- a/hw/ppc/spapr_drc.c
+++ b/hw/ppc/spapr_drc.c
@@ -310,7 +310,7 @@ static void attach(sPAPRDRConnector *drc, DeviceState *d, void *fdt,
     drc->dev = d;
     drc->fdt = fdt;
     drc->fdt_start_offset = fdt_start_offset;
-    drc->configured = false;
+    drc->configured = coldplug;
 
     object_property_add_link(OBJECT(drc), "device",
                              object_get_typename(OBJECT(drc->dev)),
-- 
2.4.3

[Qemu-devel] [PULL 13/36] pseries: Update SLOF firmware image to qemu-slof-20150813

[David Gibson]

From: Alexey Kardashevskiy <aik@ozlabs.ru>

The changes are:
1. GPT support;
2. Much faster VGA support.

The full changelog is:
  > Add missing half word access case to _FASTRMOVE and _FASTMOVE
  > Remove unused RMOVE64 stub
  > fbuffer: Implement RFILL as an accelerated primitive
  > fbuffer: Implement MRMOVE as an accelerated primitive
  > fbuffer: Precalculate line length in bytes
  > terminal: Disable the terminal-write trace by default
  > boot: remove trailing ":" in the bootpath
  > ci: implement boot client interface
  > boot: bootpath should be complete device path
  > fbuffer: Use a smaller cursor
  > fbuffer: Improve invert-region helper
  > usb-hid: Caps is not always shift
  > cas: Increase FDT buffer size to accomodate larger ibm, cas node properties
  > README: Update with patch submittion note
  > disk-label: add support for booting from GPT FAT partition
  > disk-label: introduce helper to check fat filesystem
  > introduce 8-byte LE helpers
  > disk-label: simplify gpt-prep-partition? routine
  > fbuffer: introduce the invert-region-x helper
  > fbuffer: introduce the invert-region helper
  > fbuffer: simplify address computations in fb8-toggle-cursor

Signed-off-by: Alexey Kardashevskiy <aik@ozlabs.ru>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 pc-bios/README   |   2 +-
 pc-bios/slof.bin | Bin 912720 -> 915584 bytes
 roms/SLOF        |   2 +-
 3 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/pc-bios/README b/pc-bios/README
index 05cf042..e4154ab 100644
--- a/pc-bios/README
+++ b/pc-bios/README
@@ -17,7 +17,7 @@
 - SLOF (Slimline Open Firmware) is a free IEEE 1275 Open Firmware
   implementation for certain IBM POWER hardware.  The sources are at
   https://github.com/aik/SLOF, and the image currently in qemu is
-  built from git tag qemu-slof-20150429.
+  built from git tag qemu-slof-20150813.
 
 - sgabios (the Serial Graphics Adapter option ROM) provides a means for
   legacy x86 software to communicate with an attached serial console as
diff --git a/pc-bios/slof.bin b/pc-bios/slof.bin
index 0398ac67bc8d07410fe2ccc9d62c376ef3cf87c3..701933f7dc7b20f6cfcbb538a95142d0a598ada8 100644
GIT binary patch
delta 165318
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

delta 163955
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
XeDaqAj_$**y?;P!-`)4GKjQxb%CXf`

diff --git a/roms/SLOF b/roms/SLOF
index 7d766a3..811277a 160000
--- a/roms/SLOF
+++ b/roms/SLOF
@@ -1 +1 @@
-Subproject commit 7d766a3ac9b2474f6c7da0084d43590cbbf047bf
+Subproject commit 811277ac91f674a9273e2b529791e9b75350f3e8
-- 
2.4.3

[Qemu-devel] [PULL 14/36] pseries: Fix incorrect calculation of threads per socket for chip-id

[David Gibson]

The device tree presented to pseries machine type guests includes an
ibm,chip-id property which gives essentially the socket number of each
vcpu core (individual vcpu threads don't get a node in the device
tree).

To calculate this, it uses a vcpus_per_socket variable computed as
(smp_cpus / #sockets).  This is correct for the usual case where
smp_cpus == smp_threads * smp_cores * #sockets.

However, you can start QEMU with the number of cores and threads
mismatching the total number of vcpus (whether that _should_ be
permitted is a topic for another day).  It's a bit hard to say what
the "real" number of vcpus per socket here is, but for most purposes
(smp_threads * smp_cores) will more meaningfully match how QEMU
behaves with respect to socket boundaries.

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Reviewed-by: Alexey Kardashevskiy <aik@ozlabs.ru>
---
 hw/ppc/spapr.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index a69d7e4..ac0d2fe 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -630,9 +630,7 @@ static void spapr_populate_cpu_dt(CPUState *cs, void *fdt, int offset,
     uint32_t cpufreq = kvm_enabled() ? kvmppc_get_clockfreq() : 1000000000;
     uint32_t page_sizes_prop[64];
     size_t page_sizes_prop_size;
-    QemuOpts *opts = qemu_opts_find(qemu_find_opts("smp-opts"), NULL);
-    unsigned sockets = opts ? qemu_opt_get_number(opts, "sockets", 0) : 0;
-    uint32_t cpus_per_socket = sockets ? (smp_cpus / sockets) : 1;
+    uint32_t vcpus_per_socket = smp_threads * smp_cores;
     uint32_t pft_size_prop[] = {0, cpu_to_be32(spapr->htab_shift)};
 
     _FDT((fdt_setprop_cell(fdt, offset, "reg", index)));
@@ -701,7 +699,7 @@ static void spapr_populate_cpu_dt(CPUState *cs, void *fdt, int offset,
     }
 
     _FDT((fdt_setprop_cell(fdt, offset, "ibm,chip-id",
-                           cs->cpu_index / cpus_per_socket)));
+                           cs->cpu_index / vcpus_per_socket)));
 
     _FDT((fdt_setprop(fdt, offset, "ibm,pft-size",
                       pft_size_prop, sizeof(pft_size_prop))));
-- 
2.4.3

[Qemu-devel] [PULL 15/36] spapr: Enable in-kernel H_SET_MODE handling

[David Gibson]

From: Alexey Kardashevskiy <aik@ozlabs.ru>

For setting debug watchpoints, sPAPR guests use H_SET_MODE hypercall.
The existing QEMU H_SET_MODE handler does not support this but
the KVM handler in HV KVM does. However it is not enabled.

This enables the in-kernel H_SET_MODE handler which handles:
- Completed Instruction Address Breakpoint Register
- Watch point 0 registers.

The rest is still handled in QEMU.

Reported-by: Anton Blanchard <anton@samba.org>
Signed-off-by: Alexey Kardashevskiy <aik@ozlabs.ru>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c       | 1 +
 target-ppc/kvm.c     | 5 +++++
 target-ppc/kvm_ppc.h | 5 +++++
 3 files changed, 11 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index ac0d2fe..d49f322 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -1546,6 +1546,7 @@ static void ppc_spapr_init(MachineState *machine)
     if (kvm_enabled()) {
         /* Enable H_LOGICAL_CI_* so SLOF can talk to in-kernel devices */
         kvmppc_enable_logical_ci_hcalls();
+        kvmppc_enable_set_mode_hcall();
     }
 
     /* allocate RAM */
diff --git a/target-ppc/kvm.c b/target-ppc/kvm.c
index 110436d..9cf5308 100644
--- a/target-ppc/kvm.c
+++ b/target-ppc/kvm.c
@@ -1953,6 +1953,11 @@ void kvmppc_enable_logical_ci_hcalls(void)
     kvmppc_enable_hcall(kvm_state, H_LOGICAL_CI_STORE);
 }
 
+void kvmppc_enable_set_mode_hcall(void)
+{
+    kvmppc_enable_hcall(kvm_state, H_SET_MODE);
+}
+
 void kvmppc_set_papr(PowerPCCPU *cpu)
 {
     CPUState *cs = CPU(cpu);
diff --git a/target-ppc/kvm_ppc.h b/target-ppc/kvm_ppc.h
index 5c1d334..f790d50 100644
--- a/target-ppc/kvm_ppc.h
+++ b/target-ppc/kvm_ppc.h
@@ -23,6 +23,7 @@ int kvmppc_get_hasidle(CPUPPCState *env);
 int kvmppc_get_hypercall(CPUPPCState *env, uint8_t *buf, int buf_len);
 int kvmppc_set_interrupt(PowerPCCPU *cpu, int irq, int level);
 void kvmppc_enable_logical_ci_hcalls(void);
+void kvmppc_enable_set_mode_hcall(void);
 void kvmppc_set_papr(PowerPCCPU *cpu);
 int kvmppc_set_compat(PowerPCCPU *cpu, uint32_t cpu_version);
 void kvmppc_set_mpic_proxy(PowerPCCPU *cpu, int mpic_proxy);
@@ -110,6 +111,10 @@ static inline void kvmppc_enable_logical_ci_hcalls(void)
 {
 }
 
+static inline void kvmppc_enable_set_mode_hcall(void)
+{
+}
+
 static inline void kvmppc_set_papr(PowerPCCPU *cpu)
 {
 }
-- 
2.4.3

[Qemu-devel] [PULL 16/36] spapr_pci: fix device tree props for MSI/MSI-X

[David Gibson]

From: Michael Roth <mdroth@linux.vnet.ibm.com>

PAPR requires ibm,req#msi and ibm,req#msi-x to be present in the
device node to define the number of msi/msi-x interrupts the device
supports, respectively.

Currently we have ibm,req#msi-x hardcoded to a non-sensical constant
that happens to be 2, and are missing ibm,req#msi entirely. The result
of that is that msi-x capable devices get limited to 2 msi-x
interrupts (which can impact performance), and msi-only devices likely
wouldn't work at all. Additionally, if devices expect a minimum that
exceeds 2, the guest driver may fail to load entirely.

SLOF still owns the generation of these properties at boot-time
(although other device properties have since been offloaded to QEMU),
but for hotplugged devices we rely on the values generated by QEMU
and thus hit the limitations above.

Fix this by generating these properties in QEMU as expected by guests.

In the future it may make sense to modify SLOF to pass through these
values directly as we do with other props since we're duplicating SLOF
code.

Cc: qemu-ppc@nongnu.org
Cc: qemu-stable@nongnu.org
Cc: David Gibson <david@gibson.dropbear.id.au>
Cc: Nikunj A Dadhania <nikunj@linux.vnet.ibm.com>
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_pci.c | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/hw/ppc/spapr_pci.c b/hw/ppc/spapr_pci.c
index 54292c9..d2188c8 100644
--- a/hw/ppc/spapr_pci.c
+++ b/hw/ppc/spapr_pci.c
@@ -957,6 +957,7 @@ static int spapr_populate_pci_child_dt(PCIDevice *dev, void *fdt, int offset,
     int pci_status, err;
     char *buf = NULL;
     uint32_t drc_index = spapr_phb_get_pci_drc_index(sphb, dev);
+    uint32_t max_msi, max_msix;
 
     if (pci_default_read_config(dev, PCI_HEADER_TYPE, 1) ==
         PCI_HEADER_TYPE_BRIDGE) {
@@ -1037,8 +1038,15 @@ static int spapr_populate_pci_child_dt(PCIDevice *dev, void *fdt, int offset,
                           RESOURCE_CELLS_ADDRESS));
     _FDT(fdt_setprop_cell(fdt, offset, "#size-cells",
                           RESOURCE_CELLS_SIZE));
-    _FDT(fdt_setprop_cell(fdt, offset, "ibm,req#msi-x",
-                          RESOURCE_CELLS_SIZE));
+
+    max_msi = msi_nr_vectors_allocated(dev);
+    if (max_msi) {
+        _FDT(fdt_setprop_cell(fdt, offset, "ibm,req#msi", max_msi));
+    }
+    max_msix = dev->msix_entries_nr;
+    if (max_msix) {
+        _FDT(fdt_setprop_cell(fdt, offset, "ibm,req#msi-x", max_msix));
+    }
 
     populate_resource_props(dev, &rp);
     _FDT(fdt_setprop(fdt, offset, "reg", (uint8_t *)rp.reg, rp.reg_len));
-- 
2.4.3

[Qemu-devel] [PULL 17/36] spapr_drc: don't allow 'empty' DRCs to be unisolated or allocated

[David Gibson]

From: Michael Roth <mdroth@linux.vnet.ibm.com>

Logical resources start with allocation-state:UNUSABLE /
isolation-state:ISOLATED. During hotplug, guests will transition
them to allocation-state:USABLE, and then to
isolation-state:UNISOLATED.

For cases where we cannot transition to allocation-state:USABLE,
in this case due to no device/resource being association with
the logical DRC, we should return an error -3.

For physical DRCs, we default to allocation-state:USABLE and stay
there, so in this case we should report an error -3 when the guest
attempts to make the isolation-state:ISOLATED transition for a DRC
with no device associated.

These are as documented in PAPR 2.7, 13.5.3.4.

We also ensure allocation-state:USABLE when the guest attempts
transition to isolation-state:UNISOLATED to deal with misbehaving
guests attempting to bring online an unallocated logical resource.

This is as documented in PAPR 2.7, 13.7.

Currently we implement no such error logic. Fix this by handling
these error cases as PAPR defines.

Cc: Bharata B Rao <bharata@linux.vnet.ibm.com>
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_drc.c     | 21 +++++++++++++++++++++
 include/hw/ppc/spapr.h |  1 +
 2 files changed, 22 insertions(+)

diff --git a/hw/ppc/spapr_drc.c b/hw/ppc/spapr_drc.c
index 9ce844a..faf8760 100644
--- a/hw/ppc/spapr_drc.c
+++ b/hw/ppc/spapr_drc.c
@@ -66,6 +66,16 @@ static int set_isolation_state(sPAPRDRConnector *drc,
 
     DPRINTFN("drc: %x, set_isolation_state: %x", get_index(drc), state);
 
+    if (state == SPAPR_DR_ISOLATION_STATE_UNISOLATED) {
+        /* cannot unisolate a non-existant resource, and, or resources
+         * which are in an 'UNUSABLE' allocation state. (PAPR 2.7, 13.5.3.5)
+         */
+        if (!drc->dev ||
+            drc->allocation_state == SPAPR_DR_ALLOCATION_STATE_UNUSABLE) {
+            return RTAS_OUT_NO_SUCH_INDICATOR;
+        }
+    }
+
     drc->isolation_state = state;
 
     if (drc->isolation_state == SPAPR_DR_ISOLATION_STATE_ISOLATED) {
@@ -107,6 +117,17 @@ static int set_allocation_state(sPAPRDRConnector *drc,
 
     DPRINTFN("drc: %x, set_allocation_state: %x", get_index(drc), state);
 
+    if (state == SPAPR_DR_ALLOCATION_STATE_USABLE) {
+        /* if there's no resource/device associated with the DRC, there's
+         * no way for us to put it in an allocation state consistent with
+         * being 'USABLE'. PAPR 2.7, 13.5.3.4 documents that this should
+         * result in an RTAS return code of -3 / "no such indicator"
+         */
+        if (!drc->dev) {
+            return RTAS_OUT_NO_SUCH_INDICATOR;
+        }
+    }
+
     if (drc->type != SPAPR_DR_CONNECTOR_TYPE_PCI) {
         drc->allocation_state = state;
         if (drc->awaiting_release &&
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index cbe3463..8a0a74d 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -409,6 +409,7 @@ int spapr_allocate_irq_block(int num, bool lsi, bool msi);
 #define RTAS_OUT_BUSY               -2
 #define RTAS_OUT_PARAM_ERROR        -3
 #define RTAS_OUT_NOT_SUPPORTED      -3
+#define RTAS_OUT_NO_SUCH_INDICATOR  -3
 #define RTAS_OUT_NOT_AUTHORIZED     -9002
 
 /* RTAS tokens */
-- 
2.4.3

[Qemu-devel] [PULL 18/36] spapr: Initialize hotplug memory address space

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Initialize a hotplug memory region under which all the hotplugged
memory is accommodated. Also enable memory hotplug by setting
CONFIG_MEM_HOTPLUG.

Modelled on i386 memory hotplug.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 default-configs/ppc64-softmmu.mak |  1 +
 hw/ppc/spapr.c                    | 18 ++++++++++++++++++
 include/hw/ppc/spapr.h            | 12 ++++++++++++
 3 files changed, 31 insertions(+)

diff --git a/default-configs/ppc64-softmmu.mak b/default-configs/ppc64-softmmu.mak
index ab62cc7..e77cb1a 100644
--- a/default-configs/ppc64-softmmu.mak
+++ b/default-configs/ppc64-softmmu.mak
@@ -52,3 +52,4 @@ CONFIG_XICS_KVM=$(and $(CONFIG_PSERIES),$(CONFIG_KVM))
 # For PReP
 CONFIG_MC146818RTC=y
 CONFIG_ISA_TESTDEV=y
+CONFIG_MEM_HOTPLUG=y
diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index d49f322..2fb5e36 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -1562,6 +1562,24 @@ static void ppc_spapr_init(MachineState *machine)
         memory_region_add_subregion(sysmem, 0, rma_region);
     }
 
+    /* initialize hotplug memory address space */
+    if (machine->ram_size < machine->maxram_size) {
+        ram_addr_t hotplug_mem_size = machine->maxram_size - machine->ram_size;
+
+        if (machine->ram_slots > SPAPR_MAX_RAM_SLOTS) {
+            error_report("unsupported amount of memory slots: %"PRIu64,
+                          machine->ram_slots);
+            exit(EXIT_FAILURE);
+        }
+
+        spapr->hotplug_memory.base = ROUND_UP(machine->ram_size,
+                                              SPAPR_HOTPLUG_MEM_ALIGN);
+        memory_region_init(&spapr->hotplug_memory.mr, OBJECT(spapr),
+                           "hotplug-memory", hotplug_mem_size);
+        memory_region_add_subregion(sysmem, spapr->hotplug_memory.base,
+                                    &spapr->hotplug_memory.mr);
+    }
+
     filename = qemu_find_file(QEMU_FILE_TYPE_BIOS, "spapr-rtas.bin");
     if (!filename) {
         error_report("Could not find LPAR rtas '%s'", "spapr-rtas.bin");
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index 8a0a74d..e882770 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -5,6 +5,7 @@
 #include "hw/boards.h"
 #include "hw/ppc/xics.h"
 #include "hw/ppc/spapr_drc.h"
+#include "hw/mem/pc-dimm.h"
 
 struct VIOsPAPRBus;
 struct sPAPRPHBState;
@@ -76,6 +77,7 @@ struct sPAPRMachineState {
 
     /*< public >*/
     char *kvm_type;
+    MemoryHotplugState hotplug_memory;
 };
 
 #define H_SUCCESS         0
@@ -610,4 +612,14 @@ int spapr_rtc_import_offset(DeviceState *dev, int64_t legacy_offset);
 
 #define SPAPR_MEMORY_BLOCK_SIZE (1 << 28) /* 256MB */
 
+/*
+ * This defines the maximum number of DIMM slots we can have for sPAPR
+ * guest. This is not defined by sPAPR but we are defining it to 32 slots
+ * based on default number of slots provided by PowerPC kernel.
+ */
+#define SPAPR_MAX_RAM_SLOTS     32
+
+/* 1GB alignment for hotplug memory region */
+#define SPAPR_HOTPLUG_MEM_ALIGN (1ULL << 30)
+
 #endif /* !defined (__HW_SPAPR_H__) */
-- 
2.4.3

[Qemu-devel] [PULL 19/36] spapr_drc: use RTAS return codes for methods called by RTAS

[David Gibson]

From: Michael Roth <mdroth@linux.vnet.ibm.com>

Certain methods in sPAPRDRConnector objects are only ever called by
RTAS and in many cases are responsible for the logic that determines
the RTAS return codes.

Rather than having a level of indirection requiring RTAS code to
re-interpret return values from such methods to determine the
appropriate return code, just pass them through directly.

This requires changing method return types to uint32_t to match the
type of values currently passed to RTAS helpers.

In the case of read accesses like drc->entity_sense() where we weren't
previously reporting any errors, just the read value, we modify the
function to return RTAS return code, and pass the read value back via
reference.

Suggested-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Suggested-by: David Gibson <david@gibson.dropbear.id.au>
Cc: Bharata B Rao <bharata@linux.vnet.ibm.com>
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_drc.c         | 37 +++++++++++++++++++------------------
 hw/ppc/spapr_rtas.c        | 40 ++++++++++++++++++++++------------------
 include/hw/ppc/spapr_drc.h | 14 +++++++-------
 3 files changed, 48 insertions(+), 43 deletions(-)

diff --git a/hw/ppc/spapr_drc.c b/hw/ppc/spapr_drc.c
index faf8760..b7b9891 100644
--- a/hw/ppc/spapr_drc.c
+++ b/hw/ppc/spapr_drc.c
@@ -15,6 +15,7 @@
 #include "hw/qdev.h"
 #include "qapi/visitor.h"
 #include "qemu/error-report.h"
+#include "hw/ppc/spapr.h" /* for RTAS return codes */
 
 /* #define DEBUG_SPAPR_DRC */
 
@@ -59,8 +60,8 @@ static uint32_t get_index(sPAPRDRConnector *drc)
             (drc->id & DRC_INDEX_ID_MASK);
 }
 
-static int set_isolation_state(sPAPRDRConnector *drc,
-                               sPAPRDRIsolationState state)
+static uint32_t set_isolation_state(sPAPRDRConnector *drc,
+                                    sPAPRDRIsolationState state)
 {
     sPAPRDRConnectorClass *drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
 
@@ -99,19 +100,19 @@ static int set_isolation_state(sPAPRDRConnector *drc,
         drc->configured = false;
     }
 
-    return 0;
+    return RTAS_OUT_SUCCESS;
 }
 
-static int set_indicator_state(sPAPRDRConnector *drc,
-                               sPAPRDRIndicatorState state)
+static uint32_t set_indicator_state(sPAPRDRConnector *drc,
+                                    sPAPRDRIndicatorState state)
 {
     DPRINTFN("drc: %x, set_indicator_state: %x", get_index(drc), state);
     drc->indicator_state = state;
-    return 0;
+    return RTAS_OUT_SUCCESS;
 }
 
-static int set_allocation_state(sPAPRDRConnector *drc,
-                                sPAPRDRAllocationState state)
+static uint32_t set_allocation_state(sPAPRDRConnector *drc,
+                                     sPAPRDRAllocationState state)
 {
     sPAPRDRConnectorClass *drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
 
@@ -137,7 +138,7 @@ static int set_allocation_state(sPAPRDRConnector *drc,
                          drc->detach_cb_opaque, NULL);
         }
     }
-    return 0;
+    return RTAS_OUT_SUCCESS;
 }
 
 static uint32_t get_type(sPAPRDRConnector *drc)
@@ -178,10 +179,8 @@ static void set_configured(sPAPRDRConnector *drc)
  * based on the current allocation/indicator/power states
  * for the DR connector.
  */
-static sPAPRDREntitySense entity_sense(sPAPRDRConnector *drc)
+static uint32_t entity_sense(sPAPRDRConnector *drc, sPAPRDREntitySense *state)
 {
-    sPAPRDREntitySense state;
-
     if (drc->dev) {
         if (drc->type != SPAPR_DR_CONNECTOR_TYPE_PCI &&
             drc->allocation_state == SPAPR_DR_ALLOCATION_STATE_UNUSABLE) {
@@ -190,7 +189,7 @@ static sPAPRDREntitySense entity_sense(sPAPRDRConnector *drc)
              * Otherwise, report the state as USABLE/PRESENT,
              * as we would for PCI.
              */
-            state = SPAPR_DR_ENTITY_SENSE_UNUSABLE;
+            *state = SPAPR_DR_ENTITY_SENSE_UNUSABLE;
         } else {
             /* this assumes all PCI devices are assigned to
              * a 'live insertion' power domain, where QEMU
@@ -198,21 +197,21 @@ static sPAPRDREntitySense entity_sense(sPAPRDRConnector *drc)
              * to the guest. present, non-PCI resources are
              * unaffected by power state.
              */
-            state = SPAPR_DR_ENTITY_SENSE_PRESENT;
+            *state = SPAPR_DR_ENTITY_SENSE_PRESENT;
         }
     } else {
         if (drc->type == SPAPR_DR_CONNECTOR_TYPE_PCI) {
             /* PCI devices, and only PCI devices, use EMPTY
              * in cases where we'd otherwise use UNUSABLE
              */
-            state = SPAPR_DR_ENTITY_SENSE_EMPTY;
+            *state = SPAPR_DR_ENTITY_SENSE_EMPTY;
         } else {
-            state = SPAPR_DR_ENTITY_SENSE_UNUSABLE;
+            *state = SPAPR_DR_ENTITY_SENSE_UNUSABLE;
         }
     }
 
     DPRINTFN("drc: %x, entity_sense: %x", get_index(drc), state);
-    return state;
+    return RTAS_OUT_SUCCESS;
 }
 
 static void prop_get_index(Object *obj, Visitor *v, void *opaque,
@@ -245,7 +244,9 @@ static void prop_get_entity_sense(Object *obj, Visitor *v, void *opaque,
 {
     sPAPRDRConnector *drc = SPAPR_DR_CONNECTOR(obj);
     sPAPRDRConnectorClass *drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
-    uint32_t value = (uint32_t)drck->entity_sense(drc);
+    uint32_t value;
+
+    drck->entity_sense(drc, &value);
     visit_type_uint32(v, &value, name, errp);
 }
 
diff --git a/hw/ppc/spapr_rtas.c b/hw/ppc/spapr_rtas.c
index 2f8e25c..34b12a3 100644
--- a/hw/ppc/spapr_rtas.c
+++ b/hw/ppc/spapr_rtas.c
@@ -372,12 +372,13 @@ static void rtas_set_indicator(PowerPCCPU *cpu, sPAPRMachineState *spapr,
     uint32_t sensor_type;
     uint32_t sensor_index;
     uint32_t sensor_state;
+    uint32_t ret = RTAS_OUT_SUCCESS;
     sPAPRDRConnector *drc;
     sPAPRDRConnectorClass *drck;
 
     if (nargs != 3 || nret != 1) {
-        rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
-        return;
+        ret = RTAS_OUT_PARAM_ERROR;
+        goto out;
     }
 
     sensor_type = rtas_ld(args, 0);
@@ -393,8 +394,8 @@ static void rtas_set_indicator(PowerPCCPU *cpu, sPAPRMachineState *spapr,
     if (!drc) {
         DPRINTF("rtas_set_indicator: invalid sensor/DRC index: %xh\n",
                 sensor_index);
-        rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
-        return;
+        ret = RTAS_OUT_PARAM_ERROR;
+        goto out;
     }
     drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
 
@@ -413,19 +414,20 @@ static void rtas_set_indicator(PowerPCCPU *cpu, sPAPRMachineState *spapr,
                 spapr_ccs_remove(spapr, ccs);
             }
         }
-        drck->set_isolation_state(drc, sensor_state);
+        ret = drck->set_isolation_state(drc, sensor_state);
         break;
     case RTAS_SENSOR_TYPE_DR:
-        drck->set_indicator_state(drc, sensor_state);
+        ret = drck->set_indicator_state(drc, sensor_state);
         break;
     case RTAS_SENSOR_TYPE_ALLOCATION_STATE:
-        drck->set_allocation_state(drc, sensor_state);
+        ret = drck->set_allocation_state(drc, sensor_state);
         break;
     default:
         goto out_unimplemented;
     }
 
-    rtas_st(rets, 0, RTAS_OUT_SUCCESS);
+out:
+    rtas_st(rets, 0, ret);
     return;
 
 out_unimplemented:
@@ -442,13 +444,14 @@ static void rtas_get_sensor_state(PowerPCCPU *cpu, sPAPRMachineState *spapr,
 {
     uint32_t sensor_type;
     uint32_t sensor_index;
+    uint32_t sensor_state = 0;
     sPAPRDRConnector *drc;
     sPAPRDRConnectorClass *drck;
-    uint32_t entity_sense;
+    uint32_t ret = RTAS_OUT_SUCCESS;
 
     if (nargs != 2 || nret != 2) {
-        rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
-        return;
+        ret = RTAS_OUT_PARAM_ERROR;
+        goto out;
     }
 
     sensor_type = rtas_ld(args, 0);
@@ -458,22 +461,23 @@ static void rtas_get_sensor_state(PowerPCCPU *cpu, sPAPRMachineState *spapr,
         /* currently only DR-related sensors are implemented */
         DPRINTF("rtas_get_sensor_state: sensor/indicator not implemented: %d\n",
                 sensor_type);
-        rtas_st(rets, 0, RTAS_OUT_NOT_SUPPORTED);
-        return;
+        ret = RTAS_OUT_NOT_SUPPORTED;
+        goto out;
     }
 
     drc = spapr_dr_connector_by_index(sensor_index);
     if (!drc) {
         DPRINTF("rtas_get_sensor_state: invalid sensor/DRC index: %xh\n",
                 sensor_index);
-        rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
-        return;
+        ret = RTAS_OUT_PARAM_ERROR;
+        goto out;
     }
     drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
-    entity_sense = drck->entity_sense(drc);
+    ret = drck->entity_sense(drc, &sensor_state);
 
-    rtas_st(rets, 0, RTAS_OUT_SUCCESS);
-    rtas_st(rets, 1, entity_sense);
+out:
+    rtas_st(rets, 0, ret);
+    rtas_st(rets, 1, sensor_state);
 }
 
 /* configure-connector work area offsets, int32_t units for field
diff --git a/include/hw/ppc/spapr_drc.h b/include/hw/ppc/spapr_drc.h
index 28ffeae..7e56347 100644
--- a/include/hw/ppc/spapr_drc.h
+++ b/include/hw/ppc/spapr_drc.h
@@ -165,17 +165,17 @@ typedef struct sPAPRDRConnectorClass {
     /*< public >*/
 
     /* accessors for guest-visible (generally via RTAS) DR state */
-    int (*set_isolation_state)(sPAPRDRConnector *drc,
-                               sPAPRDRIsolationState state);
-    int (*set_indicator_state)(sPAPRDRConnector *drc,
-                               sPAPRDRIndicatorState state);
-    int (*set_allocation_state)(sPAPRDRConnector *drc,
-                                sPAPRDRAllocationState state);
+    uint32_t (*set_isolation_state)(sPAPRDRConnector *drc,
+                                    sPAPRDRIsolationState state);
+    uint32_t (*set_indicator_state)(sPAPRDRConnector *drc,
+                                    sPAPRDRIndicatorState state);
+    uint32_t (*set_allocation_state)(sPAPRDRConnector *drc,
+                                     sPAPRDRAllocationState state);
     uint32_t (*get_index)(sPAPRDRConnector *drc);
     uint32_t (*get_type)(sPAPRDRConnector *drc);
     const char *(*get_name)(sPAPRDRConnector *drc);
 
-    sPAPRDREntitySense (*entity_sense)(sPAPRDRConnector *drc);
+    uint32_t (*entity_sense)(sPAPRDRConnector *drc, sPAPRDREntitySense *state);
 
     /* QEMU interfaces for managing FDT/configure-connector */
     const void *(*get_fdt)(sPAPRDRConnector *drc, int *fdt_start_offset);
-- 
2.4.3

[Qemu-devel] [PULL 20/36] spapr: Don't use QOM [*] syntax for DR connectors.

[David Gibson]

The dynamic reconfiguration (hotplug) code for the pseries machine type
uses a "DR connector" QOM object for each resource it will be possible
to hotplug.  Each of these is added to its owner using
    object_property_add_child(owner, "dr-connector[*], ...);

That works ok, mostly, but it means that the property indices are
arbitrary, depending on the order in which the connectors are constructed.
That might line up to something useful, but it doesn't have to.

It will get worse once we add hotplug RAM support.  That will add a DR
connector object for every 256MB of potential memory.  So if maxmem=2T,
for example, there are 8192 objects under the same parent.

The QOM interfaces aren't really designed for this.  In particular
object_property_add() with [*] has O(n^2) time complexity (in the number of
existing children): first it has a linear search through array indices to
find a free slot, each of which is attempted to a recursive call to
object_property_add() with a specific [N].  Those calls are O(n) because
there's a linear search through all properties to check for duplicates.

By using a meaningful index value, which we already know is unique we can
avoid the [*] special behaviour.  That lets us reduce the total time for
creating the DR objects from O(n^3) to O(n^2).

O(n^2) is still kind of crappy, but it's enough to reduce the startup time
of qemu (with in-progress memory hotplug support) with maxmem=2T from ~20
minutes to ~4 seconds.

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Cc: Bharata B Rao <bharata@linux.vnet.ibm.com>
Tested-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: Alexey Kardashevskiy <aik@ozlabs.ru>
---
 hw/ppc/spapr_drc.c | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/hw/ppc/spapr_drc.c b/hw/ppc/spapr_drc.c
index b7b9891..5d6ea7c 100644
--- a/hw/ppc/spapr_drc.c
+++ b/hw/ppc/spapr_drc.c
@@ -473,14 +473,17 @@ sPAPRDRConnector *spapr_dr_connector_new(Object *owner,
 {
     sPAPRDRConnector *drc =
         SPAPR_DR_CONNECTOR(object_new(TYPE_SPAPR_DR_CONNECTOR));
+    char *prop_name;
 
     g_assert(type);
 
     drc->type = type;
     drc->id = id;
     drc->owner = owner;
-    object_property_add_child(owner, "dr-connector[*]", OBJECT(drc), NULL);
+    prop_name = g_strdup_printf("dr-connector[%"PRIu32"]", get_index(drc));
+    object_property_add_child(owner, prop_name, OBJECT(drc), NULL);
     object_property_set_bool(OBJECT(drc), true, "realized", NULL);
+    g_free(prop_name);
 
     /* human-readable name for a DRC to encode into the DT
      * description. this is mainly only used within a guest in place
-- 
2.4.3

[Qemu-devel] [PULL 21/36] spapr: Use QEMU limit for maximum CPUs number

[David Gibson]

From: Alexey Kardashevskiy <aik@ozlabs.ru>

sPAPR uses hard coded limit of maximum 255 supported CPUs which is
exactly the same as QEMU-wide limit which is MAX_CPUMASK_BITS and also
defined as 255.

This makes use of a global CPU number limit for the "pseries" machine.

In order to anticipate future increase of the MAX_CPUMASK_BITS
(or to help debugging large systems), this also bumps the FDT_MAX_SIZE
limit from 256K to 1M assuming that 1 CPU core needs roughly 512 bytes
in the device tree so the new limit can cover up to 2048 CPU cores.

Signed-off-by: Alexey Kardashevskiy <aik@ozlabs.ru>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 2fb5e36..33e22ce 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -74,7 +74,7 @@
  *
  * We load our kernel at 4M, leaving space for SLOF initial image
  */
-#define FDT_MAX_SIZE            0x40000
+#define FDT_MAX_SIZE            0x100000
 #define RTAS_MAX_SIZE           0x10000
 #define RTAS_MAX_ADDR           0x80000000 /* RTAS must stay below that */
 #define FW_MAX_SIZE             0x400000
@@ -86,8 +86,6 @@
 
 #define TIMEBASE_FREQ           512000000ULL
 
-#define MAX_CPUS                255
-
 #define PHANDLE_XICP            0x00001111
 
 #define HTAB_SIZE(spapr)        (1ULL << ((spapr)->htab_shift))
@@ -1859,7 +1857,7 @@ static void spapr_machine_class_init(ObjectClass *oc, void *data)
     mc->init = ppc_spapr_init;
     mc->reset = ppc_spapr_reset;
     mc->block_default_type = IF_SCSI;
-    mc->max_cpus = MAX_CPUS;
+    mc->max_cpus = MAX_CPUMASK_BITS;
     mc->no_parallel = 1;
     mc->default_boot_order = "";
     mc->default_ram_size = 512 * M_BYTE;
-- 
2.4.3

[Qemu-devel] [PULL 22/36] spapr: Add LMB DR connectors

[David Gibson]

Enable memory hotplug for pseries 2.4 and add LMB DR connectors.
With memory hotplug, enforce RAM size, NUMA node memory size and maxmem
to be a multiple of SPAPR_MEMORY_BLOCK_SIZE (256M) since that's the
granularity in which LMBs are represented and hot-added.

LMB DR connectors will be used by the memory hotplug code.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
               [spapr_drc_reset implementation]
[since this missed the 2.4 cutoff, changing to only enable for 2.5]
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c         | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++
 include/hw/ppc/spapr.h |  1 +
 2 files changed, 88 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 33e22ce..940a82f 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -61,6 +61,7 @@
 #include "hw/nmi.h"
 
 #include "hw/compat.h"
+#include "qemu-common.h"
 
 #include <libfdt.h>
 
@@ -1446,10 +1447,84 @@ static void spapr_cpu_init(sPAPRMachineState *spapr, PowerPCCPU *cpu)
     qemu_register_reset(spapr_cpu_reset, cpu);
 }
 
+/*
+ * Reset routine for LMB DR devices.
+ *
+ * Unlike PCI DR devices, LMB DR devices explicitly register this reset
+ * routine. Reset for PCI DR devices will be handled by PHB reset routine
+ * when it walks all its children devices. LMB devices reset occurs
+ * as part of spapr_ppc_reset().
+ */
+static void spapr_drc_reset(void *opaque)
+{
+    sPAPRDRConnector *drc = opaque;
+    DeviceState *d = DEVICE(drc);
+
+    if (d) {
+        device_reset(d);
+    }
+}
+
+static void spapr_create_lmb_dr_connectors(sPAPRMachineState *spapr)
+{
+    MachineState *machine = MACHINE(spapr);
+    uint64_t lmb_size = SPAPR_MEMORY_BLOCK_SIZE;
+    uint32_t nr_rma_lmbs = spapr->rma_size/lmb_size;
+    uint32_t nr_lmbs = machine->maxram_size/lmb_size - nr_rma_lmbs;
+    uint32_t nr_assigned_lmbs = machine->ram_size/lmb_size - nr_rma_lmbs;
+    int i;
+
+    for (i = 0; i < nr_lmbs; i++) {
+        sPAPRDRConnector *drc;
+        uint64_t addr;
+
+        if (i < nr_assigned_lmbs) {
+            addr = (i + nr_rma_lmbs) * lmb_size;
+        } else {
+            addr = (i - nr_assigned_lmbs) * lmb_size +
+                    spapr->hotplug_memory.base;
+        }
+        drc = spapr_dr_connector_new(OBJECT(spapr), SPAPR_DR_CONNECTOR_TYPE_LMB,
+                                     addr/lmb_size);
+        qemu_register_reset(spapr_drc_reset, drc);
+    }
+}
+
+/*
+ * If RAM size, maxmem size and individual node mem sizes aren't aligned
+ * to SPAPR_MEMORY_BLOCK_SIZE(256MB), then refuse to start the guest
+ * since we can't support such unaligned sizes with DRCONF_MEMORY.
+ */
+static void spapr_validate_node_memory(MachineState *machine)
+{
+    int i;
+
+    if (machine->maxram_size % SPAPR_MEMORY_BLOCK_SIZE ||
+        machine->ram_size % SPAPR_MEMORY_BLOCK_SIZE) {
+        error_report("Can't support memory configuration where RAM size "
+                     "0x" RAM_ADDR_FMT " or maxmem size "
+                     "0x" RAM_ADDR_FMT " isn't aligned to %llu MB",
+                     machine->ram_size, machine->maxram_size,
+                     SPAPR_MEMORY_BLOCK_SIZE/M_BYTE);
+        exit(EXIT_FAILURE);
+    }
+
+    for (i = 0; i < nb_numa_nodes; i++) {
+        if (numa_info[i].node_mem % SPAPR_MEMORY_BLOCK_SIZE) {
+            error_report("Can't support memory configuration where memory size"
+                         " %" PRIx64 " of node %d isn't aligned to %llu MB",
+                         numa_info[i].node_mem, i,
+                         SPAPR_MEMORY_BLOCK_SIZE/M_BYTE);
+            exit(EXIT_FAILURE);
+        }
+    }
+}
+
 /* pSeries LPAR / sPAPR hardware init */
 static void ppc_spapr_init(MachineState *machine)
 {
     sPAPRMachineState *spapr = SPAPR_MACHINE(machine);
+    sPAPRMachineClass *smc = SPAPR_MACHINE_GET_CLASS(machine);
     const char *kernel_filename = machine->kernel_filename;
     const char *kernel_cmdline = machine->kernel_cmdline;
     const char *initrd_filename = machine->initrd_filename;
@@ -1528,6 +1603,10 @@ static void ppc_spapr_init(MachineState *machine)
                                                smp_threads),
                                   XICS_IRQS);
 
+    if (smc->dr_lmb_enabled) {
+        spapr_validate_node_memory(machine);
+    }
+
     /* init CPUs */
     if (machine->cpu_model == NULL) {
         machine->cpu_model = kvm_enabled() ? "host" : "POWER7";
@@ -1578,6 +1657,10 @@ static void ppc_spapr_init(MachineState *machine)
                                     &spapr->hotplug_memory.mr);
     }
 
+    if (smc->dr_lmb_enabled) {
+        spapr_create_lmb_dr_connectors(spapr);
+    }
+
     filename = qemu_find_file(QEMU_FILE_TYPE_BIOS, "spapr-rtas.bin");
     if (!filename) {
         error_report("Could not find LPAR rtas '%s'", "spapr-rtas.bin");
@@ -1851,6 +1934,7 @@ static void spapr_nmi(NMIState *n, int cpu_index, Error **errp)
 static void spapr_machine_class_init(ObjectClass *oc, void *data)
 {
     MachineClass *mc = MACHINE_CLASS(oc);
+    sPAPRMachineClass *smc = SPAPR_MACHINE_CLASS(oc);
     FWPathProviderClass *fwc = FW_PATH_PROVIDER_CLASS(oc);
     NMIClass *nc = NMI_CLASS(oc);
 
@@ -1865,6 +1949,7 @@ static void spapr_machine_class_init(ObjectClass *oc, void *data)
     mc->has_dynamic_sysbus = true;
     mc->pci_allow_0_address = true;
 
+    smc->dr_lmb_enabled = false;
     fwc->get_dev_path = spapr_get_fw_dev_path;
     nc->nmi_monitor_handler = spapr_nmi;
 }
@@ -2014,11 +2099,13 @@ static const TypeInfo spapr_machine_2_4_info = {
 static void spapr_machine_2_5_class_init(ObjectClass *oc, void *data)
 {
     MachineClass *mc = MACHINE_CLASS(oc);
+    sPAPRMachineClass *smc = SPAPR_MACHINE_CLASS(oc);
 
     mc->name = "pseries-2.5";
     mc->desc = "pSeries Logical Partition (PAPR compliant) v2.5";
     mc->alias = "pseries";
     mc->is_default = 1;
+    smc->dr_lmb_enabled = true;
 }
 
 static const TypeInfo spapr_machine_2_5_info = {
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index e882770..5de54d4 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -35,6 +35,7 @@ struct sPAPRMachineClass {
     MachineClass parent_class;
 
     /*< public >*/
+    bool dr_lmb_enabled; /* enable dynamic-reconfig/hotplug of LMBs */
 };
 
 /**
-- 
2.4.3

[Qemu-devel] [PULL 23/36] spapr: Support ibm, dynamic-reconfiguration-memory

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Parse ibm,architecture.vec table obtained from the guest and enable
memory node configuration via ibm,dynamic-reconfiguration-memory if guest
supports it. This is in preparation to support memory hotplug for
sPAPR guests.

This changes the way memory node configuration is done. Currently all
memory nodes are built upfront. But after this patch, only memory@0 node
for RMA is built upfront. Guest kernel boots with just that and rest of
the memory nodes (via memory@XXX or ibm,dynamic-reconfiguration-memory)
are built when guest does ibm,client-architecture-support call.

Note: This patch needs a SLOF enhancement which is already part of
SLOF binary in QEMU.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 docs/specs/ppc-spapr-hotplug.txt |  48 +++++++++
 hw/ppc/spapr.c                   | 210 +++++++++++++++++++++++++++++++--------
 hw/ppc/spapr_hcall.c             |  51 ++++++++--
 include/hw/ppc/spapr.h           |  15 ++-
 4 files changed, 274 insertions(+), 50 deletions(-)

diff --git a/docs/specs/ppc-spapr-hotplug.txt b/docs/specs/ppc-spapr-hotplug.txt
index 46e0719..631b0ca 100644
--- a/docs/specs/ppc-spapr-hotplug.txt
+++ b/docs/specs/ppc-spapr-hotplug.txt
@@ -302,4 +302,52 @@ consisting of <phys>, <size> and <maxcpus>.
 pseries guests use this property to note the maximum allowed CPUs for the
 guest.
 
+== ibm,dynamic-reconfiguration-memory ==
+
+ibm,dynamic-reconfiguration-memory is a device tree node that represents
+dynamically reconfigurable logical memory blocks (LMB). This node
+is generated only when the guest advertises the support for it via
+ibm,client-architecture-support call. Memory that is not dynamically
+reconfigurable is represented by /memory nodes. The properties of this
+node that are of interest to the sPAPR memory hotplug implementation
+in QEMU are described here.
+
+ibm,lmb-size
+
+This 64bit integer defines the size of each dynamically reconfigurable LMB.
+
+ibm,associativity-lookup-arrays
+
+This property defines a lookup array in which the NUMA associativity
+information for each LMB can be found. It is a property encoded array
+that begins with an integer M, the number of associativity lists followed
+by an integer N, the number of entries per associativity list and terminated
+by M associativity lists each of length N integers.
+
+This property provides the same information as given by ibm,associativity
+property in a /memory node. Each assigned LMB has an index value between
+0 and M-1 which is used as an index into this table to select which
+associativity list to use for the LMB. This index value for each LMB
+is defined in ibm,dynamic-memory property.
+
+ibm,dynamic-memory
+
+This property describes the dynamically reconfigurable memory. It is a
+property encoded array that has an integer N, the number of LMBs followed
+by N LMB list entires.
+
+Each LMB list entry consists of the following elements:
+
+- Logical address of the start of the LMB encoded as a 64bit integer. This
+  corresponds to reg property in /memory node.
+- DRC index of the LMB that corresponds to ibm,my-drc-index property
+  in a /memory node.
+- Four bytes reserved for expansion.
+- Associativity list index for the LMB that is used as an index into
+  ibm,associativity-lookup-arrays property described earlier. This
+  is used to retrieve the right associativity list to be used for this
+  LMB.
+- A 32bit flags word. The bit at bit position 0x00000008 defines whether
+  the LMB is assigned to the the partition as of boot time.
+
 [1] http://thread.gmane.org/gmane.linux.ports.ppc.embedded/75350/focus=106867
diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 940a82f..2f49f97 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -504,44 +504,7 @@ static void *spapr_create_fdt_skel(hwaddr initrd_base,
     return fdt;
 }
 
-int spapr_h_cas_compose_response(sPAPRMachineState *spapr,
-                                 target_ulong addr, target_ulong size)
-{
-    void *fdt, *fdt_skel;
-    sPAPRDeviceTreeUpdateHeader hdr = { .version_id = 1 };
-
-    size -= sizeof(hdr);
-
-    /* Create sceleton */
-    fdt_skel = g_malloc0(size);
-    _FDT((fdt_create(fdt_skel, size)));
-    _FDT((fdt_begin_node(fdt_skel, "")));
-    _FDT((fdt_end_node(fdt_skel)));
-    _FDT((fdt_finish(fdt_skel)));
-    fdt = g_malloc0(size);
-    _FDT((fdt_open_into(fdt_skel, fdt, size)));
-    g_free(fdt_skel);
-
-    /* Fix skeleton up */
-    _FDT((spapr_fixup_cpu_dt(fdt, spapr)));
-
-    /* Pack resulting tree */
-    _FDT((fdt_pack(fdt)));
-
-    if (fdt_totalsize(fdt) + sizeof(hdr) > size) {
-        trace_spapr_cas_failed(size);
-        return -1;
-    }
-
-    cpu_physical_memory_write(addr, &hdr, sizeof(hdr));
-    cpu_physical_memory_write(addr + sizeof(hdr), fdt, fdt_totalsize(fdt));
-    trace_spapr_cas_continue(fdt_totalsize(fdt) + sizeof(hdr));
-    g_free(fdt);
-
-    return 0;
-}
-
-static void spapr_populate_memory_node(void *fdt, int nodeid, hwaddr start,
+static int spapr_populate_memory_node(void *fdt, int nodeid, hwaddr start,
                                        hwaddr size)
 {
     uint32_t associativity[] = {
@@ -564,6 +527,7 @@ static void spapr_populate_memory_node(void *fdt, int nodeid, hwaddr start,
                       sizeof(mem_reg_property))));
     _FDT((fdt_setprop(fdt, off, "ibm,associativity", associativity,
                       sizeof(associativity))));
+    return off;
 }
 
 static int spapr_populate_memory(sPAPRMachineState *spapr, void *fdt)
@@ -595,7 +559,6 @@ static int spapr_populate_memory(sPAPRMachineState *spapr, void *fdt)
         }
         if (!mem_start) {
             /* ppc_spapr_init() checks for rma_size <= node0_size already */
-            spapr_populate_memory_node(fdt, i, 0, spapr->rma_size);
             mem_start += spapr->rma_size;
             node_size -= spapr->rma_size;
         }
@@ -745,6 +708,154 @@ static void spapr_populate_cpus_dt_node(void *fdt, sPAPRMachineState *spapr)
 
 }
 
+/*
+ * Adds ibm,dynamic-reconfiguration-memory node.
+ * Refer to docs/specs/ppc-spapr-hotplug.txt for the documentation
+ * of this device tree node.
+ */
+static int spapr_populate_drconf_memory(sPAPRMachineState *spapr, void *fdt)
+{
+    MachineState *machine = MACHINE(spapr);
+    int ret, i, offset;
+    uint64_t lmb_size = SPAPR_MEMORY_BLOCK_SIZE;
+    uint32_t prop_lmb_size[] = {0, cpu_to_be32(lmb_size)};
+    uint32_t nr_rma_lmbs = spapr->rma_size/lmb_size;
+    uint32_t nr_lmbs = machine->maxram_size/lmb_size - nr_rma_lmbs;
+    uint32_t nr_assigned_lmbs = machine->ram_size/lmb_size - nr_rma_lmbs;
+    uint32_t *int_buf, *cur_index, buf_len;
+
+    /* Allocate enough buffer size to fit in ibm,dynamic-memory */
+    buf_len = nr_lmbs * SPAPR_DR_LMB_LIST_ENTRY_SIZE * sizeof(uint32_t) +
+                sizeof(uint32_t);
+    cur_index = int_buf = g_malloc0(buf_len);
+
+    offset = fdt_add_subnode(fdt, 0, "ibm,dynamic-reconfiguration-memory");
+
+    ret = fdt_setprop(fdt, offset, "ibm,lmb-size", prop_lmb_size,
+                    sizeof(prop_lmb_size));
+    if (ret < 0) {
+        goto out;
+    }
+
+    ret = fdt_setprop_cell(fdt, offset, "ibm,memory-flags-mask", 0xff);
+    if (ret < 0) {
+        goto out;
+    }
+
+    ret = fdt_setprop_cell(fdt, offset, "ibm,memory-preservation-time", 0x0);
+    if (ret < 0) {
+        goto out;
+    }
+
+    /* ibm,dynamic-memory */
+    int_buf[0] = cpu_to_be32(nr_lmbs);
+    cur_index++;
+    for (i = 0; i < nr_lmbs; i++) {
+        sPAPRDRConnector *drc;
+        sPAPRDRConnectorClass *drck;
+        uint64_t addr;
+        uint32_t *dynamic_memory = cur_index;
+
+        if (i < nr_assigned_lmbs) {
+            addr = (i + nr_rma_lmbs) * lmb_size;
+        } else {
+            addr = (i - nr_assigned_lmbs) * lmb_size +
+                    spapr->hotplug_memory.base;
+        }
+        drc = spapr_dr_connector_by_id(SPAPR_DR_CONNECTOR_TYPE_LMB,
+                                       addr/lmb_size);
+        g_assert(drc);
+        drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
+
+        dynamic_memory[0] = cpu_to_be32(addr >> 32);
+        dynamic_memory[1] = cpu_to_be32(addr & 0xffffffff);
+        dynamic_memory[2] = cpu_to_be32(drck->get_index(drc));
+        dynamic_memory[3] = cpu_to_be32(0); /* reserved */
+        dynamic_memory[4] = cpu_to_be32(numa_get_node(addr, NULL));
+        if (addr < machine->ram_size ||
+                    memory_region_present(get_system_memory(), addr)) {
+            dynamic_memory[5] = cpu_to_be32(SPAPR_LMB_FLAGS_ASSIGNED);
+        } else {
+            dynamic_memory[5] = cpu_to_be32(0);
+        }
+
+        cur_index += SPAPR_DR_LMB_LIST_ENTRY_SIZE;
+    }
+    ret = fdt_setprop(fdt, offset, "ibm,dynamic-memory", int_buf, buf_len);
+    if (ret < 0) {
+        goto out;
+    }
+
+    /* ibm,associativity-lookup-arrays */
+    cur_index = int_buf;
+    int_buf[0] = cpu_to_be32(nb_numa_nodes);
+    int_buf[1] = cpu_to_be32(4); /* Number of entries per associativity list */
+    cur_index += 2;
+    for (i = 0; i < nb_numa_nodes; i++) {
+        uint32_t associativity[] = {
+            cpu_to_be32(0x0),
+            cpu_to_be32(0x0),
+            cpu_to_be32(0x0),
+            cpu_to_be32(i)
+        };
+        memcpy(cur_index, associativity, sizeof(associativity));
+        cur_index += 4;
+    }
+    ret = fdt_setprop(fdt, offset, "ibm,associativity-lookup-arrays", int_buf,
+            (cur_index - int_buf) * sizeof(uint32_t));
+out:
+    g_free(int_buf);
+    return ret;
+}
+
+int spapr_h_cas_compose_response(sPAPRMachineState *spapr,
+                                 target_ulong addr, target_ulong size,
+                                 bool cpu_update, bool memory_update)
+{
+    void *fdt, *fdt_skel;
+    sPAPRDeviceTreeUpdateHeader hdr = { .version_id = 1 };
+    sPAPRMachineClass *smc = SPAPR_MACHINE_GET_CLASS(qdev_get_machine());
+
+    size -= sizeof(hdr);
+
+    /* Create sceleton */
+    fdt_skel = g_malloc0(size);
+    _FDT((fdt_create(fdt_skel, size)));
+    _FDT((fdt_begin_node(fdt_skel, "")));
+    _FDT((fdt_end_node(fdt_skel)));
+    _FDT((fdt_finish(fdt_skel)));
+    fdt = g_malloc0(size);
+    _FDT((fdt_open_into(fdt_skel, fdt, size)));
+    g_free(fdt_skel);
+
+    /* Fixup cpu nodes */
+    if (cpu_update) {
+        _FDT((spapr_fixup_cpu_dt(fdt, spapr)));
+    }
+
+    /* Generate memory nodes or ibm,dynamic-reconfiguration-memory node */
+    if (memory_update && smc->dr_lmb_enabled) {
+        _FDT((spapr_populate_drconf_memory(spapr, fdt)));
+    } else {
+        _FDT((spapr_populate_memory(spapr, fdt)));
+    }
+
+    /* Pack resulting tree */
+    _FDT((fdt_pack(fdt)));
+
+    if (fdt_totalsize(fdt) + sizeof(hdr) > size) {
+        trace_spapr_cas_failed(size);
+        return -1;
+    }
+
+    cpu_physical_memory_write(addr, &hdr, sizeof(hdr));
+    cpu_physical_memory_write(addr + sizeof(hdr), fdt, fdt_totalsize(fdt));
+    trace_spapr_cas_continue(fdt_totalsize(fdt) + sizeof(hdr));
+    g_free(fdt);
+
+    return 0;
+}
+
 static void spapr_finalize_fdt(sPAPRMachineState *spapr,
                                hwaddr fdt_addr,
                                hwaddr rtas_addr,
@@ -763,10 +874,23 @@ static void spapr_finalize_fdt(sPAPRMachineState *spapr,
     /* open out the base tree into a temp buffer for the final tweaks */
     _FDT((fdt_open_into(spapr->fdt_skel, fdt, FDT_MAX_SIZE)));
 
-    ret = spapr_populate_memory(spapr, fdt);
-    if (ret < 0) {
-        fprintf(stderr, "couldn't setup memory nodes in fdt\n");
-        exit(1);
+    /*
+     * Add memory@0 node to represent RMA. Rest of the memory is either
+     * represented by memory nodes or ibm,dynamic-reconfiguration-memory
+     * node later during ibm,client-architecture-support call.
+     *
+     * If NUMA is configured, ensure that memory@0 ends up in the
+     * first memory-less node.
+     */
+    if (nb_numa_nodes) {
+        for (i = 0; i < nb_numa_nodes; ++i) {
+            if (numa_info[i].node_mem) {
+                spapr_populate_memory_node(fdt, i, 0, spapr->rma_size);
+                break;
+            }
+        }
+    } else {
+        spapr_populate_memory_node(fdt, 0, 0, spapr->rma_size);
     }
 
     ret = spapr_populate_vdevice(spapr->vio_bus, fdt);
diff --git a/hw/ppc/spapr_hcall.c b/hw/ppc/spapr_hcall.c
index 71fc9f2..cebceea 100644
--- a/hw/ppc/spapr_hcall.c
+++ b/hw/ppc/spapr_hcall.c
@@ -808,6 +808,32 @@ static target_ulong h_set_mode(PowerPCCPU *cpu, sPAPRMachineState *spapr,
     return ret;
 }
 
+/*
+ * Return the offset to the requested option vector @vector in the
+ * option vector table @table.
+ */
+static target_ulong cas_get_option_vector(int vector, target_ulong table)
+{
+    int i;
+    char nr_vectors, nr_entries;
+
+    if (!table) {
+        return 0;
+    }
+
+    nr_vectors = (ldl_phys(&address_space_memory, table) >> 24) + 1;
+    if (!vector || vector > nr_vectors) {
+        return 0;
+    }
+    table++; /* skip nr option vectors */
+
+    for (i = 0; i < vector - 1; i++) {
+        nr_entries = ldl_phys(&address_space_memory, table) >> 24;
+        table += nr_entries + 2;
+    }
+    return table;
+}
+
 typedef struct {
     PowerPCCPU *cpu;
     uint32_t cpu_version;
@@ -828,19 +854,22 @@ static void do_set_compat(void *arg)
     ((cpuver) == CPU_POWERPC_LOGICAL_2_06_PLUS) ? 2061 : \
     ((cpuver) == CPU_POWERPC_LOGICAL_2_07) ? 2070 : 0)
 
+#define OV5_DRCONF_MEMORY 0x20
+
 static target_ulong h_client_architecture_support(PowerPCCPU *cpu_,
                                                   sPAPRMachineState *spapr,
                                                   target_ulong opcode,
                                                   target_ulong *args)
 {
-    target_ulong list = args[0];
+    target_ulong list = args[0], ov_table;
     PowerPCCPUClass *pcc_ = POWERPC_CPU_GET_CLASS(cpu_);
     CPUState *cs;
-    bool cpu_match = false;
+    bool cpu_match = false, cpu_update = true, memory_update = false;
     unsigned old_cpu_version = cpu_->cpu_version;
     unsigned compat_lvl = 0, cpu_version = 0;
     unsigned max_lvl = get_compat_level(cpu_->max_compat);
     int counter;
+    char ov5_byte2;
 
     /* Parse PVR list */
     for (counter = 0; counter < 512; ++counter) {
@@ -890,8 +919,6 @@ static target_ulong h_client_architecture_support(PowerPCCPU *cpu_,
         }
     }
 
-    /* For the future use: here @list points to the first capability */
-
     /* Parsing finished */
     trace_spapr_cas_pvr(cpu_->cpu_version, cpu_match,
                         cpu_version, pcc_->pcr_mask);
@@ -915,14 +942,26 @@ static target_ulong h_client_architecture_support(PowerPCCPU *cpu_,
     }
 
     if (!cpu_version) {
-        return H_SUCCESS;
+        cpu_update = false;
     }
 
+    /* For the future use: here @ov_table points to the first option vector */
+    ov_table = list;
+
+    list = cas_get_option_vector(5, ov_table);
     if (!list) {
         return H_SUCCESS;
     }
 
-    if (spapr_h_cas_compose_response(spapr, args[1], args[2])) {
+    /* @list now points to OV 5 */
+    list += 2;
+    ov5_byte2 = rtas_ld(list, 0) >> 24;
+    if (ov5_byte2 & OV5_DRCONF_MEMORY) {
+        memory_update = true;
+    }
+
+    if (spapr_h_cas_compose_response(spapr, args[1], args[2],
+                                     cpu_update, memory_update)) {
         qemu_system_reset_request();
     }
 
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index 5de54d4..7d20798 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -581,7 +581,8 @@ struct sPAPREventLogEntry {
 void spapr_events_init(sPAPRMachineState *sm);
 void spapr_events_fdt_skel(void *fdt, uint32_t epow_irq);
 int spapr_h_cas_compose_response(sPAPRMachineState *sm,
-                                 target_ulong addr, target_ulong size);
+                                 target_ulong addr, target_ulong size,
+                                 bool cpu_update, bool memory_update);
 sPAPRTCETable *spapr_tce_new_table(DeviceState *owner, uint32_t liobn,
                                    uint64_t bus_offset,
                                    uint32_t page_shift,
@@ -623,4 +624,16 @@ int spapr_rtc_import_offset(DeviceState *dev, int64_t legacy_offset);
 /* 1GB alignment for hotplug memory region */
 #define SPAPR_HOTPLUG_MEM_ALIGN (1ULL << 30)
 
+/*
+ * Number of 32 bit words in each LMB list entry in ibm,dynamic-memory
+ * property under ibm,dynamic-reconfiguration-memory node.
+ */
+#define SPAPR_DR_LMB_LIST_ENTRY_SIZE 6
+
+/*
+ * This flag value defines the LMB as assigned in ibm,dynamic-memory
+ * property under ibm,dynamic-reconfiguration-memory node.
+ */
+#define SPAPR_LMB_FLAGS_ASSIGNED 0x00000008
+
 #endif /* !defined (__HW_SPAPR_H__) */
-- 
2.4.3

[Qemu-devel] [PULL 24/36] spapr: Make hash table size a factor of maxram_size

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

The hash table size is dependent on ram_size, but since with hotplug
the memory can grow till maxram_size. Hence make hash table size dependent
on maxram_size.

This allows to hotplug huge amounts of memory to the guest.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 2f49f97..d21e95c 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -1715,7 +1715,7 @@ static void ppc_spapr_init(MachineState *machine)
      * more than needed for the Linux guests we support. */
     spapr->htab_shift = 18; /* Minimum architected size */
     while (spapr->htab_shift <= 46) {
-        if ((1ULL << (spapr->htab_shift + 7)) >= machine->ram_size) {
+        if ((1ULL << (spapr->htab_shift + 7)) >= machine->maxram_size) {
             break;
         }
         spapr->htab_shift++;
-- 
2.4.3

[Qemu-devel] [PULL 25/36] spapr: Memory hotplug support

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Make use of pc-dimm infrastructure to support memory hotplug
for PowerPC.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c        | 118 ++++++++++++++++++++++++++++++++++++++++++++++++++
 hw/ppc/spapr_events.c |   8 ++--
 2 files changed, 123 insertions(+), 3 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index d21e95c..5b46229 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -34,6 +34,7 @@
 #include "sysemu/block-backend.h"
 #include "sysemu/cpus.h"
 #include "sysemu/kvm.h"
+#include "sysemu/device_tree.h"
 #include "kvm_ppc.h"
 #include "migration/migration.h"
 #include "mmu-hash64.h"
@@ -862,6 +863,7 @@ static void spapr_finalize_fdt(sPAPRMachineState *spapr,
                                hwaddr rtas_size)
 {
     MachineState *machine = MACHINE(qdev_get_machine());
+    sPAPRMachineClass *smc = SPAPR_MACHINE_GET_CLASS(machine);
     const char *boot_device = machine->boot_order;
     int ret, i;
     size_t cb = 0;
@@ -945,6 +947,10 @@ static void spapr_finalize_fdt(sPAPRMachineState *spapr,
         spapr_populate_chosen_stdout(fdt, spapr->vio_bus);
     }
 
+    if (smc->dr_lmb_enabled) {
+        _FDT(spapr_drc_populate_dt(fdt, 0, NULL, SPAPR_DR_CONNECTOR_TYPE_LMB));
+    }
+
     _FDT((fdt_pack(fdt)));
 
     if (fdt_totalsize(fdt) > FDT_MAX_SIZE) {
@@ -2055,12 +2061,120 @@ static void spapr_nmi(NMIState *n, int cpu_index, Error **errp)
     }
 }
 
+static void spapr_add_lmbs(DeviceState *dev, uint64_t addr, uint64_t size,
+                           uint32_t node, Error **errp)
+{
+    sPAPRDRConnector *drc;
+    sPAPRDRConnectorClass *drck;
+    uint32_t nr_lmbs = size/SPAPR_MEMORY_BLOCK_SIZE;
+    int i, fdt_offset, fdt_size;
+    void *fdt;
+
+    /*
+     * Check for DRC connectors and send hotplug notification to the
+     * guest only in case of hotplugged memory. This allows cold plugged
+     * memory to be specified at boot time.
+     */
+    if (!dev->hotplugged) {
+        return;
+    }
+
+    for (i = 0; i < nr_lmbs; i++) {
+        drc = spapr_dr_connector_by_id(SPAPR_DR_CONNECTOR_TYPE_LMB,
+                addr/SPAPR_MEMORY_BLOCK_SIZE);
+        g_assert(drc);
+
+        fdt = create_device_tree(&fdt_size);
+        fdt_offset = spapr_populate_memory_node(fdt, node, addr,
+                                                SPAPR_MEMORY_BLOCK_SIZE);
+
+        drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
+        drck->attach(drc, dev, fdt, fdt_offset, !dev->hotplugged, errp);
+        spapr_hotplug_req_add_event(drc);
+        addr += SPAPR_MEMORY_BLOCK_SIZE;
+    }
+}
+
+static void spapr_memory_plug(HotplugHandler *hotplug_dev, DeviceState *dev,
+                              uint32_t node, Error **errp)
+{
+    Error *local_err = NULL;
+    sPAPRMachineState *ms = SPAPR_MACHINE(hotplug_dev);
+    PCDIMMDevice *dimm = PC_DIMM(dev);
+    PCDIMMDeviceClass *ddc = PC_DIMM_GET_CLASS(dimm);
+    MemoryRegion *mr = ddc->get_memory_region(dimm);
+    uint64_t align = memory_region_get_alignment(mr);
+    uint64_t size = memory_region_size(mr);
+    uint64_t addr;
+
+    if (size % SPAPR_MEMORY_BLOCK_SIZE) {
+        error_setg(&local_err, "Hotplugged memory size must be a multiple of "
+                      "%lld MB", SPAPR_MEMORY_BLOCK_SIZE/M_BYTE);
+        goto out;
+    }
+
+    pc_dimm_memory_plug(dev, &ms->hotplug_memory, mr, align, &local_err);
+    if (local_err) {
+        goto out;
+    }
+
+    addr = object_property_get_int(OBJECT(dimm), PC_DIMM_ADDR_PROP, &local_err);
+    if (local_err) {
+        pc_dimm_memory_unplug(dev, &ms->hotplug_memory, mr);
+        goto out;
+    }
+
+    spapr_add_lmbs(dev, addr, size, node, &error_abort);
+
+out:
+    error_propagate(errp, local_err);
+}
+
+static void spapr_machine_device_plug(HotplugHandler *hotplug_dev,
+                                      DeviceState *dev, Error **errp)
+{
+    sPAPRMachineClass *smc = SPAPR_MACHINE_GET_CLASS(qdev_get_machine());
+
+    if (object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM)) {
+        uint32_t node;
+
+        if (!smc->dr_lmb_enabled) {
+            error_setg(errp, "Memory hotplug not supported for this machine");
+            return;
+        }
+        node = object_property_get_int(OBJECT(dev), PC_DIMM_NODE_PROP, errp);
+        if (*errp) {
+            return;
+        }
+
+        spapr_memory_plug(hotplug_dev, dev, node, errp);
+    }
+}
+
+static void spapr_machine_device_unplug(HotplugHandler *hotplug_dev,
+                                      DeviceState *dev, Error **errp)
+{
+    if (object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM)) {
+        error_setg(errp, "Memory hot unplug not supported by sPAPR");
+    }
+}
+
+static HotplugHandler *spapr_get_hotpug_handler(MachineState *machine,
+                                             DeviceState *dev)
+{
+    if (object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM)) {
+        return HOTPLUG_HANDLER(machine);
+    }
+    return NULL;
+}
+
 static void spapr_machine_class_init(ObjectClass *oc, void *data)
 {
     MachineClass *mc = MACHINE_CLASS(oc);
     sPAPRMachineClass *smc = SPAPR_MACHINE_CLASS(oc);
     FWPathProviderClass *fwc = FW_PATH_PROVIDER_CLASS(oc);
     NMIClass *nc = NMI_CLASS(oc);
+    HotplugHandlerClass *hc = HOTPLUG_HANDLER_CLASS(oc);
 
     mc->init = ppc_spapr_init;
     mc->reset = ppc_spapr_reset;
@@ -2072,6 +2186,9 @@ static void spapr_machine_class_init(ObjectClass *oc, void *data)
     mc->kvm_type = spapr_kvm_type;
     mc->has_dynamic_sysbus = true;
     mc->pci_allow_0_address = true;
+    mc->get_hotplug_handler = spapr_get_hotpug_handler;
+    hc->plug = spapr_machine_device_plug;
+    hc->unplug = spapr_machine_device_unplug;
 
     smc->dr_lmb_enabled = false;
     fwc->get_dev_path = spapr_get_fw_dev_path;
@@ -2089,6 +2206,7 @@ static const TypeInfo spapr_machine_info = {
     .interfaces = (InterfaceInfo[]) {
         { TYPE_FW_PATH_PROVIDER },
         { TYPE_NMI },
+        { TYPE_HOTPLUG_HANDLER },
         { }
     },
 };
diff --git a/hw/ppc/spapr_events.c b/hw/ppc/spapr_events.c
index f626eb7..98bf7ae 100644
--- a/hw/ppc/spapr_events.c
+++ b/hw/ppc/spapr_events.c
@@ -427,14 +427,16 @@ static void spapr_hotplug_req_event(sPAPRDRConnector *drc, uint8_t hp_action)
     hp->hdr.section_length = cpu_to_be16(sizeof(*hp));
     hp->hdr.section_version = 1; /* includes extended modifier */
     hp->hotplug_action = hp_action;
-
+    hp->drc.index = cpu_to_be32(drck->get_index(drc));
+    hp->hotplug_identifier = RTAS_LOG_V6_HP_ID_DRC_INDEX;
 
     switch (drc_type) {
     case SPAPR_DR_CONNECTOR_TYPE_PCI:
-        hp->drc.index = cpu_to_be32(drck->get_index(drc));
-        hp->hotplug_identifier = RTAS_LOG_V6_HP_ID_DRC_INDEX;
         hp->hotplug_type = RTAS_LOG_V6_HP_TYPE_PCI;
         break;
+    case SPAPR_DR_CONNECTOR_TYPE_LMB:
+        hp->hotplug_type = RTAS_LOG_V6_HP_TYPE_MEMORY;
+        break;
     default:
         /* we shouldn't be signaling hotplug events for resources
          * that don't support them
-- 
2.4.3

[Qemu-devel] [PULL 26/36] spapr: Don't allow memory hotplug to memory less nodes

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Currently PowerPC kernel doesn't allow hot-adding memory to memory-less
node, but instead will silently add the memory to the first node that has
some memory. This causes two unexpected behaviours for the user.

- Memory gets hotplugged to a different node than what the user specified.
- Since pc-dimm subsystem in QEMU still thinks that memory belongs to
  memory-less node, a reboot will set things accordingly and the previously
  hotplugged memory now ends in the right node. This appears as if some
  memory moved from one node to another.

So until kernel starts supporting memory hotplug to memory-less
nodes, just prevent such attempts upfront in QEMU.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 5b46229..1170028 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -2136,7 +2136,7 @@ static void spapr_machine_device_plug(HotplugHandler *hotplug_dev,
     sPAPRMachineClass *smc = SPAPR_MACHINE_GET_CLASS(qdev_get_machine());
 
     if (object_dynamic_cast(OBJECT(dev), TYPE_PC_DIMM)) {
-        uint32_t node;
+        int node;
 
         if (!smc->dr_lmb_enabled) {
             error_setg(errp, "Memory hotplug not supported for this machine");
@@ -2147,6 +2147,28 @@ static void spapr_machine_device_plug(HotplugHandler *hotplug_dev,
             return;
         }
 
+        /*
+         * Currently PowerPC kernel doesn't allow hot-adding memory to
+         * memory-less node, but instead will silently add the memory
+         * to the first node that has some memory. This causes two
+         * unexpected behaviours for the user.
+         *
+         * - Memory gets hotplugged to a different node than what the user
+         *   specified.
+         * - Since pc-dimm subsystem in QEMU still thinks that memory belongs
+         *   to memory-less node, a reboot will set things accordingly
+         *   and the previously hotplugged memory now ends in the right node.
+         *   This appears as if some memory moved from one node to another.
+         *
+         * So until kernel starts supporting memory hotplug to memory-less
+         * nodes, just prevent such attempts upfront in QEMU.
+         */
+        if (nb_numa_nodes && !numa_info[node].node_mem) {
+            error_setg(errp, "Can't hotplug memory to memory-less node %d",
+                       node);
+            return;
+        }
+
         spapr_memory_plug(hotplug_dev, dev, node, errp);
     }
 }
-- 
2.4.3

[Qemu-devel] [PULL 27/36] spapr: Provide better error message when slots exceed max allowed

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Currently when user specifies more slots than allowed max of
SPAPR_MAX_RAM_SLOTS (32), we error out like this:

qemu-system-ppc64: unsupported amount of memory slots: 64

Let the user know about the max allowed slots like this:

qemu-system-ppc64: Specified number of memory slots 64 exceeds max supported 32

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 1170028..5c81e19 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -1774,8 +1774,8 @@ static void ppc_spapr_init(MachineState *machine)
         ram_addr_t hotplug_mem_size = machine->maxram_size - machine->ram_size;
 
         if (machine->ram_slots > SPAPR_MAX_RAM_SLOTS) {
-            error_report("unsupported amount of memory slots: %"PRIu64,
-                          machine->ram_slots);
+            error_report("Specified number of memory slots %"PRIu64" exceeds max supported %d\n",
+                         machine->ram_slots, SPAPR_MAX_RAM_SLOTS);
             exit(EXIT_FAILURE);
         }
 
-- 
2.4.3

[Qemu-devel] [PULL 28/36] spapr: Populate ibm, associativity-lookup-arrays correctly for non-NUMA

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

When NUMA isn't configured explicitly, assume node 0 is present for
the purpose of creating ibm,associativity-lookup-arrays property
under ibm,dynamic-reconfiguration-memory DT node. This ensures that
the associativity index property is correctly updated in ibm,dynamic-memory
for the LMB that is hotplugged.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 5c81e19..64d07cd 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -724,6 +724,7 @@ static int spapr_populate_drconf_memory(sPAPRMachineState *spapr, void *fdt)
     uint32_t nr_lmbs = machine->maxram_size/lmb_size - nr_rma_lmbs;
     uint32_t nr_assigned_lmbs = machine->ram_size/lmb_size - nr_rma_lmbs;
     uint32_t *int_buf, *cur_index, buf_len;
+    int nr_nodes = nb_numa_nodes ? nb_numa_nodes : 1;
 
     /* Allocate enough buffer size to fit in ibm,dynamic-memory */
     buf_len = nr_lmbs * SPAPR_DR_LMB_LIST_ENTRY_SIZE * sizeof(uint32_t) +
@@ -789,10 +790,10 @@ static int spapr_populate_drconf_memory(sPAPRMachineState *spapr, void *fdt)
 
     /* ibm,associativity-lookup-arrays */
     cur_index = int_buf;
-    int_buf[0] = cpu_to_be32(nb_numa_nodes);
+    int_buf[0] = cpu_to_be32(nr_nodes);
     int_buf[1] = cpu_to_be32(4); /* Number of entries per associativity list */
     cur_index += 2;
-    for (i = 0; i < nb_numa_nodes; i++) {
+    for (i = 0; i < nr_nodes; i++) {
         uint32_t associativity[] = {
             cpu_to_be32(0x0),
             cpu_to_be32(0x0),
-- 
2.4.3

[Qemu-devel] [PULL 29/36] spapr: Revert to memory@XXXX representation for non-hotplugged memory

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Don't represent non-hotluggable memory under drconf node. With this
we don't have to create DRC objects for them.

The effect of this patch is that we revert back to memory@XXXX representation
for all the memory specified with -m option and represent the cold
plugged memory and hot-pluggable memory under
ibm,dynamic-reconfiguration-memory.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 47 +++++++++--------------------------------------
 1 file changed, 9 insertions(+), 38 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 64d07cd..402c00d 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -560,6 +560,7 @@ static int spapr_populate_memory(sPAPRMachineState *spapr, void *fdt)
         }
         if (!mem_start) {
             /* ppc_spapr_init() checks for rma_size <= node0_size already */
+            spapr_populate_memory_node(fdt, i, 0, spapr->rma_size);
             mem_start += spapr->rma_size;
             node_size -= spapr->rma_size;
         }
@@ -720,9 +721,7 @@ static int spapr_populate_drconf_memory(sPAPRMachineState *spapr, void *fdt)
     int ret, i, offset;
     uint64_t lmb_size = SPAPR_MEMORY_BLOCK_SIZE;
     uint32_t prop_lmb_size[] = {0, cpu_to_be32(lmb_size)};
-    uint32_t nr_rma_lmbs = spapr->rma_size/lmb_size;
-    uint32_t nr_lmbs = machine->maxram_size/lmb_size - nr_rma_lmbs;
-    uint32_t nr_assigned_lmbs = machine->ram_size/lmb_size - nr_rma_lmbs;
+    uint32_t nr_lmbs = (machine->maxram_size - machine->ram_size)/lmb_size;
     uint32_t *int_buf, *cur_index, buf_len;
     int nr_nodes = nb_numa_nodes ? nb_numa_nodes : 1;
 
@@ -755,15 +754,9 @@ static int spapr_populate_drconf_memory(sPAPRMachineState *spapr, void *fdt)
     for (i = 0; i < nr_lmbs; i++) {
         sPAPRDRConnector *drc;
         sPAPRDRConnectorClass *drck;
-        uint64_t addr;
+        uint64_t addr = i * lmb_size + spapr->hotplug_memory.base;;
         uint32_t *dynamic_memory = cur_index;
 
-        if (i < nr_assigned_lmbs) {
-            addr = (i + nr_rma_lmbs) * lmb_size;
-        } else {
-            addr = (i - nr_assigned_lmbs) * lmb_size +
-                    spapr->hotplug_memory.base;
-        }
         drc = spapr_dr_connector_by_id(SPAPR_DR_CONNECTOR_TYPE_LMB,
                                        addr/lmb_size);
         g_assert(drc);
@@ -838,8 +831,6 @@ int spapr_h_cas_compose_response(sPAPRMachineState *spapr,
     /* Generate memory nodes or ibm,dynamic-reconfiguration-memory node */
     if (memory_update && smc->dr_lmb_enabled) {
         _FDT((spapr_populate_drconf_memory(spapr, fdt)));
-    } else {
-        _FDT((spapr_populate_memory(spapr, fdt)));
     }
 
     /* Pack resulting tree */
@@ -877,23 +868,10 @@ static void spapr_finalize_fdt(sPAPRMachineState *spapr,
     /* open out the base tree into a temp buffer for the final tweaks */
     _FDT((fdt_open_into(spapr->fdt_skel, fdt, FDT_MAX_SIZE)));
 
-    /*
-     * Add memory@0 node to represent RMA. Rest of the memory is either
-     * represented by memory nodes or ibm,dynamic-reconfiguration-memory
-     * node later during ibm,client-architecture-support call.
-     *
-     * If NUMA is configured, ensure that memory@0 ends up in the
-     * first memory-less node.
-     */
-    if (nb_numa_nodes) {
-        for (i = 0; i < nb_numa_nodes; ++i) {
-            if (numa_info[i].node_mem) {
-                spapr_populate_memory_node(fdt, i, 0, spapr->rma_size);
-                break;
-            }
-        }
-    } else {
-        spapr_populate_memory_node(fdt, 0, 0, spapr->rma_size);
+    ret = spapr_populate_memory(spapr, fdt);
+    if (ret < 0) {
+        fprintf(stderr, "couldn't setup memory nodes in fdt\n");
+        exit(1);
     }
 
     ret = spapr_populate_vdevice(spapr->vio_bus, fdt);
@@ -1600,21 +1578,14 @@ static void spapr_create_lmb_dr_connectors(sPAPRMachineState *spapr)
 {
     MachineState *machine = MACHINE(spapr);
     uint64_t lmb_size = SPAPR_MEMORY_BLOCK_SIZE;
-    uint32_t nr_rma_lmbs = spapr->rma_size/lmb_size;
-    uint32_t nr_lmbs = machine->maxram_size/lmb_size - nr_rma_lmbs;
-    uint32_t nr_assigned_lmbs = machine->ram_size/lmb_size - nr_rma_lmbs;
+    uint32_t nr_lmbs = (machine->maxram_size - machine->ram_size)/lmb_size;
     int i;
 
     for (i = 0; i < nr_lmbs; i++) {
         sPAPRDRConnector *drc;
         uint64_t addr;
 
-        if (i < nr_assigned_lmbs) {
-            addr = (i + nr_rma_lmbs) * lmb_size;
-        } else {
-            addr = (i - nr_assigned_lmbs) * lmb_size +
-                    spapr->hotplug_memory.base;
-        }
+        addr = i * lmb_size + spapr->hotplug_memory.base;
         drc = spapr_dr_connector_new(OBJECT(spapr), SPAPR_DR_CONNECTOR_TYPE_LMB,
                                      addr/lmb_size);
         qemu_register_reset(spapr_drc_reset, drc);
-- 
2.4.3

[Qemu-devel] [PULL 30/36] spapr: Support hotplug by specifying DRC count

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Support hotplug identifier type RTAS_LOG_V6_HP_ID_DRC_COUNT that allows
hotplugging of DRCs by specifying the DRC count.

While we are here, rename

spapr_hotplug_req_add_event() to spapr_hotplug_req_add_by_index()
spapr_hotplug_req_remove_event() to spapr_hotplug_req_remove_by_index()

so that they match with spapr_hotplug_req_add_by_count().

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c         |  2 +-
 hw/ppc/spapr_events.c  | 47 ++++++++++++++++++++++++++++++++++++++---------
 hw/ppc/spapr_pci.c     |  4 ++--
 include/hw/ppc/spapr.h |  8 ++++++--
 4 files changed, 47 insertions(+), 14 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 402c00d..d00513f 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -2062,7 +2062,7 @@ static void spapr_add_lmbs(DeviceState *dev, uint64_t addr, uint64_t size,
 
         drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
         drck->attach(drc, dev, fdt, fdt_offset, !dev->hotplugged, errp);
-        spapr_hotplug_req_add_event(drc);
+        spapr_hotplug_req_add_by_index(drc);
         addr += SPAPR_MEMORY_BLOCK_SIZE;
     }
 }
diff --git a/hw/ppc/spapr_events.c b/hw/ppc/spapr_events.c
index 98bf7ae..744ea62 100644
--- a/hw/ppc/spapr_events.c
+++ b/hw/ppc/spapr_events.c
@@ -386,7 +386,9 @@ static void spapr_powerdown_req(Notifier *n, void *opaque)
     qemu_irq_pulse(xics_get_qirq(spapr->icp, spapr->check_exception_irq));
 }
 
-static void spapr_hotplug_req_event(sPAPRDRConnector *drc, uint8_t hp_action)
+static void spapr_hotplug_req_event(uint8_t hp_id, uint8_t hp_action,
+                                    sPAPRDRConnectorType drc_type,
+                                    uint32_t drc)
 {
     sPAPRMachineState *spapr = SPAPR_MACHINE(qdev_get_machine());
     struct hp_log_full *new_hp;
@@ -395,8 +397,6 @@ static void spapr_hotplug_req_event(sPAPRDRConnector *drc, uint8_t hp_action)
     struct rtas_event_log_v6_maina *maina;
     struct rtas_event_log_v6_mainb *mainb;
     struct rtas_event_log_v6_hp *hp;
-    sPAPRDRConnectorClass *drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
-    sPAPRDRConnectorType drc_type = drck->get_type(drc);
 
     new_hp = g_malloc0(sizeof(struct hp_log_full));
     hdr = &new_hp->hdr;
@@ -427,8 +427,7 @@ static void spapr_hotplug_req_event(sPAPRDRConnector *drc, uint8_t hp_action)
     hp->hdr.section_length = cpu_to_be16(sizeof(*hp));
     hp->hdr.section_version = 1; /* includes extended modifier */
     hp->hotplug_action = hp_action;
-    hp->drc.index = cpu_to_be32(drck->get_index(drc));
-    hp->hotplug_identifier = RTAS_LOG_V6_HP_ID_DRC_INDEX;
+    hp->hotplug_identifier = hp_id;
 
     switch (drc_type) {
     case SPAPR_DR_CONNECTOR_TYPE_PCI:
@@ -445,19 +444,49 @@ static void spapr_hotplug_req_event(sPAPRDRConnector *drc, uint8_t hp_action)
         return;
     }
 
+    if (hp_id == RTAS_LOG_V6_HP_ID_DRC_COUNT) {
+        hp->drc.count = cpu_to_be32(drc);
+    } else if (hp_id == RTAS_LOG_V6_HP_ID_DRC_INDEX) {
+        hp->drc.index = cpu_to_be32(drc);
+    }
+
     rtas_event_log_queue(RTAS_LOG_TYPE_HOTPLUG, new_hp, true);
 
     qemu_irq_pulse(xics_get_qirq(spapr->icp, spapr->check_exception_irq));
 }
 
-void spapr_hotplug_req_add_event(sPAPRDRConnector *drc)
+void spapr_hotplug_req_add_by_index(sPAPRDRConnector *drc)
+{
+    sPAPRDRConnectorClass *drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
+    sPAPRDRConnectorType drc_type = drck->get_type(drc);
+    uint32 index = drck->get_index(drc);
+
+    spapr_hotplug_req_event(RTAS_LOG_V6_HP_ID_DRC_INDEX,
+                            RTAS_LOG_V6_HP_ACTION_ADD, drc_type, index);
+}
+
+void spapr_hotplug_req_remove_by_index(sPAPRDRConnector *drc)
+{
+    sPAPRDRConnectorClass *drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
+    sPAPRDRConnectorType drc_type = drck->get_type(drc);
+    uint32 index = drck->get_index(drc);
+
+    spapr_hotplug_req_event(RTAS_LOG_V6_HP_ID_DRC_INDEX,
+                            RTAS_LOG_V6_HP_ACTION_REMOVE, drc_type, index);
+}
+
+void spapr_hotplug_req_add_by_count(sPAPRDRConnectorType drc_type,
+                                       uint32_t count)
 {
-    spapr_hotplug_req_event(drc, RTAS_LOG_V6_HP_ACTION_ADD);
+    spapr_hotplug_req_event(RTAS_LOG_V6_HP_ID_DRC_COUNT,
+                            RTAS_LOG_V6_HP_ACTION_ADD, drc_type, count);
 }
 
-void spapr_hotplug_req_remove_event(sPAPRDRConnector *drc)
+void spapr_hotplug_req_remove_by_count(sPAPRDRConnectorType drc_type,
+                                          uint32_t count)
 {
-    spapr_hotplug_req_event(drc, RTAS_LOG_V6_HP_ACTION_REMOVE);
+    spapr_hotplug_req_event(RTAS_LOG_V6_HP_ID_DRC_COUNT,
+                            RTAS_LOG_V6_HP_ACTION_REMOVE, drc_type, count);
 }
 
 static void check_exception(PowerPCCPU *cpu, sPAPRMachineState *spapr,
diff --git a/hw/ppc/spapr_pci.c b/hw/ppc/spapr_pci.c
index d2188c8..b088491 100644
--- a/hw/ppc/spapr_pci.c
+++ b/hw/ppc/spapr_pci.c
@@ -1187,7 +1187,7 @@ static void spapr_phb_hot_plug_child(HotplugHandler *plug_handler,
         return;
     }
     if (plugged_dev->hotplugged) {
-        spapr_hotplug_req_add_event(drc);
+        spapr_hotplug_req_add_by_index(drc);
     }
 }
 
@@ -1215,7 +1215,7 @@ static void spapr_phb_hot_unplug_child(HotplugHandler *plug_handler,
             error_propagate(errp, local_err);
             return;
         }
-        spapr_hotplug_req_remove_event(drc);
+        spapr_hotplug_req_remove_by_index(drc);
     }
 }
 
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index 7d20798..ffb108d 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -594,8 +594,12 @@ int spapr_dma_dt(void *fdt, int node_off, const char *propname,
 int spapr_tcet_dma_dt(void *fdt, int node_off, const char *propname,
                       sPAPRTCETable *tcet);
 void spapr_pci_switch_vga(bool big_endian);
-void spapr_hotplug_req_add_event(sPAPRDRConnector *drc);
-void spapr_hotplug_req_remove_event(sPAPRDRConnector *drc);
+void spapr_hotplug_req_add_by_index(sPAPRDRConnector *drc);
+void spapr_hotplug_req_remove_by_index(sPAPRDRConnector *drc);
+void spapr_hotplug_req_add_by_count(sPAPRDRConnectorType drc_type,
+                                       uint32_t count);
+void spapr_hotplug_req_remove_by_count(sPAPRDRConnectorType drc_type,
+                                          uint32_t count);
 
 /* rtas-configure-connector state */
 struct sPAPRConfigureConnectorState {
-- 
2.4.3

[Qemu-devel] [PULL 31/36] spapr: Move memory hotplug to RTAS_LOG_V6_HP_ID_DRC_COUNT type

[David Gibson]

From: Bharata B Rao <bharata@linux.vnet.ibm.com>

Till now memory hotplug used RTAS_LOG_V6_HP_ID_DRC_INDEX hotplug type
which meant that we generated one hotplug type of EPOW event for every
256MB (SPAPR_MEMORY_BLOCK_SIZE). This quickly overruns the kernel
rtas log buffer thus resulting in loss of memory hotplug events. Switch
to RTAS_LOG_V6_HP_ID_DRC_COUNT hotplug type for memory so that we
generate only one event per hotplug request.

Signed-off-by: Bharata B Rao <bharata@linux.vnet.ibm.com>
Reviewed-by: Michael Roth <mdroth@linux.vnet.ibm.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index d00513f..533c7ad 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -2062,9 +2062,9 @@ static void spapr_add_lmbs(DeviceState *dev, uint64_t addr, uint64_t size,
 
         drck = SPAPR_DR_CONNECTOR_GET_CLASS(drc);
         drck->attach(drc, dev, fdt, fdt_offset, !dev->hotplugged, errp);
-        spapr_hotplug_req_add_by_index(drc);
         addr += SPAPR_MEMORY_BLOCK_SIZE;
     }
+    spapr_hotplug_req_add_by_count(SPAPR_DR_CONNECTOR_TYPE_LMB, nr_lmbs);
 }
 
 static void spapr_memory_plug(HotplugHandler *hotplug_dev, DeviceState *dev,
-- 
2.4.3

[Qemu-devel] [PULL 32/36] spapr: Fix default NUMA node allocation for threads

[David Gibson]

At present, if guest numa nodes are requested, but the cpus in each node
are not specified, spapr just uses the default behaviour or assigning each
vcpu round-robin to nodes.

If smp_threads != 1, that will assign adjacent threads in a core to
different NUMA nodes.  As well as being just weird, that's a configuration
that can't be represented in the device tree we give to the guest, which
means the guest and qemu end up with different ideas of the NUMA topology.

This patch implements mc->cpu_index_to_socket_id in the spapr code to
make sure vcpus get assigned to nodes only at the socket granularity.

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Reviewed-by: Alexey Kardashevskiy <aik@ozlabs.ru>
---
 hw/ppc/spapr.c | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 533c7ad..59fc814 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -2162,6 +2162,13 @@ static HotplugHandler *spapr_get_hotpug_handler(MachineState *machine,
     return NULL;
 }
 
+static unsigned spapr_cpu_index_to_socket_id(unsigned cpu_index)
+{
+    /* Allocate to NUMA nodes on a "socket" basis (not that concept of
+     * socket means much for the paravirtualized PAPR platform) */
+    return cpu_index / smp_threads / smp_cores;
+}
+
 static void spapr_machine_class_init(ObjectClass *oc, void *data)
 {
     MachineClass *mc = MACHINE_CLASS(oc);
@@ -2183,6 +2190,7 @@ static void spapr_machine_class_init(ObjectClass *oc, void *data)
     mc->get_hotplug_handler = spapr_get_hotpug_handler;
     hc->plug = spapr_machine_device_plug;
     hc->unplug = spapr_machine_device_unplug;
+    mc->cpu_index_to_socket_id = spapr_cpu_index_to_socket_id;
 
     smc->dr_lmb_enabled = false;
     fwc->get_dev_path = spapr_get_fw_dev_path;
-- 
2.4.3

[Qemu-devel] [PULL 33/36] ppc/spapr: Fix buffer overflow in spapr_populate_drconf_memory()

[David Gibson]

From: Thomas Huth <thuth@redhat.com>

The buffer that is allocated in spapr_populate_drconf_memory()
is used for setting both, the "ibm,dynamic-memory" and the
"ibm,associativity-lookup-arrays" property. However, only the
size of the first one is taken into account when allocating the
memory. So if the length of the second property is larger than
the length of the first one, we run into a buffer overflow here!
Fix it by taking the length of the second property into account,
too.

Fixes: "spapr: Support ibm,dynamic-reconfiguration-memory" patch
Signed-off-by: Thomas Huth <thuth@redhat.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr.c | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 59fc814..1333375 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -725,9 +725,12 @@ static int spapr_populate_drconf_memory(sPAPRMachineState *spapr, void *fdt)
     uint32_t *int_buf, *cur_index, buf_len;
     int nr_nodes = nb_numa_nodes ? nb_numa_nodes : 1;
 
-    /* Allocate enough buffer size to fit in ibm,dynamic-memory */
-    buf_len = nr_lmbs * SPAPR_DR_LMB_LIST_ENTRY_SIZE * sizeof(uint32_t) +
-                sizeof(uint32_t);
+    /*
+     * Allocate enough buffer size to fit in ibm,dynamic-memory
+     * or ibm,associativity-lookup-arrays
+     */
+    buf_len = MAX(nr_lmbs * SPAPR_DR_LMB_LIST_ENTRY_SIZE + 1, nr_nodes * 4 + 2)
+              * sizeof(uint32_t);
     cur_index = int_buf = g_malloc0(buf_len);
 
     offset = fdt_add_subnode(fdt, 0, "ibm,dynamic-reconfiguration-memory");
-- 
2.4.3

[Qemu-devel] [PULL 34/36] ppc/spapr: Implement H_RANDOM hypercall in QEMU

[David Gibson]

From: Thomas Huth <thuth@redhat.com>

The PAPR interface defines a hypercall to pass high-quality
hardware generated random numbers to guests. Recent kernels can
already provide this hypercall to the guest if the right hardware
random number generator is available. But in case the user wants
to use another source like EGD, or QEMU is running with an older
kernel, we should also have this call in QEMU, so that guests that
do not support virtio-rng yet can get good random numbers, too.

This patch now adds a new pseudo-device to QEMU that either
directly provides this hypercall to the guest or is able to
enable the in-kernel hypercall if available. The in-kernel
hypercall can be enabled with the use-kvm property, e.g.:

 qemu-system-ppc64 -device spapr-rng,use-kvm=true

For handling the hypercall in QEMU instead, a "RngBackend" is
required since the hypercall should provide "good" random data
instead of pseudo-random (like from a "simple" library function
like rand() or g_random_int()). Since there are multiple RngBackends
available, the user must select an appropriate back-end via the
"rng" property of the device, e.g.:

 qemu-system-ppc64 -object rng-random,filename=/dev/hwrng,id=gid0 \
                   -device spapr-rng,rng=gid0 ...

See http://wiki.qemu-project.org/Features-Done/VirtIORNG for
other example of specifying RngBackends.

Signed-off-by: Thomas Huth <thuth@redhat.com>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/Makefile.objs   |   2 +-
 hw/ppc/spapr.c         |   8 +++
 hw/ppc/spapr_rng.c     | 186 +++++++++++++++++++++++++++++++++++++++++++++++++
 include/hw/ppc/spapr.h |   4 ++
 target-ppc/kvm.c       |   9 +++
 target-ppc/kvm_ppc.h   |   5 ++
 6 files changed, 213 insertions(+), 1 deletion(-)
 create mode 100644 hw/ppc/spapr_rng.c

diff --git a/hw/ppc/Makefile.objs b/hw/ppc/Makefile.objs
index c8ab06e..c1ffc77 100644
--- a/hw/ppc/Makefile.objs
+++ b/hw/ppc/Makefile.objs
@@ -3,7 +3,7 @@ obj-y += ppc.o ppc_booke.o
 # IBM pSeries (sPAPR)
 obj-$(CONFIG_PSERIES) += spapr.o spapr_vio.o spapr_events.o
 obj-$(CONFIG_PSERIES) += spapr_hcall.o spapr_iommu.o spapr_rtas.o
-obj-$(CONFIG_PSERIES) += spapr_pci.o spapr_rtc.o spapr_drc.o
+obj-$(CONFIG_PSERIES) += spapr_pci.o spapr_rtc.o spapr_drc.o spapr_rng.o
 ifeq ($(CONFIG_PCI)$(CONFIG_PSERIES)$(CONFIG_LINUX), yyy)
 obj-y += spapr_pci_vfio.o
 endif
diff --git a/hw/ppc/spapr.c b/hw/ppc/spapr.c
index 1333375..7f4f196 100644
--- a/hw/ppc/spapr.c
+++ b/hw/ppc/spapr.c
@@ -883,6 +883,14 @@ static void spapr_finalize_fdt(sPAPRMachineState *spapr,
         exit(1);
     }
 
+    if (object_resolve_path_type("", TYPE_SPAPR_RNG, NULL)) {
+        ret = spapr_rng_populate_dt(fdt);
+        if (ret < 0) {
+            fprintf(stderr, "could not set up rng device in the fdt\n");
+            exit(1);
+        }
+    }
+
     QLIST_FOREACH(phb, &spapr->phbs, list) {
         ret = spapr_populate_pci_dt(phb, PHANDLE_XICP, fdt);
     }
diff --git a/hw/ppc/spapr_rng.c b/hw/ppc/spapr_rng.c
new file mode 100644
index 0000000..ed43d5e
--- /dev/null
+++ b/hw/ppc/spapr_rng.c
@@ -0,0 +1,186 @@
+/*
+ * QEMU sPAPR random number generator "device" for H_RANDOM hypercall
+ *
+ * Copyright 2015 Thomas Huth, Red Hat Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License,
+ * or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "qemu/error-report.h"
+#include "sysemu/sysemu.h"
+#include "sysemu/device_tree.h"
+#include "sysemu/rng.h"
+#include "hw/ppc/spapr.h"
+#include "kvm_ppc.h"
+
+#define SPAPR_RNG(obj) \
+    OBJECT_CHECK(sPAPRRngState, (obj), TYPE_SPAPR_RNG)
+
+struct sPAPRRngState {
+    /*< private >*/
+    DeviceState ds;
+    RngBackend *backend;
+    bool use_kvm;
+};
+typedef struct sPAPRRngState sPAPRRngState;
+
+struct HRandomData {
+    QemuSemaphore sem;
+    union {
+        uint64_t v64;
+        uint8_t v8[8];
+    } val;
+    int received;
+};
+typedef struct HRandomData HRandomData;
+
+/* Callback function for the RngBackend */
+static void random_recv(void *dest, const void *src, size_t size)
+{
+    HRandomData *hrdp = dest;
+
+    if (src && size > 0) {
+        assert(size + hrdp->received <= sizeof(hrdp->val.v8));
+        memcpy(&hrdp->val.v8[hrdp->received], src, size);
+        hrdp->received += size;
+    }
+
+    qemu_sem_post(&hrdp->sem);
+}
+
+/* Handler for the H_RANDOM hypercall */
+static target_ulong h_random(PowerPCCPU *cpu, sPAPRMachineState *spapr,
+                             target_ulong opcode, target_ulong *args)
+{
+    sPAPRRngState *rngstate;
+    HRandomData hrdata;
+
+    rngstate = SPAPR_RNG(object_resolve_path_type("", TYPE_SPAPR_RNG, NULL));
+
+    if (!rngstate || !rngstate->backend) {
+        return H_HARDWARE;
+    }
+
+    qemu_sem_init(&hrdata.sem, 0);
+    hrdata.val.v64 = 0;
+    hrdata.received = 0;
+
+    qemu_mutex_unlock_iothread();
+    while (hrdata.received < 8) {
+        rng_backend_request_entropy(rngstate->backend, 8 - hrdata.received,
+                                    random_recv, &hrdata);
+        qemu_sem_wait(&hrdata.sem);
+    }
+    qemu_mutex_lock_iothread();
+
+    qemu_sem_destroy(&hrdata.sem);
+    args[0] = hrdata.val.v64;
+
+    return H_SUCCESS;
+}
+
+static void spapr_rng_instance_init(Object *obj)
+{
+    sPAPRRngState *rngstate = SPAPR_RNG(obj);
+
+    if (object_resolve_path_type("", TYPE_SPAPR_RNG, NULL) != NULL) {
+        error_report("spapr-rng can not be instantiated twice!");
+        return;
+    }
+
+    object_property_add_link(obj, "rng", TYPE_RNG_BACKEND,
+                             (Object **)&rngstate->backend,
+                             object_property_allow_set_link,
+                             OBJ_PROP_LINK_UNREF_ON_RELEASE, NULL);
+    object_property_set_description(obj, "rng",
+                                    "ID of the random number generator backend",
+                                    NULL);
+}
+
+static void spapr_rng_realize(DeviceState *dev, Error **errp)
+{
+
+    sPAPRRngState *rngstate = SPAPR_RNG(dev);
+
+    if (rngstate->use_kvm) {
+        if (kvmppc_enable_hwrng() == 0) {
+            return;
+        }
+        /*
+         * If user specified both, use-kvm and a backend, we fall back to
+         * the backend now. If not, provide an appropriate error message.
+         */
+        if (!rngstate->backend) {
+            error_setg(errp, "Could not initialize in-kernel H_RANDOM call!");
+            return;
+        }
+    }
+
+    if (rngstate->backend) {
+        spapr_register_hypercall(H_RANDOM, h_random);
+    } else {
+        error_setg(errp, "spapr-rng needs an RNG backend!");
+    }
+}
+
+int spapr_rng_populate_dt(void *fdt)
+{
+    int node;
+    int ret;
+
+    node = qemu_fdt_add_subnode(fdt, "/ibm,platform-facilities");
+    if (node <= 0) {
+        return -1;
+    }
+    ret = fdt_setprop_string(fdt, node, "device_type",
+                             "ibm,platform-facilities");
+    ret |= fdt_setprop_cell(fdt, node, "#address-cells", 0x1);
+    ret |= fdt_setprop_cell(fdt, node, "#size-cells", 0x0);
+
+    node = fdt_add_subnode(fdt, node, "ibm,random-v1");
+    if (node <= 0) {
+        return -1;
+    }
+    ret |= fdt_setprop_string(fdt, node, "compatible", "ibm,random");
+
+    return ret ? -1 : 0;
+}
+
+static Property spapr_rng_properties[] = {
+    DEFINE_PROP_BOOL("use-kvm", sPAPRRngState, use_kvm, false),
+    DEFINE_PROP_END_OF_LIST(),
+};
+
+static void spapr_rng_class_init(ObjectClass *oc, void *data)
+{
+    DeviceClass *dc = DEVICE_CLASS(oc);
+
+    dc->realize = spapr_rng_realize;
+    set_bit(DEVICE_CATEGORY_MISC, dc->categories);
+    dc->props = spapr_rng_properties;
+}
+
+static const TypeInfo spapr_rng_info = {
+    .name          = TYPE_SPAPR_RNG,
+    .parent        = TYPE_DEVICE,
+    .instance_size = sizeof(sPAPRRngState),
+    .instance_init = spapr_rng_instance_init,
+    .class_init    = spapr_rng_class_init,
+};
+
+static void spapr_rng_register_type(void)
+{
+    type_register_static(&spapr_rng_info);
+}
+type_init(spapr_rng_register_type)
diff --git a/include/hw/ppc/spapr.h b/include/hw/ppc/spapr.h
index ffb108d..56c5b0b 100644
--- a/include/hw/ppc/spapr.h
+++ b/include/hw/ppc/spapr.h
@@ -334,6 +334,7 @@ struct sPAPRMachineState {
 #define H_SET_MPP               0x2D0
 #define H_GET_MPP               0x2D4
 #define H_XIRR_X                0x2FC
+#define H_RANDOM                0x300
 #define H_SET_MODE              0x31C
 #define MAX_HCALL_OPCODE        H_SET_MODE
 
@@ -612,10 +613,13 @@ struct sPAPRConfigureConnectorState {
 void spapr_ccs_reset_hook(void *opaque);
 
 #define TYPE_SPAPR_RTC "spapr-rtc"
+#define TYPE_SPAPR_RNG "spapr-rng"
 
 void spapr_rtc_read(DeviceState *dev, struct tm *tm, uint32_t *ns);
 int spapr_rtc_import_offset(DeviceState *dev, int64_t legacy_offset);
 
+int spapr_rng_populate_dt(void *fdt);
+
 #define SPAPR_MEMORY_BLOCK_SIZE (1 << 28) /* 256MB */
 
 /*
diff --git a/target-ppc/kvm.c b/target-ppc/kvm.c
index 9cf5308..e641680 100644
--- a/target-ppc/kvm.c
+++ b/target-ppc/kvm.c
@@ -2489,3 +2489,12 @@ int kvm_arch_msi_data_to_gsi(uint32_t data)
 {
     return data & 0xffff;
 }
+
+int kvmppc_enable_hwrng(void)
+{
+    if (!kvm_enabled() || !kvm_check_extension(kvm_state, KVM_CAP_PPC_HWRNG)) {
+        return -1;
+    }
+
+    return kvmppc_enable_hcall(kvm_state, H_RANDOM);
+}
diff --git a/target-ppc/kvm_ppc.h b/target-ppc/kvm_ppc.h
index f790d50..470f6d6 100644
--- a/target-ppc/kvm_ppc.h
+++ b/target-ppc/kvm_ppc.h
@@ -54,6 +54,7 @@ void kvmppc_hash64_free_pteg(uint64_t token);
 void kvmppc_hash64_write_pte(CPUPPCState *env, target_ulong pte_index,
                              target_ulong pte0, target_ulong pte1);
 bool kvmppc_has_cap_fixup_hcalls(void);
+int kvmppc_enable_hwrng(void);
 
 #else
 
@@ -251,6 +252,10 @@ static inline bool kvmppc_has_cap_fixup_hcalls(void)
     abort();
 }
 
+static inline int kvmppc_enable_hwrng(void)
+{
+    return -1;
+}
 #endif
 
 #ifndef CONFIG_KVM
-- 
2.4.3

[Qemu-devel] [PULL 35/36] sPAPR: Revert don't enable EEH on emulated PCI devices

[David Gibson]

From: Gavin Shan <gwshan@linux.vnet.ibm.com>

This reverts commit 7cb18007 ("sPAPR: Don't enable EEH on emulated
PCI devices") as rtas_ibm_set_eeh_option() isn't the right place
to check if there has the corresponding PCI device for the input
address, which can be PE address, not PCI device address.

Signed-off-by: Gavin Shan <gwshan@linux.vnet.ibm.com>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_pci.c | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/hw/ppc/spapr_pci.c b/hw/ppc/spapr_pci.c
index b088491..617b7f3 100644
--- a/hw/ppc/spapr_pci.c
+++ b/hw/ppc/spapr_pci.c
@@ -431,7 +431,6 @@ static void rtas_ibm_set_eeh_option(PowerPCCPU *cpu,
 {
     sPAPRPHBState *sphb;
     sPAPRPHBClass *spc;
-    PCIDevice *pdev;
     uint32_t addr, option;
     uint64_t buid;
     int ret;
@@ -449,12 +448,6 @@ static void rtas_ibm_set_eeh_option(PowerPCCPU *cpu,
         goto param_error_exit;
     }
 
-    pdev = pci_find_device(PCI_HOST_BRIDGE(sphb)->bus,
-                           (addr >> 16) & 0xFF, (addr >> 8) & 0xFF);
-    if (!pdev || !object_dynamic_cast(OBJECT(pdev), "vfio-pci")) {
-        goto param_error_exit;
-    }
-
     spc = SPAPR_PCI_HOST_BRIDGE_GET_CLASS(sphb);
     if (!spc->eeh_set_option) {
         goto param_error_exit;
-- 
2.4.3

[Qemu-devel] [PULL 36/36] sPAPR: Enable EEH on VFIO PCI device only

[David Gibson]

From: Gavin Shan <gwshan@linux.vnet.ibm.com>

This checks if the PCI device retrieved from the PCI device address
is VFIO PCI device when enabling EEH functionality. If it's not
VFIO PCI device, the EEH functonality isn't enabled.

Signed-off-by: Gavin Shan <gwshan@linux.vnet.ibm.com>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
---
 hw/ppc/spapr_pci_vfio.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/hw/ppc/spapr_pci_vfio.c b/hw/ppc/spapr_pci_vfio.c
index cca45ed..a61b418 100644
--- a/hw/ppc/spapr_pci_vfio.c
+++ b/hw/ppc/spapr_pci_vfio.c
@@ -117,7 +117,7 @@ static int spapr_phb_vfio_eeh_set_option(sPAPRPHBState *sphb,
         phb = PCI_HOST_BRIDGE(sphb);
         pdev = pci_find_device(phb->bus,
                                (addr >> 16) & 0xFF, (addr >> 8) & 0xFF);
-        if (!pdev) {
+        if (!pdev || !object_dynamic_cast(OBJECT(pdev), "vfio-pci")) {
             return RTAS_OUT_PARAM_ERROR;
         }
 
-- 
2.4.3

Re: [Qemu-devel] [PULL 00/36] spapr-next queue 20150923

[Peter Maydell]

On 22 September 2015 at 18:55, David Gibson <david@gibson.dropbear.id.au> wrote:
> The following changes since commit 27c7275a56948f48f536e2d1599b22355f5714ac:
>
>   Merge remote-tracking branch 'remotes/kraxel/tags/pull-ipxe-20150903-1' into staging (2015-09-22 19:22:23 +0100)
>
> are available in the git repository at:
>
>   git://github.com/dgibson/qemu.git tags/spapr-next-20150923
>
> for you to fetch changes up to d76548a98f4e18d3c65a3d921bbb70caf9be6138:
>
>   sPAPR: Enable EEH on VFIO PCI device only (2015-09-23 10:51:11 +1000)
>
> Apologies for the breakage in the previous pull request, this should fix it.
>
> ----------------------------------------------------------------
> sPAPR Patch Queue: 2015-09-23
>
> Highlights:
>     * pseries-2.5 machine type
>     * Memory hotplug for "pseries" guests
>     * Fixes to the PAPR Dynamic Reconfiguration hotplug code
>     * Several PAPR compliance fixes
>     * New SLOF with:
>         * GPT support
>         * Much faster VGA handling
>

Applied, thanks.

-- PMM