qemu/hw/mem/nvdimm.c
<<
>>
Prefs
   1/*
   2 * Non-Volatile Dual In-line Memory Module Virtualization Implementation
   3 *
   4 * Copyright(C) 2015 Intel Corporation.
   5 *
   6 * Author:
   7 *  Xiao Guangrong <guangrong.xiao@linux.intel.com>
   8 *
   9 * Currently, it only supports PMEM Virtualization.
  10 *
  11 * This library is free software; you can redistribute it and/or
  12 * modify it under the terms of the GNU Lesser General Public
  13 * License as published by the Free Software Foundation; either
  14 * version 2.1 of the License, or (at your option) any later version.
  15 *
  16 * This library is distributed in the hope that it will be useful,
  17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19 * Lesser General Public License for more details.
  20 *
  21 * You should have received a copy of the GNU Lesser General Public
  22 * License along with this library; if not, see <http://www.gnu.org/licenses/>
  23 */
  24
  25#include "qemu/osdep.h"
  26#include "qemu/module.h"
  27#include "qemu/pmem.h"
  28#include "qapi/error.h"
  29#include "qapi/visitor.h"
  30#include "hw/mem/nvdimm.h"
  31#include "hw/qdev-properties.h"
  32#include "hw/mem/memory-device.h"
  33#include "sysemu/hostmem.h"
  34
  35static void nvdimm_get_label_size(Object *obj, Visitor *v, const char *name,
  36                                  void *opaque, Error **errp)
  37{
  38    NVDIMMDevice *nvdimm = NVDIMM(obj);
  39    uint64_t value = nvdimm->label_size;
  40
  41    visit_type_size(v, name, &value, errp);
  42}
  43
  44static void nvdimm_set_label_size(Object *obj, Visitor *v, const char *name,
  45                                  void *opaque, Error **errp)
  46{
  47    NVDIMMDevice *nvdimm = NVDIMM(obj);
  48    uint64_t value;
  49
  50    if (nvdimm->nvdimm_mr) {
  51        error_setg(errp, "cannot change property value");
  52        return;
  53    }
  54
  55    if (!visit_type_size(v, name, &value, errp)) {
  56        return;
  57    }
  58    if (value < MIN_NAMESPACE_LABEL_SIZE) {
  59        error_setg(errp, "Property '%s.%s' (0x%" PRIx64 ") is required"
  60                   " at least 0x%lx", object_get_typename(obj), name, value,
  61                   MIN_NAMESPACE_LABEL_SIZE);
  62        return;
  63    }
  64
  65    nvdimm->label_size = value;
  66}
  67
  68static void nvdimm_get_uuid(Object *obj, Visitor *v, const char *name,
  69                                  void *opaque, Error **errp)
  70{
  71    NVDIMMDevice *nvdimm = NVDIMM(obj);
  72    char *value = NULL;
  73
  74    value = qemu_uuid_unparse_strdup(&nvdimm->uuid);
  75
  76    visit_type_str(v, name, &value, errp);
  77    g_free(value);
  78}
  79
  80
  81static void nvdimm_set_uuid(Object *obj, Visitor *v, const char *name,
  82                                  void *opaque, Error **errp)
  83{
  84    NVDIMMDevice *nvdimm = NVDIMM(obj);
  85    char *value;
  86
  87    if (!visit_type_str(v, name, &value, errp)) {
  88        return;
  89    }
  90
  91    if (qemu_uuid_parse(value, &nvdimm->uuid) != 0) {
  92        error_setg(errp, "Property '%s.%s' has invalid value",
  93                   object_get_typename(obj), name);
  94    }
  95
  96    g_free(value);
  97}
  98
  99
 100static void nvdimm_init(Object *obj)
 101{
 102    object_property_add(obj, NVDIMM_LABEL_SIZE_PROP, "int",
 103                        nvdimm_get_label_size, nvdimm_set_label_size, NULL,
 104                        NULL);
 105
 106    object_property_add(obj, NVDIMM_UUID_PROP, "QemuUUID", nvdimm_get_uuid,
 107                        nvdimm_set_uuid, NULL, NULL);
 108}
 109
 110static void nvdimm_finalize(Object *obj)
 111{
 112    NVDIMMDevice *nvdimm = NVDIMM(obj);
 113
 114    g_free(nvdimm->nvdimm_mr);
 115}
 116
 117static void nvdimm_prepare_memory_region(NVDIMMDevice *nvdimm, Error **errp)
 118{
 119    PCDIMMDevice *dimm = PC_DIMM(nvdimm);
 120    uint64_t align, pmem_size, size;
 121    MemoryRegion *mr;
 122
 123    g_assert(!nvdimm->nvdimm_mr);
 124
 125    if (!dimm->hostmem) {
 126        error_setg(errp, "'" PC_DIMM_MEMDEV_PROP "' property must be set");
 127        return;
 128    }
 129
 130    mr = host_memory_backend_get_memory(dimm->hostmem);
 131    align = memory_region_get_alignment(mr);
 132    size = memory_region_size(mr);
 133
 134    pmem_size = size - nvdimm->label_size;
 135    nvdimm->label_data = memory_region_get_ram_ptr(mr) + pmem_size;
 136    pmem_size = QEMU_ALIGN_DOWN(pmem_size, align);
 137
 138    if (size <= nvdimm->label_size || !pmem_size) {
 139        HostMemoryBackend *hostmem = dimm->hostmem;
 140
 141        error_setg(errp, "the size of memdev %s (0x%" PRIx64 ") is too "
 142                   "small to contain nvdimm label (0x%" PRIx64 ") and "
 143                   "aligned PMEM (0x%" PRIx64 ")",
 144                   object_get_canonical_path_component(OBJECT(hostmem)),
 145                   memory_region_size(mr), nvdimm->label_size, align);
 146        return;
 147    }
 148
 149    if (!nvdimm->unarmed && memory_region_is_rom(mr)) {
 150        HostMemoryBackend *hostmem = dimm->hostmem;
 151
 152        error_setg(errp, "'unarmed' property must be off since memdev %s "
 153                   "is read-only",
 154                   object_get_canonical_path_component(OBJECT(hostmem)));
 155        return;
 156    }
 157
 158    nvdimm->nvdimm_mr = g_new(MemoryRegion, 1);
 159    memory_region_init_alias(nvdimm->nvdimm_mr, OBJECT(dimm),
 160                             "nvdimm-memory", mr, 0, pmem_size);
 161    memory_region_set_nonvolatile(nvdimm->nvdimm_mr, true);
 162    nvdimm->nvdimm_mr->align = align;
 163}
 164
 165static MemoryRegion *nvdimm_md_get_memory_region(MemoryDeviceState *md,
 166                                                 Error **errp)
 167{
 168    NVDIMMDevice *nvdimm = NVDIMM(md);
 169    Error *local_err = NULL;
 170
 171    if (!nvdimm->nvdimm_mr) {
 172        nvdimm_prepare_memory_region(nvdimm, &local_err);
 173        if (local_err) {
 174            error_propagate(errp, local_err);
 175            return NULL;
 176        }
 177    }
 178    return nvdimm->nvdimm_mr;
 179}
 180
 181static void nvdimm_realize(PCDIMMDevice *dimm, Error **errp)
 182{
 183    NVDIMMDevice *nvdimm = NVDIMM(dimm);
 184
 185    if (!nvdimm->nvdimm_mr) {
 186        nvdimm_prepare_memory_region(nvdimm, errp);
 187    }
 188}
 189
 190/*
 191 * the caller should check the input parameters before calling
 192 * label read/write functions.
 193 */
 194static void nvdimm_validate_rw_label_data(NVDIMMDevice *nvdimm, uint64_t size,
 195                                        uint64_t offset)
 196{
 197    assert((nvdimm->label_size >= size + offset) && (offset + size > offset));
 198}
 199
 200static void nvdimm_read_label_data(NVDIMMDevice *nvdimm, void *buf,
 201                                   uint64_t size, uint64_t offset)
 202{
 203    nvdimm_validate_rw_label_data(nvdimm, size, offset);
 204
 205    memcpy(buf, nvdimm->label_data + offset, size);
 206}
 207
 208static void nvdimm_write_label_data(NVDIMMDevice *nvdimm, const void *buf,
 209                                    uint64_t size, uint64_t offset)
 210{
 211    MemoryRegion *mr;
 212    PCDIMMDevice *dimm = PC_DIMM(nvdimm);
 213    bool is_pmem = object_property_get_bool(OBJECT(dimm->hostmem),
 214                                            "pmem", NULL);
 215    uint64_t backend_offset;
 216
 217    nvdimm_validate_rw_label_data(nvdimm, size, offset);
 218
 219    if (!is_pmem) {
 220        memcpy(nvdimm->label_data + offset, buf, size);
 221    } else {
 222        pmem_memcpy_persist(nvdimm->label_data + offset, buf, size);
 223    }
 224
 225    mr = host_memory_backend_get_memory(dimm->hostmem);
 226    backend_offset = memory_region_size(mr) - nvdimm->label_size + offset;
 227    memory_region_set_dirty(mr, backend_offset, size);
 228}
 229
 230static Property nvdimm_properties[] = {
 231    DEFINE_PROP_BOOL(NVDIMM_UNARMED_PROP, NVDIMMDevice, unarmed, false),
 232    DEFINE_PROP_END_OF_LIST(),
 233};
 234
 235static void nvdimm_class_init(ObjectClass *oc, void *data)
 236{
 237    PCDIMMDeviceClass *ddc = PC_DIMM_CLASS(oc);
 238    MemoryDeviceClass *mdc = MEMORY_DEVICE_CLASS(oc);
 239    NVDIMMClass *nvc = NVDIMM_CLASS(oc);
 240    DeviceClass *dc = DEVICE_CLASS(oc);
 241
 242    ddc->realize = nvdimm_realize;
 243    mdc->get_memory_region = nvdimm_md_get_memory_region;
 244    device_class_set_props(dc, nvdimm_properties);
 245
 246    nvc->read_label_data = nvdimm_read_label_data;
 247    nvc->write_label_data = nvdimm_write_label_data;
 248    set_bit(DEVICE_CATEGORY_STORAGE, dc->categories);
 249}
 250
 251static TypeInfo nvdimm_info = {
 252    .name          = TYPE_NVDIMM,
 253    .parent        = TYPE_PC_DIMM,
 254    .class_size    = sizeof(NVDIMMClass),
 255    .class_init    = nvdimm_class_init,
 256    .instance_size = sizeof(NVDIMMDevice),
 257    .instance_init = nvdimm_init,
 258    .instance_finalize = nvdimm_finalize,
 259};
 260
 261static void nvdimm_register_types(void)
 262{
 263    type_register_static(&nvdimm_info);
 264}
 265
 266type_init(nvdimm_register_types)
 267