ICC Home Privacy and Legal Notice LC User Documents Banner

UCRL-WEB-200040

CHAOS: Linux from Livermore


NUMA-MAPS (Display Memory Use)

NUMA-MAPS lets you display information about how your current processes are using memory on NUMA hardware, including files, stack, and heap (or subsets that you select). The parent of this subsection explains the meaning of NUMA hardware as well as the affinity and memory-policy issues that pertain to it.

To report on your NUMA memory use, type

numa-maps processoption scopeoption

Here processoption selects the process(es) to cover and can be any ONE of these mutually exclusive alternatives:

--user=uname
(-u uname) reports the PID, Unix command, current CPU mask, total memory used and memory per NUMA node for all processes owned by uname.
--name=string
(-n string) reports the PID, Unix command, current CPU mask, total memory used and memory per NUMA node only for the process whose name exactly matches string (filter characters are not allowed).
--all
(-a) reports on all processes of the user who runs NUMA-MAPS (root users will want to combine this with -q to ignore kernel threads).

Likewise, scopeoption selects the granularity of the report (the default scope is mapped stack and heap memory only):

--heap-only
(-H) displays NUMA memory information only for the heap.
--stack-only
(-S) displays NUMA memory information only for the stack.
--full
(-F) displays NUMA memory information for all mapped files, stack, and heap.

If you plan to pipe NUMA-MAPS output into another program for further processing you can omit the descriptive header by invoking the --no-header (-n) option along with any others. And root users will want to include --ignore-zero (-q) to skip processes (such as kernel threads) without any mapped pages.



Navigation Links: [ Document List ] [ HPC Home ] [ Next ]