xref: /linux/Documentation/ABI/stable/sysfs-devices-node (revision 08d9dbe72b1f899468b2b34f9309e88a84f440f2)
15bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/possible
25bbe1ec1SDavidlohr BuesoDate:		October 2002
35bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
45bbe1ec1SDavidlohr BuesoDescription:
55bbe1ec1SDavidlohr Bueso		Nodes that could be possibly become online at some point.
65bbe1ec1SDavidlohr Bueso
75bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/online
85bbe1ec1SDavidlohr BuesoDate:		October 2002
95bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
105bbe1ec1SDavidlohr BuesoDescription:
115bbe1ec1SDavidlohr Bueso		Nodes that are online.
125bbe1ec1SDavidlohr Bueso
135bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/has_normal_memory
145bbe1ec1SDavidlohr BuesoDate:		October 2002
155bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
165bbe1ec1SDavidlohr BuesoDescription:
175bbe1ec1SDavidlohr Bueso		Nodes that have regular memory.
185bbe1ec1SDavidlohr Bueso
195bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/has_cpu
205bbe1ec1SDavidlohr BuesoDate:		October 2002
215bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
225bbe1ec1SDavidlohr BuesoDescription:
235bbe1ec1SDavidlohr Bueso		Nodes that have one or more CPUs.
245bbe1ec1SDavidlohr Bueso
255bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/has_high_memory
265bbe1ec1SDavidlohr BuesoDate:		October 2002
275bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
285bbe1ec1SDavidlohr BuesoDescription:
295bbe1ec1SDavidlohr Bueso		Nodes that have regular or high memory.
305bbe1ec1SDavidlohr Bueso		Depends on CONFIG_HIGHMEM.
315bbe1ec1SDavidlohr Bueso
32e7c84ee2SMel GormanWhat:		/sys/devices/system/node/nodeX
33e7c84ee2SMel GormanDate:		October 2002
34e7c84ee2SMel GormanContact:	Linux Memory Management list <linux-mm@kvack.org>
35e7c84ee2SMel GormanDescription:
36e7c84ee2SMel Gorman		When CONFIG_NUMA is enabled, this is a directory containing
37e7c84ee2SMel Gorman		information on node X such as what CPUs are local to the
385bbe1ec1SDavidlohr Bueso		node. Each file is detailed next.
395bbe1ec1SDavidlohr Bueso
405bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/cpumap
415bbe1ec1SDavidlohr BuesoDate:		October 2002
425bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
435bbe1ec1SDavidlohr BuesoDescription:
445bbe1ec1SDavidlohr Bueso		The node's cpumap.
455bbe1ec1SDavidlohr Bueso
465bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/cpulist
475bbe1ec1SDavidlohr BuesoDate:		October 2002
485bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
495bbe1ec1SDavidlohr BuesoDescription:
505bbe1ec1SDavidlohr Bueso		The CPUs associated to the node.
515bbe1ec1SDavidlohr Bueso
525bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/meminfo
535bbe1ec1SDavidlohr BuesoDate:		October 2002
545bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
555bbe1ec1SDavidlohr BuesoDescription:
565bbe1ec1SDavidlohr Bueso		Provides information about the node's distribution and memory
575bbe1ec1SDavidlohr Bueso		utilization. Similar to /proc/meminfo, see Documentation/filesystems/proc.txt
585bbe1ec1SDavidlohr Bueso
595bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/numastat
605bbe1ec1SDavidlohr BuesoDate:		October 2002
615bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
625bbe1ec1SDavidlohr BuesoDescription:
635bbe1ec1SDavidlohr Bueso		The node's hit/miss statistics, in units of pages.
645bbe1ec1SDavidlohr Bueso		See Documentation/numastat.txt
655bbe1ec1SDavidlohr Bueso
665bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/distance
675bbe1ec1SDavidlohr BuesoDate:		October 2002
685bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
695bbe1ec1SDavidlohr BuesoDescription:
705bbe1ec1SDavidlohr Bueso		Distance between the node and all the other nodes
715bbe1ec1SDavidlohr Bueso		in the system.
725bbe1ec1SDavidlohr Bueso
735bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/vmstat
745bbe1ec1SDavidlohr BuesoDate:		October 2002
755bbe1ec1SDavidlohr BuesoContact:	Linux Memory Management list <linux-mm@kvack.org>
765bbe1ec1SDavidlohr BuesoDescription:
775bbe1ec1SDavidlohr Bueso		The node's zoned virtual memory statistics.
785bbe1ec1SDavidlohr Bueso		This is a superset of numastat.
795bbe1ec1SDavidlohr Bueso
805bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/compact
815bbe1ec1SDavidlohr BuesoDate:		February 2010
825bbe1ec1SDavidlohr BuesoContact:	Mel Gorman <mel@csn.ul.ie>
835bbe1ec1SDavidlohr BuesoDescription:
845bbe1ec1SDavidlohr Bueso		When this file is written to, all memory within that node
855bbe1ec1SDavidlohr Bueso		will be compacted. When it completes, memory will be freed
865bbe1ec1SDavidlohr Bueso		into blocks which have as many contiguous pages as possible
875bbe1ec1SDavidlohr Bueso
885bbe1ec1SDavidlohr BuesoWhat:		/sys/devices/system/node/nodeX/hugepages/hugepages-<size>/
895bbe1ec1SDavidlohr BuesoDate:		December 2009
905bbe1ec1SDavidlohr BuesoContact:	Lee Schermerhorn <lee.schermerhorn@hp.com>
915bbe1ec1SDavidlohr BuesoDescription:
925bbe1ec1SDavidlohr Bueso		The node's huge page size control/query attributes.
931ad1335dSMike Rapoport		See Documentation/admin-guide/mm/hugetlbpage.rst
94*08d9dbe7SKeith Busch
95*08d9dbe7SKeith BuschWhat:		/sys/devices/system/node/nodeX/accessY/
96*08d9dbe7SKeith BuschDate:		December 2018
97*08d9dbe7SKeith BuschContact:	Keith Busch <keith.busch@intel.com>
98*08d9dbe7SKeith BuschDescription:
99*08d9dbe7SKeith Busch		The node's relationship to other nodes for access class "Y".
100*08d9dbe7SKeith Busch
101*08d9dbe7SKeith BuschWhat:		/sys/devices/system/node/nodeX/accessY/initiators/
102*08d9dbe7SKeith BuschDate:		December 2018
103*08d9dbe7SKeith BuschContact:	Keith Busch <keith.busch@intel.com>
104*08d9dbe7SKeith BuschDescription:
105*08d9dbe7SKeith Busch		The directory containing symlinks to memory initiator
106*08d9dbe7SKeith Busch		nodes that have class "Y" access to this target node's
107*08d9dbe7SKeith Busch		memory. CPUs and other memory initiators in nodes not in
108*08d9dbe7SKeith Busch		the list accessing this node's memory may have different
109*08d9dbe7SKeith Busch		performance.
110*08d9dbe7SKeith Busch
111*08d9dbe7SKeith BuschWhat:		/sys/devices/system/node/nodeX/accessY/targets/
112*08d9dbe7SKeith BuschDate:		December 2018
113*08d9dbe7SKeith BuschContact:	Keith Busch <keith.busch@intel.com>
114*08d9dbe7SKeith BuschDescription:
115*08d9dbe7SKeith Busch		The directory containing symlinks to memory targets that
116*08d9dbe7SKeith Busch		this initiator node has class "Y" access.
117