xref: /qemu/include/sysemu/numa.h (revision 0a5b5acd)
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 
8 struct 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 */
18 enum {
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 */
27 enum {
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 
39 struct NodeInfo {
40     uint64_t node_mem;
41     struct HostMemoryBackend *node_memdev;
42     bool present;
43     bool has_cpu;
44     bool has_gi;
45     uint8_t lb_info_provided;
46     uint16_t initiator;
47     uint8_t distance[MAX_NODES];
48 };
49 
50 struct NumaNodeMem {
51     uint64_t node_mem;
52     uint64_t node_plugged_mem;
53 };
54 
55 struct HMAT_LB_Data {
56     uint8_t     initiator;
57     uint8_t     target;
58     uint64_t    data;
59 };
60 typedef struct HMAT_LB_Data HMAT_LB_Data;
61 
62 struct HMAT_LB_Info {
63     /* Indicates it's memory or the specified level memory side cache. */
64     uint8_t     hierarchy;
65 
66     /* Present the type of data, access/read/write latency or bandwidth. */
67     uint8_t     data_type;
68 
69     /* The range bitmap of bandwidth for calculating common base */
70     uint64_t    range_bitmap;
71 
72     /* The common base unit for latencies or bandwidths */
73     uint64_t    base;
74 
75     /* Array to store the latencies or bandwidths */
76     GArray      *list;
77 };
78 typedef struct HMAT_LB_Info HMAT_LB_Info;
79 
80 struct NumaState {
81     /* Number of NUMA nodes */
82     int num_nodes;
83 
84     /* Allow setting NUMA distance for different NUMA nodes */
85     bool have_numa_distance;
86 
87     /* Detect if HMAT support is enabled. */
88     bool hmat_enabled;
89 
90     /* NUMA nodes information */
91     NodeInfo nodes[MAX_NODES];
92 
93     /* NUMA nodes HMAT Locality Latency and Bandwidth Information */
94     HMAT_LB_Info *hmat_lb[HMAT_LB_LEVELS][HMAT_LB_TYPES];
95 
96     /* Memory Side Cache Information Structure */
97     NumaHmatCacheOptions *hmat_cache[MAX_NODES][HMAT_LB_LEVELS];
98 };
99 typedef struct NumaState NumaState;
100 
101 void set_numa_options(MachineState *ms, NumaOptions *object, Error **errp);
102 void parse_numa_opts(MachineState *ms);
103 void parse_numa_hmat_lb(NumaState *numa_state, NumaHmatLBOptions *node,
104                         Error **errp);
105 void parse_numa_hmat_cache(MachineState *ms, NumaHmatCacheOptions *node,
106                            Error **errp);
107 void numa_complete_configuration(MachineState *ms);
108 void query_numa_node_mem(NumaNodeMem node_mem[], MachineState *ms);
109 extern QemuOptsList qemu_numa_opts;
110 void numa_cpu_pre_plug(const struct CPUArchId *slot, DeviceState *dev,
111                        Error **errp);
112 bool numa_uses_legacy_mem(void);
113 
114 #endif
115