LXR qemu/include/sysemu/numa.h

   1#ifndef SYSEMU_NUMA_H
   2#define SYSEMU_NUMA_H
   3
   4#include "qemu/bitmap.h"
   5#include "qapi/qapi-types-machine.h"
   6#include "exec/cpu-common.h"
   7
   8struct CPUArchId;
   9
  10#define MAX_NODES 128
  11#define NUMA_NODE_UNASSIGNED MAX_NODES
  12#define NUMA_DISTANCE_MIN         10
  13#define NUMA_DISTANCE_DEFAULT     20
  14#define NUMA_DISTANCE_MAX         254
  15#define NUMA_DISTANCE_UNREACHABLE 255
  16
  17/* the value of AcpiHmatLBInfo flags */
  18enum {
  19    HMAT_LB_MEM_MEMORY           = 0,
  20    HMAT_LB_MEM_CACHE_1ST_LEVEL  = 1,
  21    HMAT_LB_MEM_CACHE_2ND_LEVEL  = 2,
  22    HMAT_LB_MEM_CACHE_3RD_LEVEL  = 3,
  23    HMAT_LB_LEVELS   /* must be the last entry */
  24};
  25
  26/* the value of AcpiHmatLBInfo data type */
  27enum {
  28    HMAT_LB_DATA_ACCESS_LATENCY   = 0,
  29    HMAT_LB_DATA_READ_LATENCY     = 1,
  30    HMAT_LB_DATA_WRITE_LATENCY    = 2,
  31    HMAT_LB_DATA_ACCESS_BANDWIDTH = 3,
  32    HMAT_LB_DATA_READ_BANDWIDTH   = 4,
  33    HMAT_LB_DATA_WRITE_BANDWIDTH  = 5,
  34    HMAT_LB_TYPES   /* must be the last entry */
  35};
  36
  37#define UINT16_BITS       16
  38
  39struct NodeInfo {
  40    uint64_t node_mem;
  41    struct HostMemoryBackend *node_memdev;
  42    bool present;
  43    bool has_cpu;
  44    uint8_t lb_info_provided;
  45    uint16_t initiator;
  46    uint8_t distance[MAX_NODES];
  47};
  48
  49struct NumaNodeMem {
  50    uint64_t node_mem;
  51    uint64_t node_plugged_mem;
  52};
  53
  54struct HMAT_LB_Data {
  55    uint8_t     initiator;
  56    uint8_t     target;
  57    uint64_t    data;
  58};
  59typedef struct HMAT_LB_Data HMAT_LB_Data;
  60
  61struct HMAT_LB_Info {
  62    /* Indicates it's memory or the specified level memory side cache. */
  63    uint8_t     hierarchy;
  64
  65    /* Present the type of data, access/read/write latency or bandwidth. */
  66    uint8_t     data_type;
  67
  68    /* The range bitmap of bandwidth for calculating common base */
  69    uint64_t    range_bitmap;
  70
  71    /* The common base unit for latencies or bandwidths */
  72    uint64_t    base;
  73
  74    /* Array to store the latencies or bandwidths */
  75    GArray      *list;
  76};
  77typedef struct HMAT_LB_Info HMAT_LB_Info;
  78
  79struct NumaState {
  80    /* Number of NUMA nodes */
  81    int num_nodes;
  82
  83    /* Allow setting NUMA distance for different NUMA nodes */
  84    bool have_numa_distance;
  85
  86    /* Detect if HMAT support is enabled. */
  87    bool hmat_enabled;
  88
  89    /* NUMA nodes information */
  90    NodeInfo nodes[MAX_NODES];
  91
  92    /* NUMA nodes HMAT Locality Latency and Bandwidth Information */
  93    HMAT_LB_Info *hmat_lb[HMAT_LB_LEVELS][HMAT_LB_TYPES];
  94
  95    /* Memory Side Cache Information Structure */
  96    NumaHmatCacheOptions *hmat_cache[MAX_NODES][HMAT_LB_LEVELS];
  97};
  98typedef struct NumaState NumaState;
  99
 100void set_numa_options(MachineState *ms, NumaOptions *object, Error **errp);
 101void parse_numa_opts(MachineState *ms);
 102void parse_numa_hmat_lb(NumaState *numa_state, NumaHmatLBOptions *node,
 103                        Error **errp);
 104void parse_numa_hmat_cache(MachineState *ms, NumaHmatCacheOptions *node,
 105                           Error **errp);
 106void numa_complete_configuration(MachineState *ms);
 107void query_numa_node_mem(NumaNodeMem node_mem[], MachineState *ms);
 108extern QemuOptsList qemu_numa_opts;
 109void numa_cpu_pre_plug(const struct CPUArchId *slot, DeviceState *dev,
 110                       Error **errp);
 111bool numa_uses_legacy_mem(void);
 112
 113#endif
 114