cachepc-qemu

Fork of AMDESE/qemu with changes for cachepc side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-qemu
Log | Files | Refs | Submodules | LICENSE | sfeed.txt

nvdimm.h (5064B)


      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 * NVDIMM specifications and some documents can be found at:
     10 * NVDIMM ACPI device and NFIT are introduced in ACPI 6:
     11 *      http://www.uefi.org/sites/default/files/resources/ACPI_6.0.pdf
     12 * NVDIMM Namespace specification:
     13 *      http://pmem.io/documents/NVDIMM_Namespace_Spec.pdf
     14 * DSM Interface Example:
     15 *      http://pmem.io/documents/NVDIMM_DSM_Interface_Example.pdf
     16 * Driver Writer's Guide:
     17 *      http://pmem.io/documents/NVDIMM_Driver_Writers_Guide.pdf
     18 *
     19 * This work is licensed under the terms of the GNU GPL, version 2 or later.
     20 * See the COPYING file in the top-level directory.
     21 */
     22
     23#ifndef QEMU_NVDIMM_H
     24#define QEMU_NVDIMM_H
     25
     26#include "hw/mem/pc-dimm.h"
     27#include "hw/acpi/bios-linker-loader.h"
     28#include "qemu/uuid.h"
     29#include "hw/acpi/aml-build.h"
     30#include "qom/object.h"
     31
     32#define NVDIMM_DEBUG 0
     33#define nvdimm_debug(fmt, ...)                                \
     34    do {                                                      \
     35        if (NVDIMM_DEBUG) {                                   \
     36            fprintf(stderr, "nvdimm: " fmt, ## __VA_ARGS__);  \
     37        }                                                     \
     38    } while (0)
     39
     40/*
     41 * The minimum label data size is required by NVDIMM Namespace
     42 * specification, see the chapter 2 Namespaces:
     43 *   "NVDIMMs following the NVDIMM Block Mode Specification use an area
     44 *    at least 128KB in size, which holds around 1000 labels."
     45 */
     46#define MIN_NAMESPACE_LABEL_SIZE      (128UL << 10)
     47
     48#define TYPE_NVDIMM      "nvdimm"
     49OBJECT_DECLARE_TYPE(NVDIMMDevice, NVDIMMClass, NVDIMM)
     50
     51#define NVDIMM_LABEL_SIZE_PROP "label-size"
     52#define NVDIMM_UUID_PROP       "uuid"
     53#define NVDIMM_UNARMED_PROP    "unarmed"
     54
     55struct NVDIMMDevice {
     56    /* private */
     57    PCDIMMDevice parent_obj;
     58
     59    /* public */
     60
     61    /*
     62     * the size of label data in NVDIMM device which is presented to
     63     * guest via __DSM "Get Namespace Label Size" function.
     64     */
     65    uint64_t label_size;
     66
     67    /*
     68     * the address of label data which is read by __DSM "Get Namespace
     69     * Label Data" function and written by __DSM "Set Namespace Label
     70     * Data" function.
     71     */
     72    void *label_data;
     73
     74    /*
     75     * it's the PMEM region in NVDIMM device, which is presented to
     76     * guest via ACPI NFIT and _FIT method if NVDIMM hotplug is supported.
     77     */
     78    MemoryRegion *nvdimm_mr;
     79
     80    /*
     81     * The 'on' value results in the unarmed flag set in ACPI NFIT,
     82     * which can be used to notify guest implicitly that the host
     83     * backend (e.g., files on HDD, /dev/pmemX, etc.) cannot guarantee
     84     * the guest write persistence.
     85     */
     86    bool unarmed;
     87
     88    /*
     89     * The PPC64 - spapr requires each nvdimm device have a uuid.
     90     */
     91    QemuUUID uuid;
     92};
     93
     94struct NVDIMMClass {
     95    /* private */
     96    PCDIMMDeviceClass parent_class;
     97
     98    /* public */
     99
    100    /* read @size bytes from NVDIMM label data at @offset into @buf. */
    101    void (*read_label_data)(NVDIMMDevice *nvdimm, void *buf,
    102                            uint64_t size, uint64_t offset);
    103    /* write @size bytes from @buf to NVDIMM label data at @offset. */
    104    void (*write_label_data)(NVDIMMDevice *nvdimm, const void *buf,
    105                             uint64_t size, uint64_t offset);
    106};
    107
    108#define NVDIMM_DSM_MEM_FILE     "etc/acpi/nvdimm-mem"
    109
    110/*
    111 * 32 bits IO port starting from 0x0a18 in guest is reserved for
    112 * NVDIMM ACPI emulation.
    113 */
    114#define NVDIMM_ACPI_IO_BASE     0x0a18
    115#define NVDIMM_ACPI_IO_LEN      4
    116
    117/*
    118 * NvdimmFitBuffer:
    119 * @fit: FIT structures for present NVDIMMs. It is updated when
    120 *   the NVDIMM device is plugged or unplugged.
    121 * @dirty: It allows OSPM to detect change and restart read in
    122 *   progress if there is any.
    123 */
    124struct NvdimmFitBuffer {
    125    GArray *fit;
    126    bool dirty;
    127};
    128typedef struct NvdimmFitBuffer NvdimmFitBuffer;
    129
    130struct NVDIMMState {
    131    /* detect if NVDIMM support is enabled. */
    132    bool is_enabled;
    133
    134    /* the data of the fw_cfg file NVDIMM_DSM_MEM_FILE. */
    135    GArray *dsm_mem;
    136
    137    NvdimmFitBuffer fit_buf;
    138
    139    /* the IO region used by OSPM to transfer control to QEMU. */
    140    MemoryRegion io_mr;
    141
    142    /*
    143     * Platform capabilities, section 5.2.25.9 of ACPI 6.2 Errata A
    144     */
    145    int32_t persistence;
    146    char    *persistence_string;
    147    struct AcpiGenericAddress dsm_io;
    148};
    149typedef struct NVDIMMState NVDIMMState;
    150
    151void nvdimm_init_acpi_state(NVDIMMState *state, MemoryRegion *io,
    152                            struct AcpiGenericAddress dsm_io,
    153                            FWCfgState *fw_cfg, Object *owner);
    154void nvdimm_build_srat(GArray *table_data);
    155void nvdimm_build_acpi(GArray *table_offsets, GArray *table_data,
    156                       BIOSLinker *linker, NVDIMMState *state,
    157                       uint32_t ram_slots, const char *oem_id,
    158                       const char *oem_table_id);
    159void nvdimm_plug(NVDIMMState *state);
    160void nvdimm_acpi_plug_cb(HotplugHandler *hotplug_dev, DeviceState *dev);
    161#endif