https://github.com/intel/numatop

NumaTOP is an observation tool for runtime memory locality characterization and analysis of processes and threads running on a NUMA system.
https://github.com/intel/numatop

Last synced: 26 days ago
JSON representation

NumaTOP is an observation tool for runtime memory locality characterization and analysis of processes and threads running on a NUMA system.

• Host: GitHub
• URL: https://github.com/intel/numatop
• Owner: intel
• License: bsd-3-clause
• Created: 2013-03-20T17:37:37.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-08-02T16:50:06.000Z (4 months ago)
• Last Synced: 2024-08-02T20:09:20.172Z (4 months ago)
• Language: C
• Size: 468 KB
• Stars: 187
• Watchers: 21
• Forks: 45
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: COPYING
  • Security: SECURITY.md
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome-numa - NumaTOP - An observation tool for runtime memory locality characterization and analysis of processes and threads running on a NUMA system (Observation and profiling tools)

README

        

## Building & Installing NumaTOP

Numatop uses autotools. If you're compiling from git, run `autogen.sh`

and then `make`. Otherwise, use `./configure && make`.

To install, run `sudo make install`.

To run the test program, run `make check` after compilation or check

the `mgen` program for help information.

## Build Dependencies

NumaTOP requires following libraries or packages:

* numactl-devel or libnuma-dev(el)

* libncurses

* libpthread

* check

## Run NumaTOP

NumaTOP requires running as root.

	# ./numatop

In many systems, the default max open files are 1024, for platforms (like SPR)

that have more CPUs, they require the system with the max open files should

bigger than 1024, otherwise, the error can be "Fail to setup perf":

	# ulimit -n

	  1024        <------the max open files are 1024

	# ./numatop

	  NumaTOP is starting ...

	  Fail to setup perf (probably permission denied)!

Need to enlarge the max open files:

	# ulimit -n 8192

	# ulimit -n

	  8192        <------now the max open files are 8192

## Supported Kernels

The recommended kernel version is the latest stable kernel, currently 4.15.

The minimum kernel version supported is 3.16

For Haswell supporting, please also apply a perf patch on 3.16. The patch

is `kernel_patches/0001-perf-x86-Widen-Haswell-OFFCORE-mask.patch`.

The patch can also be found at following link:

http://www.gossamer-threads.com/lists/linux/kernel/1964864

## Directories

common:	common code for all platforms.

x86   : Intel and AMD platform-specific code.

powerpc: PowerPC platform-specific code.

test  : mgen source code. mgen is a micro-test application which can

        generate memory access with runtime latency value among CPUs.

        Note that this application is only used for numatop testing!

kernel_patches: the required kernel patches.

## Supported Hardware

numatop is supported on Intel Xeon processors: 5500-series, 6500/7500-series,

5600 series, E7-x8xx-series, and E5-16xx/24xx/26xx/46xx-series. 

E5-16xx/24xx/26xx/46xx-series had better be updated to latest CPU microcode

(microcode must be 0x618+ or 0x70c+).

AMD EPYC processors from the 7001, 7002, 7003, 4004, 8004 and 9004 series are

also supported.

To learn about NumaTOP, please visit http://01.org/numatop

## PowerPC Support

NumaTOP is also supported on PowerPC. Please check powerpc/FEATURES file

for more details.