Add the rt linux 4.1.3-rt3 as base
[kvmfornfv.git] / kernel / Documentation / numastat.txt
diff --git a/kernel/Documentation/numastat.txt b/kernel/Documentation/numastat.txt
new file mode 100644 (file)
index 0000000..5203277
--- /dev/null
@@ -0,0 +1,27 @@
+
+Numa policy hit/miss statistics
+
+/sys/devices/system/node/node*/numastat
+
+All units are pages. Hugepages have separate counters.
+
+numa_hit       A process wanted to allocate memory from this node,
+               and succeeded.
+
+numa_miss      A process wanted to allocate memory from another node,
+               but ended up with memory from this node.
+
+numa_foreign   A process wanted to allocate on this node,
+               but ended up with memory from another one.
+
+local_node     A process ran on this node and got memory from it.
+
+other_node     A process ran on this node and got memory from another node.
+
+interleave_hit         Interleaving wanted to allocate from this node
+               and succeeded.
+
+For easier reading you can use the numastat utility from the numactl package
+(http://oss.sgi.com/projects/libnuma/). Note that it only works
+well right now on machines with a small number of CPUs.
+