1 What: /sys/devices/system/node/possi 1 What: /sys/devices/system/node/possible
2 Date: October 2002 2 Date: October 2002
3 Contact: Linux Memory Management list <l 3 Contact: Linux Memory Management list <linux-mm@kvack.org>
4 Description: 4 Description:
5 Nodes that could be possibly b 5 Nodes that could be possibly become online at some point.
6 6
7 What: /sys/devices/system/node/onlin 7 What: /sys/devices/system/node/online
8 Date: October 2002 8 Date: October 2002
9 Contact: Linux Memory Management list <l 9 Contact: Linux Memory Management list <linux-mm@kvack.org>
10 Description: 10 Description:
11 Nodes that are online. 11 Nodes that are online.
12 12
13 What: /sys/devices/system/node/has_n 13 What: /sys/devices/system/node/has_normal_memory
14 Date: October 2002 14 Date: October 2002
15 Contact: Linux Memory Management list <l 15 Contact: Linux Memory Management list <linux-mm@kvack.org>
16 Description: 16 Description:
17 Nodes that have regular memory 17 Nodes that have regular memory.
18 18
19 What: /sys/devices/system/node/has_c 19 What: /sys/devices/system/node/has_cpu
20 Date: October 2002 20 Date: October 2002
21 Contact: Linux Memory Management list <l 21 Contact: Linux Memory Management list <linux-mm@kvack.org>
22 Description: 22 Description:
23 Nodes that have one or more CP 23 Nodes that have one or more CPUs.
24 24
25 What: /sys/devices/system/node/has_h 25 What: /sys/devices/system/node/has_high_memory
26 Date: October 2002 26 Date: October 2002
27 Contact: Linux Memory Management list <l 27 Contact: Linux Memory Management list <linux-mm@kvack.org>
28 Description: 28 Description:
29 Nodes that have regular or hig 29 Nodes that have regular or high memory.
30 Depends on CONFIG_HIGHMEM. 30 Depends on CONFIG_HIGHMEM.
31 31
32 What: /sys/devices/system/node/nodeX 32 What: /sys/devices/system/node/nodeX
33 Date: October 2002 33 Date: October 2002
34 Contact: Linux Memory Management list <l 34 Contact: Linux Memory Management list <linux-mm@kvack.org>
35 Description: 35 Description:
36 When CONFIG_NUMA is enabled, t 36 When CONFIG_NUMA is enabled, this is a directory containing
37 information on node X such as 37 information on node X such as what CPUs are local to the
38 node. Each file is detailed ne 38 node. Each file is detailed next.
39 39
40 What: /sys/devices/system/node/nodeX 40 What: /sys/devices/system/node/nodeX/cpumap
41 Date: October 2002 41 Date: October 2002
42 Contact: Linux Memory Management list <l 42 Contact: Linux Memory Management list <linux-mm@kvack.org>
43 Description: 43 Description:
44 The node's cpumap. 44 The node's cpumap.
45 45
46 What: /sys/devices/system/node/nodeX 46 What: /sys/devices/system/node/nodeX/cpulist
47 Date: October 2002 47 Date: October 2002
48 Contact: Linux Memory Management list <l 48 Contact: Linux Memory Management list <linux-mm@kvack.org>
49 Description: 49 Description:
50 The CPUs associated to the nod 50 The CPUs associated to the node.
51 51
52 What: /sys/devices/system/node/nodeX 52 What: /sys/devices/system/node/nodeX/meminfo
53 Date: October 2002 53 Date: October 2002
54 Contact: Linux Memory Management list <l 54 Contact: Linux Memory Management list <linux-mm@kvack.org>
55 Description: 55 Description:
56 Provides information about the 56 Provides information about the node's distribution and memory
57 utilization. Similar to /proc/ 57 utilization. Similar to /proc/meminfo, see Documentation/filesystems/proc.rst
58 58
59 What: /sys/devices/system/node/nodeX 59 What: /sys/devices/system/node/nodeX/numastat
60 Date: October 2002 60 Date: October 2002
61 Contact: Linux Memory Management list <l 61 Contact: Linux Memory Management list <linux-mm@kvack.org>
62 Description: 62 Description:
63 The node's hit/miss statistics 63 The node's hit/miss statistics, in units of pages.
64 See Documentation/admin-guide/ 64 See Documentation/admin-guide/numastat.rst
65 65
66 What: /sys/devices/system/node/nodeX 66 What: /sys/devices/system/node/nodeX/distance
67 Date: October 2002 67 Date: October 2002
68 Contact: Linux Memory Management list <l 68 Contact: Linux Memory Management list <linux-mm@kvack.org>
69 Description: 69 Description:
70 Distance between the node and 70 Distance between the node and all the other nodes
71 in the system. 71 in the system.
72 72
73 What: /sys/devices/system/node/nodeX 73 What: /sys/devices/system/node/nodeX/vmstat
74 Date: October 2002 74 Date: October 2002
75 Contact: Linux Memory Management list <l 75 Contact: Linux Memory Management list <linux-mm@kvack.org>
76 Description: 76 Description:
77 The node's zoned virtual memor 77 The node's zoned virtual memory statistics.
78 This is a superset of numastat 78 This is a superset of numastat.
79 79
80 What: /sys/devices/system/node/nodeX 80 What: /sys/devices/system/node/nodeX/compact
81 Date: February 2010 81 Date: February 2010
82 Contact: Mel Gorman <mel@csn.ul.ie> 82 Contact: Mel Gorman <mel@csn.ul.ie>
83 Description: 83 Description:
84 When this file is written to, 84 When this file is written to, all memory within that node
85 will be compacted. When it com 85 will be compacted. When it completes, memory will be freed
86 into blocks which have as many 86 into blocks which have as many contiguous pages as possible
87 87
88 What: /sys/devices/system/node/nodeX 88 What: /sys/devices/system/node/nodeX/hugepages/hugepages-<size>/
89 Date: December 2009 89 Date: December 2009
90 Contact: Lee Schermerhorn <lee.schermerh 90 Contact: Lee Schermerhorn <lee.schermerhorn@hp.com>
91 Description: 91 Description:
92 The node's huge page size cont 92 The node's huge page size control/query attributes.
93 See Documentation/admin-guide/ 93 See Documentation/admin-guide/mm/hugetlbpage.rst
94 94
95 What: /sys/devices/system/node/nodeX 95 What: /sys/devices/system/node/nodeX/accessY/
96 Date: December 2018 96 Date: December 2018
97 Contact: Keith Busch <keith.busch@intel. 97 Contact: Keith Busch <keith.busch@intel.com>
98 Description: 98 Description:
99 The node's relationship to oth 99 The node's relationship to other nodes for access class "Y".
100 100
101 What: /sys/devices/system/node/nodeX 101 What: /sys/devices/system/node/nodeX/accessY/initiators/
102 Date: December 2018 102 Date: December 2018
103 Contact: Keith Busch <keith.busch@intel. 103 Contact: Keith Busch <keith.busch@intel.com>
104 Description: 104 Description:
105 The directory containing symli 105 The directory containing symlinks to memory initiator
106 nodes that have class "Y" acce 106 nodes that have class "Y" access to this target node's
107 memory. CPUs and other memory 107 memory. CPUs and other memory initiators in nodes not in
108 the list accessing this node's 108 the list accessing this node's memory may have different
109 performance. 109 performance.
110 110
111 What: /sys/devices/system/node/nodeX 111 What: /sys/devices/system/node/nodeX/accessY/targets/
112 Date: December 2018 112 Date: December 2018
113 Contact: Keith Busch <keith.busch@intel. 113 Contact: Keith Busch <keith.busch@intel.com>
114 Description: 114 Description:
115 The directory containing symli 115 The directory containing symlinks to memory targets that
116 this initiator node has class 116 this initiator node has class "Y" access.
117 117
118 What: /sys/devices/system/node/nodeX 118 What: /sys/devices/system/node/nodeX/accessY/initiators/read_bandwidth
119 Date: December 2018 119 Date: December 2018
120 Contact: Keith Busch <keith.busch@intel. 120 Contact: Keith Busch <keith.busch@intel.com>
121 Description: 121 Description:
122 This node's read bandwidth in 122 This node's read bandwidth in MB/s when accessed from
123 nodes found in this access cla 123 nodes found in this access class's linked initiators.
124 124
125 What: /sys/devices/system/node/nodeX 125 What: /sys/devices/system/node/nodeX/accessY/initiators/read_latency
126 Date: December 2018 126 Date: December 2018
127 Contact: Keith Busch <keith.busch@intel. 127 Contact: Keith Busch <keith.busch@intel.com>
128 Description: 128 Description:
129 This node's read latency in na 129 This node's read latency in nanoseconds when accessed
130 from nodes found in this acces 130 from nodes found in this access class's linked initiators.
131 131
132 What: /sys/devices/system/node/nodeX 132 What: /sys/devices/system/node/nodeX/accessY/initiators/write_bandwidth
133 Date: December 2018 133 Date: December 2018
134 Contact: Keith Busch <keith.busch@intel. 134 Contact: Keith Busch <keith.busch@intel.com>
135 Description: 135 Description:
136 This node's write bandwidth in 136 This node's write bandwidth in MB/s when accessed from
137 found in this access class's l 137 found in this access class's linked initiators.
138 138
139 What: /sys/devices/system/node/nodeX 139 What: /sys/devices/system/node/nodeX/accessY/initiators/write_latency
140 Date: December 2018 140 Date: December 2018
141 Contact: Keith Busch <keith.busch@intel. 141 Contact: Keith Busch <keith.busch@intel.com>
142 Description: 142 Description:
143 This node's write latency in n 143 This node's write latency in nanoseconds when access
144 from nodes found in this class 144 from nodes found in this class's linked initiators.
145 145
146 What: /sys/devices/system/node/nodeX 146 What: /sys/devices/system/node/nodeX/memory_side_cache/indexY/
147 Date: December 2018 147 Date: December 2018
148 Contact: Keith Busch <keith.busch@intel. 148 Contact: Keith Busch <keith.busch@intel.com>
149 Description: 149 Description:
150 The directory containing attri 150 The directory containing attributes for the memory-side cache
151 level 'Y'. 151 level 'Y'.
152 152
153 What: /sys/devices/system/node/nodeX 153 What: /sys/devices/system/node/nodeX/memory_side_cache/indexY/indexing
154 Date: December 2018 154 Date: December 2018
155 Contact: Keith Busch <keith.busch@intel. 155 Contact: Keith Busch <keith.busch@intel.com>
156 Description: 156 Description:
157 The caches associativity index 157 The caches associativity indexing: 0 for direct mapped,
158 non-zero if indexed. 158 non-zero if indexed.
159 159
160 What: /sys/devices/system/node/nodeX 160 What: /sys/devices/system/node/nodeX/memory_side_cache/indexY/line_size
161 Date: December 2018 161 Date: December 2018
162 Contact: Keith Busch <keith.busch@intel. 162 Contact: Keith Busch <keith.busch@intel.com>
163 Description: 163 Description:
164 The number of bytes accessed f 164 The number of bytes accessed from the next cache level on a
165 cache miss. 165 cache miss.
166 166
167 What: /sys/devices/system/node/nodeX 167 What: /sys/devices/system/node/nodeX/memory_side_cache/indexY/size
168 Date: December 2018 168 Date: December 2018
169 Contact: Keith Busch <keith.busch@intel. 169 Contact: Keith Busch <keith.busch@intel.com>
170 Description: 170 Description:
171 The size of this memory side c 171 The size of this memory side cache in bytes.
172 172
173 What: /sys/devices/system/node/nodeX 173 What: /sys/devices/system/node/nodeX/memory_side_cache/indexY/write_policy
174 Date: December 2018 174 Date: December 2018
175 Contact: Keith Busch <keith.busch@intel. 175 Contact: Keith Busch <keith.busch@intel.com>
176 Description: 176 Description:
177 The cache write policy: 0 for 177 The cache write policy: 0 for write-back, 1 for write-through,
178 other or unknown. 178 other or unknown.
179 179
180 What: /sys/devices/system/node/nodeX 180 What: /sys/devices/system/node/nodeX/x86/sgx_total_bytes
181 Date: November 2021 181 Date: November 2021
182 Contact: Jarkko Sakkinen <jarkko@kernel. 182 Contact: Jarkko Sakkinen <jarkko@kernel.org>
183 Description: 183 Description:
184 The total amount of SGX physic 184 The total amount of SGX physical memory in bytes.
185 185
186 What: /sys/devices/system/node/nodeX 186 What: /sys/devices/system/node/nodeX/memory_failure/total
187 Date: January 2023 187 Date: January 2023
188 Contact: Jiaqi Yan <jiaqiyan@google.com> 188 Contact: Jiaqi Yan <jiaqiyan@google.com>
189 Description: 189 Description:
190 The total number of raw poison 190 The total number of raw poisoned pages (pages containing
191 corrupted data due to memory e 191 corrupted data due to memory errors) on a NUMA node.
192 192
193 What: /sys/devices/system/node/nodeX 193 What: /sys/devices/system/node/nodeX/memory_failure/ignored
194 Date: January 2023 194 Date: January 2023
195 Contact: Jiaqi Yan <jiaqiyan@google.com> 195 Contact: Jiaqi Yan <jiaqiyan@google.com>
196 Description: 196 Description:
197 Of the raw poisoned pages on a 197 Of the raw poisoned pages on a NUMA node, how many pages are
198 ignored by memory error recove 198 ignored by memory error recovery attempt, usually because
199 support for this type of pages 199 support for this type of pages is unavailable, and kernel
200 gives up the recovery. 200 gives up the recovery.
201 201
202 What: /sys/devices/system/node/nodeX 202 What: /sys/devices/system/node/nodeX/memory_failure/failed
203 Date: January 2023 203 Date: January 2023
204 Contact: Jiaqi Yan <jiaqiyan@google.com> 204 Contact: Jiaqi Yan <jiaqiyan@google.com>
205 Description: 205 Description:
206 Of the raw poisoned pages on a 206 Of the raw poisoned pages on a NUMA node, how many pages are
207 failed by memory error recover 207 failed by memory error recovery attempt. This usually means
208 a key recovery operation faile 208 a key recovery operation failed.
209 209
210 What: /sys/devices/system/node/nodeX 210 What: /sys/devices/system/node/nodeX/memory_failure/delayed
211 Date: January 2023 211 Date: January 2023
212 Contact: Jiaqi Yan <jiaqiyan@google.com> 212 Contact: Jiaqi Yan <jiaqiyan@google.com>
213 Description: 213 Description:
214 Of the raw poisoned pages on a 214 Of the raw poisoned pages on a NUMA node, how many pages are
215 delayed by memory error recove 215 delayed by memory error recovery attempt. Delayed poisoned
216 pages usually will be retried 216 pages usually will be retried by kernel.
217 217
218 What: /sys/devices/system/node/nodeX 218 What: /sys/devices/system/node/nodeX/memory_failure/recovered
219 Date: January 2023 219 Date: January 2023
220 Contact: Jiaqi Yan <jiaqiyan@google.com> 220 Contact: Jiaqi Yan <jiaqiyan@google.com>
221 Description: 221 Description:
222 Of the raw poisoned pages on a 222 Of the raw poisoned pages on a NUMA node, how many pages are
223 recovered by memory error reco 223 recovered by memory error recovery attempt.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.