cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

numastat.rst (2446B)


      1===============================
      2Numa policy hit/miss statistics
      3===============================
      4
      5/sys/devices/system/node/node*/numastat
      6
      7All units are pages. Hugepages have separate counters.
      8
      9The numa_hit, numa_miss and numa_foreign counters reflect how well processes
     10are able to allocate memory from nodes they prefer. If they succeed, numa_hit
     11is incremented on the preferred node, otherwise numa_foreign is incremented on
     12the preferred node and numa_miss on the node where allocation succeeded.
     13
     14Usually preferred node is the one local to the CPU where the process executes,
     15but restrictions such as mempolicies can change that, so there are also two
     16counters based on CPU local node. local_node is similar to numa_hit and is
     17incremented on allocation from a node by CPU on the same node. other_node is
     18similar to numa_miss and is incremented on the node where allocation succeeds
     19from a CPU from a different node. Note there is no counter analogical to
     20numa_foreign.
     21
     22In more detail:
     23
     24=============== ============================================================
     25numa_hit	A process wanted to allocate memory from this node,
     26		and succeeded.
     27
     28numa_miss	A process wanted to allocate memory from another node,
     29		but ended up with memory from this node.
     30
     31numa_foreign	A process wanted to allocate on this node,
     32		but ended up with memory from another node.
     33
     34local_node	A process ran on this node's CPU,
     35		and got memory from this node.
     36
     37other_node	A process ran on a different node's CPU
     38		and got memory from this node.
     39
     40interleave_hit 	Interleaving wanted to allocate from this node
     41		and succeeded.
     42=============== ============================================================
     43
     44For easier reading you can use the numastat utility from the numactl package
     45(http://oss.sgi.com/projects/libnuma/). Note that it only works
     46well right now on machines with a small number of CPUs.
     47
     48Note that on systems with memoryless nodes (where a node has CPUs but no
     49memory) the numa_hit, numa_miss and numa_foreign statistics can be skewed
     50heavily. In the current kernel implementation, if a process prefers a
     51memoryless node (i.e.  because it is running on one of its local CPU), the
     52implementation actually treats one of the nearest nodes with memory as the
     53preferred node. As a result, such allocation will not increase the numa_foreign
     54counter on the memoryless node, and will skew the numa_hit, numa_miss and
     55numa_foreign statistics of the nearest node.