[PATCH] Documentation: ABI: /sys/devices/system/node/

2012-12-10 Thread Davidlohr Bueso
Describe NUMA node sysfs files/attributes.

Signed-off-by: Davidlohr Bueso 
---
Note that for the specific dates and contacts I couldn't find,
I left it as default for Oct 2002 and linux-mm.

 Documentation/ABI/stable/sysfs-devices-node | 96 -
 1 file changed, 95 insertions(+), 1 deletion(-)

diff --git a/Documentation/ABI/stable/sysfs-devices-node 
b/Documentation/ABI/stable/sysfs-devices-node
index 49b82ca..ce259c1 100644
--- a/Documentation/ABI/stable/sysfs-devices-node
+++ b/Documentation/ABI/stable/sysfs-devices-node
@@ -1,7 +1,101 @@
+What:  /sys/devices/system/node/possible
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Nodes that could be possibly become online at some point.
+
+What:  /sys/devices/system/node/online
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Nodes that are online.
+
+What:  /sys/devices/system/node/has_normal_memory
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Nodes that have regular memory.
+
+What:  /sys/devices/system/node/has_cpu
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Nodes that have one or more CPUs.
+
+What:  /sys/devices/system/node/has_high_memory
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Nodes that have regular or high memory.
+   Depends on CONFIG_HIGHMEM.
+
 What:  /sys/devices/system/node/nodeX
 Date:  October 2002
 Contact:   Linux Memory Management list 
 Description:
When CONFIG_NUMA is enabled, this is a directory containing
information on node X such as what CPUs are local to the
-   node.
+   node. Each file is detailed next.
+
+What:  /sys/devices/system/node/nodeX/cpumap
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   The node's cpumap.
+
+What:  /sys/devices/system/node/nodeX/cpulist
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   The CPUs associated to the node.
+
+What:  /sys/devices/system/node/nodeX/meminfo
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Provides information about the node's distribution and memory
+   utilization. Similar to /proc/meminfo, see 
Documentation/filesystems/proc.txt
+
+What:  /sys/devices/system/node/nodeX/numastat
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   The node's hit/miss statistics, in units of pages.
+   See Documentation/numastat.txt
+
+What:  /sys/devices/system/node/nodeX/distance
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   Distance between the node and all the other nodes
+   in the system.
+
+What:  /sys/devices/system/node/nodeX/vmstat
+Date:  October 2002
+Contact:   Linux Memory Management list 
+Description:
+   The node's zoned virtual memory statistics.
+   This is a superset of numastat.
+
+What:  /sys/devices/system/node/nodeX/compact
+Date:  February 2010
+Contact:   Mel Gorman 
+Description:
+   When this file is written to, all memory within that node
+   will be compacted. When it completes, memory will be freed
+   into blocks which have as many contiguous pages as possible
+
+What:  /sys/devices/system/node/nodeX/scan_unevictable_pages
+Date:  October 2008
+Contact:   Lee Schermerhorn 
+Description:
+   When set, it triggers scanning the node's unevictable lists
+   and move any pages that have become evictable onto the 
respective
+   zone's inactive list. See mm/vmscan.c
+
+What:  /sys/devices/system/node/nodeX/hugepages/hugepages-/
+Date:  December 2009
+Contact:   Lee Schermerhorn 
+Description:
+   The node's huge page size control/query attributes.
+   See Documentation/vm/hugetlbpage.txt
\ No newline at end of file
-- 
1.7.11.7



--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


[PATCH] Documentation: ABI: /sys/devices/system/node/

2012-12-10 Thread Davidlohr Bueso
Describe NUMA node sysfs files/attributes.

Signed-off-by: Davidlohr Bueso davidlohr.bu...@hp.com
---
Note that for the specific dates and contacts I couldn't find,
I left it as default for Oct 2002 and linux-mm.

 Documentation/ABI/stable/sysfs-devices-node | 96 -
 1 file changed, 95 insertions(+), 1 deletion(-)

diff --git a/Documentation/ABI/stable/sysfs-devices-node 
b/Documentation/ABI/stable/sysfs-devices-node
index 49b82ca..ce259c1 100644
--- a/Documentation/ABI/stable/sysfs-devices-node
+++ b/Documentation/ABI/stable/sysfs-devices-node
@@ -1,7 +1,101 @@
+What:  /sys/devices/system/node/possible
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Nodes that could be possibly become online at some point.
+
+What:  /sys/devices/system/node/online
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Nodes that are online.
+
+What:  /sys/devices/system/node/has_normal_memory
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Nodes that have regular memory.
+
+What:  /sys/devices/system/node/has_cpu
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Nodes that have one or more CPUs.
+
+What:  /sys/devices/system/node/has_high_memory
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Nodes that have regular or high memory.
+   Depends on CONFIG_HIGHMEM.
+
 What:  /sys/devices/system/node/nodeX
 Date:  October 2002
 Contact:   Linux Memory Management list linux...@kvack.org
 Description:
When CONFIG_NUMA is enabled, this is a directory containing
information on node X such as what CPUs are local to the
-   node.
+   node. Each file is detailed next.
+
+What:  /sys/devices/system/node/nodeX/cpumap
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   The node's cpumap.
+
+What:  /sys/devices/system/node/nodeX/cpulist
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   The CPUs associated to the node.
+
+What:  /sys/devices/system/node/nodeX/meminfo
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Provides information about the node's distribution and memory
+   utilization. Similar to /proc/meminfo, see 
Documentation/filesystems/proc.txt
+
+What:  /sys/devices/system/node/nodeX/numastat
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   The node's hit/miss statistics, in units of pages.
+   See Documentation/numastat.txt
+
+What:  /sys/devices/system/node/nodeX/distance
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   Distance between the node and all the other nodes
+   in the system.
+
+What:  /sys/devices/system/node/nodeX/vmstat
+Date:  October 2002
+Contact:   Linux Memory Management list linux...@kvack.org
+Description:
+   The node's zoned virtual memory statistics.
+   This is a superset of numastat.
+
+What:  /sys/devices/system/node/nodeX/compact
+Date:  February 2010
+Contact:   Mel Gorman m...@csn.ul.ie
+Description:
+   When this file is written to, all memory within that node
+   will be compacted. When it completes, memory will be freed
+   into blocks which have as many contiguous pages as possible
+
+What:  /sys/devices/system/node/nodeX/scan_unevictable_pages
+Date:  October 2008
+Contact:   Lee Schermerhorn lee.schermerh...@hp.com
+Description:
+   When set, it triggers scanning the node's unevictable lists
+   and move any pages that have become evictable onto the 
respective
+   zone's inactive list. See mm/vmscan.c
+
+What:  /sys/devices/system/node/nodeX/hugepages/hugepages-size/
+Date:  December 2009
+Contact:   Lee Schermerhorn lee.schermerh...@hp.com
+Description:
+   The node's huge page size control/query attributes.
+   See Documentation/vm/hugetlbpage.txt
\ No newline at end of file
-- 
1.7.11.7



--
To unsubscribe from this list: send the line unsubscribe linux-kernel in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/