{"id":13785704,"url":"https://github.com/intel/numatop","last_synced_at":"2025-05-11T21:31:41.934Z","repository":{"id":7557047,"uuid":"8910387","full_name":"intel/numatop","owner":"intel","description":"NumaTOP is an observation tool for runtime memory locality characterization and analysis of processes and threads running on a NUMA system.","archived":false,"fork":false,"pushed_at":"2024-08-02T16:50:06.000Z","size":479,"stargazers_count":187,"open_issues_count":18,"forks_count":45,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-08-02T20:09:20.172Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/intel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-03-20T17:37:37.000Z","updated_at":"2024-08-02T16:50:10.000Z","dependencies_parsed_at":"2023-12-26T06:22:40.198Z","dependency_job_id":"d2734e52-9f3b-40ae-b743-f006f857aae8","html_url":"https://github.com/intel/numatop","commit_stats":{"total_commits":117,"total_committers":12,"mean_commits":9.75,"dds":0.7692307692307692,"last_synced_commit":"fa415aff72e11c74aa754d4bba3df6821de64dd2"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intel%2Fnumatop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intel%2Fnumatop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intel%2Fnumatop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intel%2Fnumatop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/intel","download_url":"https://codeload.github.com/intel/numatop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213845324,"owners_count":15646766,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T19:01:03.630Z","updated_at":"2024-08-03T19:05:02.981Z","avatar_url":"https://github.com/intel.png","language":"C","readme":"\n## Building \u0026 Installing NumaTOP\n\nNumatop uses autotools. If you're compiling from git, run `autogen.sh`\nand then `make`. Otherwise, use `./configure \u0026\u0026 make`.\n\nTo install, run `sudo make install`.\n\nTo run the test program, run `make check` after compilation or check\nthe `mgen` program for help information.\n\n\n## Build Dependencies\n\nNumaTOP requires following libraries or packages:\n\n* numactl-devel or libnuma-dev(el)\n* libncurses\n* libpthread\n\n* check\n\n## Run NumaTOP\n\nNumaTOP requires running as root.\n\t# ./numatop\n\nIn many systems, the default max open files are 1024, for platforms (like SPR)\nthat have more CPUs, they require the system with the max open files should\nbigger than 1024, otherwise, the error can be \"Fail to setup perf\":\n\n\t# ulimit -n\n\t  1024        \u003c------the max open files are 1024\n\t# ./numatop\n\t  NumaTOP is starting ...\n\t  Fail to setup perf (probably permission denied)!\n\nNeed to enlarge the max open files:\n\n\t# ulimit -n 8192\n\t# ulimit -n\n\t  8192        \u003c------now the max open files are 8192\n\n## Supported Kernels\n\nThe recommended kernel version is the latest stable kernel, currently 4.15.\n\nThe minimum kernel version supported is 3.16\n\nFor Haswell supporting, please also apply a perf patch on 3.16. The patch\nis `kernel_patches/0001-perf-x86-Widen-Haswell-OFFCORE-mask.patch`.\n\nThe patch can also be found at following link:\nhttp://www.gossamer-threads.com/lists/linux/kernel/1964864\n\n\n## Directories\n\ncommon:\tcommon code for all platforms.\n\nx86   : Intel and AMD platform-specific code.\n\npowerpc: PowerPC platform-specific code.\n\ntest  : mgen source code. mgen is a micro-test application which can\n        generate memory access with runtime latency value among CPUs.\n        Note that this application is only used for numatop testing!\n\nkernel_patches: the required kernel patches.\n\n\n## Supported Hardware\n\nnumatop is supported on Intel Xeon processors: 5500-series, 6500/7500-series,\n5600 series, E7-x8xx-series, and E5-16xx/24xx/26xx/46xx-series. \n\nE5-16xx/24xx/26xx/46xx-series had better be updated to latest CPU microcode\n(microcode must be 0x618+ or 0x70c+).\n\nAMD EPYC processors from the 7001, 7002, 7003, 4004, 8004 and 9004 series are\nalso supported.\n\nTo learn about NumaTOP, please visit http://01.org/numatop\n\n\n## PowerPC Support\n\nNumaTOP is also supported on PowerPC. Please check powerpc/FEATURES file\nfor more details.\n","funding_links":[],"categories":["Observation and profiling tools"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintel%2Fnumatop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintel%2Fnumatop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintel%2Fnumatop/lists"}