xref: /qemu/include/hw/mem/pc-dimm.h (revision 52ea63de)
1 /*
2  * PC DIMM device
3  *
4  * Copyright ProfitBricks GmbH 2012
5  * Copyright (C) 2013-2014 Red Hat Inc
6  *
7  * Authors:
8  *  Vasilis Liaskovitis <vasilis.liaskovitis@profitbricks.com>
9  *  Igor Mammedov <imammedo@redhat.com>
10  *
11  * This work is licensed under the terms of the GNU GPL, version 2 or later.
12  * See the COPYING file in the top-level directory.
13  *
14  */
15 
16 #ifndef QEMU_PC_DIMM_H
17 #define QEMU_PC_DIMM_H
18 
19 #include "exec/memory.h"
20 #include "sysemu/hostmem.h"
21 #include "hw/qdev.h"
22 
23 #define TYPE_PC_DIMM "pc-dimm"
24 #define PC_DIMM(obj) \
25     OBJECT_CHECK(PCDIMMDevice, (obj), TYPE_PC_DIMM)
26 #define PC_DIMM_CLASS(oc) \
27     OBJECT_CLASS_CHECK(PCDIMMDeviceClass, (oc), TYPE_PC_DIMM)
28 #define PC_DIMM_GET_CLASS(obj) \
29     OBJECT_GET_CLASS(PCDIMMDeviceClass, (obj), TYPE_PC_DIMM)
30 
31 #define PC_DIMM_ADDR_PROP "addr"
32 #define PC_DIMM_SLOT_PROP "slot"
33 #define PC_DIMM_NODE_PROP "node"
34 #define PC_DIMM_SIZE_PROP "size"
35 #define PC_DIMM_MEMDEV_PROP "memdev"
36 
37 #define PC_DIMM_UNASSIGNED_SLOT -1
38 
39 /**
40  * PCDIMMDevice:
41  * @addr: starting guest physical address, where @PCDIMMDevice is mapped.
42  *         Default value: 0, means that address is auto-allocated.
43  * @node: numa node to which @PCDIMMDevice is attached.
44  * @slot: slot number into which @PCDIMMDevice is plugged in.
45  *        Default value: -1, means that slot is auto-allocated.
46  * @hostmem: host memory backend providing memory for @PCDIMMDevice
47  */
48 typedef struct PCDIMMDevice {
49     /* private */
50     DeviceState parent_obj;
51 
52     /* public */
53     uint64_t addr;
54     uint32_t node;
55     int32_t slot;
56     HostMemoryBackend *hostmem;
57 } PCDIMMDevice;
58 
59 /**
60  * PCDIMMDeviceClass:
61  * @realize: called after common dimm is realized so that the dimm based
62  * devices get the chance to do specified operations.
63  * @get_memory_region: returns #MemoryRegion associated with @dimm which
64  * is directly mapped into the physical address space of guest
65  */
66 typedef struct PCDIMMDeviceClass {
67     /* private */
68     DeviceClass parent_class;
69 
70     /* public */
71     void (*realize)(PCDIMMDevice *dimm, Error **errp);
72     MemoryRegion *(*get_memory_region)(PCDIMMDevice *dimm);
73 } PCDIMMDeviceClass;
74 
75 /**
76  * MemoryHotplugState:
77  * @base: address in guest physical address space where hotplug memory
78  * address space begins.
79  * @mr: hotplug memory address space container
80  */
81 typedef struct MemoryHotplugState {
82     hwaddr base;
83     MemoryRegion mr;
84 } MemoryHotplugState;
85 
86 uint64_t pc_dimm_get_free_addr(uint64_t address_space_start,
87                                uint64_t address_space_size,
88                                uint64_t *hint, uint64_t align, uint64_t size,
89                                Error **errp);
90 
91 int pc_dimm_get_free_slot(const int *hint, int max_slots, Error **errp);
92 
93 int qmp_pc_dimm_device_list(Object *obj, void *opaque);
94 uint64_t pc_existing_dimms_capacity(Error **errp);
95 void pc_dimm_memory_plug(DeviceState *dev, MemoryHotplugState *hpms,
96                          MemoryRegion *mr, uint64_t align, Error **errp);
97 void pc_dimm_memory_unplug(DeviceState *dev, MemoryHotplugState *hpms,
98                            MemoryRegion *mr);
99 #endif
100