]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | /* |
3 | * include/linux/node.h - generic node definition | |
4 | * | |
5 | * This is mainly for topological representation. We define the | |
6 | * basic 'struct node' here, which can be embedded in per-arch | |
7 | * definitions of processors. | |
8 | * | |
9 | * Basic handling of the devices is done in drivers/base/node.c | |
10 | * and system devices are handled in drivers/base/sys.c. | |
11 | * | |
12 | * Nodes are exported via driverfs in the class/node/devices/ | |
13 | * directory. | |
1da177e4 LT |
14 | */ |
15 | #ifndef _LINUX_NODE_H_ | |
16 | #define _LINUX_NODE_H_ | |
17 | ||
10fbcf4c | 18 | #include <linux/device.h> |
1da177e4 | 19 | #include <linux/cpumask.h> |
08d9dbe7 | 20 | #include <linux/list.h> |
39da08cb | 21 | #include <linux/workqueue.h> |
1da177e4 | 22 | |
e1cf33aa KB |
23 | /** |
24 | * struct node_hmem_attrs - heterogeneous memory performance attributes | |
25 | * | |
26 | * @read_bandwidth: Read bandwidth in MB/s | |
27 | * @write_bandwidth: Write bandwidth in MB/s | |
28 | * @read_latency: Read latency in nanoseconds | |
29 | * @write_latency: Write latency in nanoseconds | |
30 | */ | |
31 | struct node_hmem_attrs { | |
32 | unsigned int read_bandwidth; | |
33 | unsigned int write_bandwidth; | |
34 | unsigned int read_latency; | |
35 | unsigned int write_latency; | |
36 | }; | |
37 | ||
acc02a10 KB |
38 | enum cache_indexing { |
39 | NODE_CACHE_DIRECT_MAP, | |
40 | NODE_CACHE_INDEXED, | |
41 | NODE_CACHE_OTHER, | |
42 | }; | |
43 | ||
44 | enum cache_write_policy { | |
45 | NODE_CACHE_WRITE_BACK, | |
46 | NODE_CACHE_WRITE_THROUGH, | |
47 | NODE_CACHE_WRITE_OTHER, | |
48 | }; | |
49 | ||
50 | /** | |
51 | * struct node_cache_attrs - system memory caching attributes | |
52 | * | |
53 | * @indexing: The ways memory blocks may be placed in cache | |
54 | * @write_policy: Write back or write through policy | |
55 | * @size: Total size of cache in bytes | |
56 | * @line_size: Number of bytes fetched on a cache miss | |
57 | * @level: The cache hierarchy level | |
58 | */ | |
59 | struct node_cache_attrs { | |
60 | enum cache_indexing indexing; | |
61 | enum cache_write_policy write_policy; | |
62 | u64 size; | |
63 | u16 line_size; | |
64 | u8 level; | |
65 | }; | |
66 | ||
e1cf33aa | 67 | #ifdef CONFIG_HMEM_REPORTING |
acc02a10 | 68 | void node_add_cache(unsigned int nid, struct node_cache_attrs *cache_attrs); |
e1cf33aa KB |
69 | void node_set_perf_attrs(unsigned int nid, struct node_hmem_attrs *hmem_attrs, |
70 | unsigned access); | |
71 | #else | |
acc02a10 KB |
72 | static inline void node_add_cache(unsigned int nid, |
73 | struct node_cache_attrs *cache_attrs) | |
74 | { | |
75 | } | |
76 | ||
e1cf33aa KB |
77 | static inline void node_set_perf_attrs(unsigned int nid, |
78 | struct node_hmem_attrs *hmem_attrs, | |
79 | unsigned access) | |
80 | { | |
81 | } | |
82 | #endif | |
83 | ||
1da177e4 | 84 | struct node { |
10fbcf4c | 85 | struct device dev; |
08d9dbe7 | 86 | struct list_head access_list; |
39da08cb LS |
87 | |
88 | #if defined(CONFIG_MEMORY_HOTPLUG_SPARSE) && defined(CONFIG_HUGETLBFS) | |
89 | struct work_struct node_work; | |
90 | #endif | |
acc02a10 KB |
91 | #ifdef CONFIG_HMEM_REPORTING |
92 | struct list_head cache_attrs; | |
93 | struct device *cache_dev; | |
94 | #endif | |
1da177e4 LT |
95 | }; |
96 | ||
c04fc586 | 97 | struct memory_block; |
8732794b | 98 | extern struct node *node_devices[]; |
9a305230 | 99 | typedef void (*node_registration_func_t)(struct node *); |
0fc44159 | 100 | |
9037a993 | 101 | #if defined(CONFIG_MEMORY_HOTPLUG_SPARSE) && defined(CONFIG_NUMA) |
a2155861 | 102 | extern int link_mem_sections(int nid, unsigned long start_pfn, |
4fbce633 | 103 | unsigned long end_pfn); |
9037a993 | 104 | #else |
a2155861 | 105 | static inline int link_mem_sections(int nid, unsigned long start_pfn, |
4fbce633 | 106 | unsigned long end_pfn) |
9037a993 MH |
107 | { |
108 | return 0; | |
109 | } | |
110 | #endif | |
111 | ||
4b45099b | 112 | extern void unregister_node(struct node *node); |
36920e06 | 113 | #ifdef CONFIG_NUMA |
9037a993 MH |
114 | /* Core of the node registration - only memory hotplug should use this */ |
115 | extern int __register_one_node(int nid); | |
116 | ||
117 | /* Registers an online node */ | |
118 | static inline int register_one_node(int nid) | |
119 | { | |
120 | int error = 0; | |
121 | ||
122 | if (node_online(nid)) { | |
123 | struct pglist_data *pgdat = NODE_DATA(nid); | |
4fbce633 OS |
124 | unsigned long start_pfn = pgdat->node_start_pfn; |
125 | unsigned long end_pfn = start_pfn + pgdat->node_spanned_pages; | |
9037a993 MH |
126 | |
127 | error = __register_one_node(nid); | |
128 | if (error) | |
129 | return error; | |
130 | /* link memory sections under this node */ | |
4fbce633 | 131 | error = link_mem_sections(nid, start_pfn, end_pfn); |
9037a993 MH |
132 | } |
133 | ||
134 | return error; | |
135 | } | |
136 | ||
0fc44159 | 137 | extern void unregister_one_node(int nid); |
76b67ed9 KH |
138 | extern int register_cpu_under_node(unsigned int cpu, unsigned int nid); |
139 | extern int unregister_cpu_under_node(unsigned int cpu, unsigned int nid); | |
a31b264c | 140 | extern void unregister_memory_block_under_nodes(struct memory_block *mem_blk); |
9a305230 | 141 | |
08d9dbe7 KB |
142 | extern int register_memory_node_under_compute_node(unsigned int mem_nid, |
143 | unsigned int cpu_nid, | |
144 | unsigned access); | |
145 | ||
9a305230 LS |
146 | #ifdef CONFIG_HUGETLBFS |
147 | extern void register_hugetlbfs_with_node(node_registration_func_t doregister, | |
148 | node_registration_func_t unregister); | |
149 | #endif | |
76b67ed9 | 150 | #else |
9037a993 MH |
151 | static inline int __register_one_node(int nid) |
152 | { | |
153 | return 0; | |
154 | } | |
36920e06 KH |
155 | static inline int register_one_node(int nid) |
156 | { | |
157 | return 0; | |
158 | } | |
159 | static inline int unregister_one_node(int nid) | |
160 | { | |
161 | return 0; | |
162 | } | |
76b67ed9 KH |
163 | static inline int register_cpu_under_node(unsigned int cpu, unsigned int nid) |
164 | { | |
165 | return 0; | |
166 | } | |
167 | static inline int unregister_cpu_under_node(unsigned int cpu, unsigned int nid) | |
168 | { | |
169 | return 0; | |
170 | } | |
a31b264c | 171 | static inline void unregister_memory_block_under_nodes(struct memory_block *mem_blk) |
c04fc586 | 172 | { |
c04fc586 | 173 | } |
9a305230 LS |
174 | |
175 | static inline void register_hugetlbfs_with_node(node_registration_func_t reg, | |
176 | node_registration_func_t unreg) | |
177 | { | |
178 | } | |
76b67ed9 | 179 | #endif |
1da177e4 | 180 | |
10fbcf4c | 181 | #define to_node(device) container_of(device, struct node, dev) |
1da177e4 LT |
182 | |
183 | #endif /* _LINUX_NODE_H_ */ |