LIKWID-TOPOLOGY(1)

📦
version 5.5.1 · 6 versions
, in ubuntu stonking

✨ NAME ✨

okay bestie, gather round, it's likwid-topology — the manual page for it lives in section 1 of the manual, and what it does is print thread, cache, NUMA and Nvidia/AMD GPU topology. that's the whole vibe. 💖

🌸 SYNOPSIS 🌸

likwid-topology [-hvgcCG] [-V level] [-o output_file]

🦋 DESCRIPTION 🦋

so like, likwid-topology is a command line application that prints the thread and cache topology on multicore x86, ARM and POWER processors and Nvidia/AMD GPUs. it's giving "let me show you the whole machine, bestie."

when you run it in a mono spaced font it can literally draw the processor topology of a machine in ASCII art. yes, art. iconic behaviour, no cap. 🎨✨

and it doesn't stop at topology, because of course it doesn't — beyond that, likwid-topology also determines the clock of a processor and prints detailed information about the caches hierarchy. obsessed. 💅

now, the GPU tea ☕: when it's compiled with NVIDIA_INTERFACE=true in config.mk and the CUDA/CUPTI library is reachable at runtime, likwid-topology prints information about the Nvidia GPUs in the system. and the same thing is possible for AMD GPUs with ROCM_INTERFACE=TRUE and the required ROCm libraries. so yeah, GPU girlies are covered too. 🫶

👑 OPTIONS 👑

  • -h, --help — prints a help message to standard output, then exits. quick lil "what even is this", answered. 💖
  • -v, --version — prints version information to standard output, then exits. say hi to the version bestie. ✨
  • -V, --verbose <level> — sets the verbosity level of LIKWID's topology backend. possible levels range from 0 to 3. crank it up if you want more words. 🔥
  • -g — prints topology information in ASCII art. best viewed with a monospaced font. heads up though: the GPU topology is not printed. 🙈
  • -c, --caches — prints detailed information about cache hierarchy. the cache lore. 🎀
  • -C, --clock — measures and outputs the processor clock. warning bestie, this involves a longer run time of likwid-topology, so maybe go grab a snack. 😭
  • -G, --gpus — prints detailed information about the Nvidia/AMD GPUs in the system (if compiled with Nvidia or AMD support). GPU main character energy. 👑
  • -o, --output <file> — write the output to file instead of stdout. and here's the cute part: Likwid applies filter scripts according to the filename suffix. currently available scripts are csv, xml and json. you can also place additional filter scripts in /usr/share/likwid/filter. slay. 🌈

💜 AUTHOR 💜

Written by Thomas Gruber <thomas.roehl@googlemail.com>. thank you for your service king 🫡💖

💀 BUGS 💀

Report Bugs on <https://github.com/RRZE-HPC/likwid/issues>. not me being the one to tell u but bug reports go there, fr fr. 🙈

🧚 SEE ALSO 🧚

okay that's the whole thing bestie, every flag accounted for, nothing skipped, we ate and left no crumbs 💅✨

this was the LIKWID-TOPOLOGY(1) page from likwid-5, dated 23.12.2025 — manual page girlies know. periodt. 🎀💖

📦 where this page comes from