Commit 5bbe1ec11fcf08af086ae214cdd4f4da0f25ca46
Committed by
Linus Torvalds
Linus Torvalds
1 parent
5413dfba88
Documentation: ABI: /sys/devices/system/node/
Describe NUMA node sysfs files/attributes. Note that for the specific dates and contacts I couldn't find, I left it as default for Oct 2002 and linux-mm. Signed-off-by: Davidlohr Bueso <davidlohr.bueso@hp.com> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Showing 1 changed file with 95 additions and 1 deletions Side-by-side Diff
Documentation/ABI/stable/sysfs-devices-node
| 1 | +What: /sys/devices/system/node/possible | |
| 2 | +Date: October 2002 | |
| 3 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 4 | +Description: | |
| 5 | + Nodes that could be possibly become online at some point. | |
| 6 | + | |
| 7 | +What: /sys/devices/system/node/online | |
| 8 | +Date: October 2002 | |
| 9 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 10 | +Description: | |
| 11 | + Nodes that are online. | |
| 12 | + | |
| 13 | +What: /sys/devices/system/node/has_normal_memory | |
| 14 | +Date: October 2002 | |
| 15 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 16 | +Description: | |
| 17 | + Nodes that have regular memory. | |
| 18 | + | |
| 19 | +What: /sys/devices/system/node/has_cpu | |
| 20 | +Date: October 2002 | |
| 21 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 22 | +Description: | |
| 23 | + Nodes that have one or more CPUs. | |
| 24 | + | |
| 25 | +What: /sys/devices/system/node/has_high_memory | |
| 26 | +Date: October 2002 | |
| 27 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 28 | +Description: | |
| 29 | + Nodes that have regular or high memory. | |
| 30 | + Depends on CONFIG_HIGHMEM. | |
| 31 | + | |
| 1 | 32 | What: /sys/devices/system/node/nodeX |
| 2 | 33 | Date: October 2002 |
| 3 | 34 | Contact: Linux Memory Management list <linux-mm@kvack.org> |
| 4 | 35 | Description: |
| 5 | 36 | When CONFIG_NUMA is enabled, this is a directory containing |
| 6 | 37 | information on node X such as what CPUs are local to the |
| 7 | - node. | |
| 38 | + node. Each file is detailed next. | |
| 39 | + | |
| 40 | +What: /sys/devices/system/node/nodeX/cpumap | |
| 41 | +Date: October 2002 | |
| 42 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 43 | +Description: | |
| 44 | + The node's cpumap. | |
| 45 | + | |
| 46 | +What: /sys/devices/system/node/nodeX/cpulist | |
| 47 | +Date: October 2002 | |
| 48 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 49 | +Description: | |
| 50 | + The CPUs associated to the node. | |
| 51 | + | |
| 52 | +What: /sys/devices/system/node/nodeX/meminfo | |
| 53 | +Date: October 2002 | |
| 54 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 55 | +Description: | |
| 56 | + Provides information about the node's distribution and memory | |
| 57 | + utilization. Similar to /proc/meminfo, see Documentation/filesystems/proc.txt | |
| 58 | + | |
| 59 | +What: /sys/devices/system/node/nodeX/numastat | |
| 60 | +Date: October 2002 | |
| 61 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 62 | +Description: | |
| 63 | + The node's hit/miss statistics, in units of pages. | |
| 64 | + See Documentation/numastat.txt | |
| 65 | + | |
| 66 | +What: /sys/devices/system/node/nodeX/distance | |
| 67 | +Date: October 2002 | |
| 68 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 69 | +Description: | |
| 70 | + Distance between the node and all the other nodes | |
| 71 | + in the system. | |
| 72 | + | |
| 73 | +What: /sys/devices/system/node/nodeX/vmstat | |
| 74 | +Date: October 2002 | |
| 75 | +Contact: Linux Memory Management list <linux-mm@kvack.org> | |
| 76 | +Description: | |
| 77 | + The node's zoned virtual memory statistics. | |
| 78 | + This is a superset of numastat. | |
| 79 | + | |
| 80 | +What: /sys/devices/system/node/nodeX/compact | |
| 81 | +Date: February 2010 | |
| 82 | +Contact: Mel Gorman <mel@csn.ul.ie> | |
| 83 | +Description: | |
| 84 | + When this file is written to, all memory within that node | |
| 85 | + will be compacted. When it completes, memory will be freed | |
| 86 | + into blocks which have as many contiguous pages as possible | |
| 87 | + | |
| 88 | +What: /sys/devices/system/node/nodeX/scan_unevictable_pages | |
| 89 | +Date: October 2008 | |
| 90 | +Contact: Lee Schermerhorn <lee.schermerhorn@hp.com> | |
| 91 | +Description: | |
| 92 | + When set, it triggers scanning the node's unevictable lists | |
| 93 | + and move any pages that have become evictable onto the respective | |
| 94 | + zone's inactive list. See mm/vmscan.c | |
| 95 | + | |
| 96 | +What: /sys/devices/system/node/nodeX/hugepages/hugepages-<size>/ | |
| 97 | +Date: December 2009 | |
| 98 | +Contact: Lee Schermerhorn <lee.schermerhorn@hp.com> | |
| 99 | +Description: | |
| 100 | + The node's huge page size control/query attributes. | |
| 101 | + See Documentation/vm/hugetlbpage.txt |