LSTOPO(1) hwloc LSTOPO(1) (NAME) lstopo, lstopo-no-graphics, hwloc-ls - (SYNOPSIS) lstopo [ options ]... [ filename ] lstopo-no-graphics [ options ]... [ filename ] hwloc-ls [ options ]... [ filename ] hwloc(7) hwloc . (OPTIONS) --of , --output-format . OUTPUT FORMATS . -i , --input . XML hwloc . "-" XML . Linux hwloc-gather- topology . x86 cpuid hwloc-gather-cpuid . archivemount tarball Linux x86 . -i , --input ( ). "node:2 pu:3" NUMA (PU) . PU . --if , --input-format xml fsroot cpuid synthetic. --export-xml-flags XML. hwloc_topology_export_xml() . . 1 ( v1) hwloc v1.x . 0 ( none) . --export-synthetic-flags synthetic. hwloc_topology_export_synthetic() . . 2 ( no_attr) hwloc v1.9 . 3 ( no_ext,no_attr) ( v1.9) . 0 ( none) . -v --verbose . hwloc-info . -q --quiet -s --silent . --distances . --distances-transform . hwloc_distances_transform() . hwloc-annotate(1) ( XML ). --memattrs (memory attributes). ( ). --cpukinds CPU. CPU . --windows-processor-groups Windows . . -f --force . -l --logical hwloc "L#". PU NUMA / . -p --physical / "P#". PU NUMA / . --logical-index-prefix " L#" . --os-index-prefix " P#" /. -c --cpuset cpuset . -C --cpuset-only cpuset . --cpuset-output-format --cof CPU . hwloc . list 2,4-5,8 . taskset cpuset taskset ( --taskset). --cpuset --cpuset-only --cpuset . --only . . --only NUMA[HBM] NUMA "HBM" --only "numa[mcdram]" NUMA MCDRAM KNL . --filter :, --filter "all" . "io" "cache" "icache" . . "none" . "all" . "structure" . "important" ( I/O ) . hwloc_topology_set_type_filter() . hwloc PU NUMA . lstopo PU NUMA ( Misc) . PU NUMA XML . ( Machine System) ..TP --ignore --filter :none . --no-smt PU. --filter PU:none . --no-caches (). --filter cache:none . --no-useless-caches --filter cache:structure . --no-icaches --filter icache:none . --disallowed ( Cgroups Linux). PU NUMA . --allow ( --disallowed) . local ( ). ( Linux Cgroups) XML (synthetic) . --thissystem . all . (bitmap) PU . nodeset= NUMA . --flags . hwloc_topology_set_flags() . disallowed,thissystem_allowed. 8 ( import) . --merge . HWLOC_TYPE_FILTER_KEEP_STRUCTURE . --filter all:structure . --no-factorize --no-factorize= () . . CPU (collapsing) PCI . --factorize --factorize=[,][,[,]] ( ). ( ) N . . . CPU PCI . --no-collapse PCI . PCI ( ) . --no-cpukinds CPU . (bold) PU . --restrict cpuset . PU . PU NUMA . --restrict nodeset= nodeset ( --restrict-flags ). NUMA . NUMA PU . --restrict binding (binding) . ( --thissystem HWLOC_THISSYSTEM ). PU NUMA . --restrict-flags . hwloc_topology_restrict() . bynodeset,memless. 0 ( none) . --no-io I/O (bridge). --filter io:none . (GPU NIC ...) / . --no-bridges I/O (hostbridges). --filter bridge:none . (GPU NIC ...) / . --whole-io I/O. --filter io:all . (GPU NIC ...) / . --thissystem . XML --restrict binding --allow all . --pid . . CPU PU NUMA ( (COLORS) (binding) ). 0 pid lstopo . --ps --top (misc) . . Linux (kernel threads) . hwloc-ps . hwloc-ps --misc-from . --misc-from (Misc) : name=myMisc1 cpuset=0x5 name=myMisc2 cpuset=0x7 subtype=myOptionalSubtype hwloc-ps --lstopo-misc ( (EXAMPLES) ) hwloc-ps --top lstopo . --children-order . : memory:above ( ). PU NUMA hwloc 1.x . io:right misc:right I/O Misc CPU . io:below misc:below I/O Misc CPU . plain CPU . plain lstopo : Memory I/O Misc . PU NUMA . Memory CPU I/O . memory:above,io:right,misc:right Memory CPU I/O Misc . hwloc 2.5 memory:above,plain . memory:above io:right io:below misc:right misc:below :horiz :vert :rect . (GRAPHICAL OUTPUT) (LAYOUT) ..TP --fontsize . . . LSTOPO_TEXT_XSCALE ( 1.0 ). --fontsize ASCII . --gridsize . . hwloc 2.1 . ASCII . --linespacing . . hwloc 2.1 --gridsize ( ). ASCII . --thickness . . ASCII . --horiz, --horiz= / . container . bridge . --vert, --vert= / . container . --rect, --rect= / . container . bridge . --no-text, --no-text= . . Group . --text, --text= (). ( --no-text ). --no-index, --no-index= () . . --index, --index= (). ( --no-index ). --no-attrs, --no-attrs= ( PCI PCI ) . . --attrs, --attrs= ( PCI PCI ) (). ( --no-attrs ). --no-legend . --no-default-legend . --append-legend <> ( ) . --append-legend . . <> . --grey, --greyscale . --palette . grey greyscale --grey --greyscale . white none . default colors . --palette type=#rrggbb 3x8bit RGB ( #ff0000 ). : machine group package group_in_package die core pu numanode memories ( ) cache pcidev osdev bridge misc. CUSTOM COLOR . --binding-color PU NUMA (binding) . 3x8bit RGB ( #ff0000 ). --disallowed-color PU NUMA . 3x8bit RGB ( #00ff00 ). --top-color (task) --top . 3x8bit RGB ( #0000ff ). Misc Process Thread . --version . -h --help . lstopo lstopo-no- graphics . lstopo lstopo-no-graphics lstopo . hwloc-ls lstopo-no-graphics . << (OUTPUT FORMATS)>> . << (COLORS)>> . (OUTPUT FORMATS) ( DISPLAY ) . . (pipe) . --of console --of window . . ( "-" stdout ) ( "topo.png" PNG ). "--of" . "--of pdf" PDF "--of fig toto" Xfig "toto" . . "--of" . default . window . console stdout. (binding) (verbose) << (COLORS)>> . ascii (ASCII art) ( txt ). stdout . (pager) ( less) . LSTOPO_PAGER cat . tikz tex tikzpicture LaTeX LaTeX . fig Xfig . svg SVG Cairo ( ) SVG ( ). cairosvg nativesvg . cairosvg svg(cairo) lstopo SVG Cairo . nativesvg svg(native) SVG SVG. Cairo SVG . dynamic_SVG_example.html . pdf lstopo lstopo PDF . ps lstopo lstopo Postscript . png lstopo lstopo PNG . synthetic ( symmetric_subtree ) lstopo (synthetic) . . <> . Misc I/O . xml lstopo XML . lstopo --input HWLOC_XMLFILE hwloc_topology_set_xml() . : - stdout. /dev/stdout stdout. "-" . -. "-." lstopo "--of -" . hwloc "lstopo --help" . . Machine Package Core PU . (Caches) . L2 Cache Core Cache Core ( Core Cache ). NUMA (Memory-side Caches) NUMA . Package NUMA Core Package NUMA Core . NUMA L3 Cache NUMA Cache . --children-order plain . NUMA . Memory-side Cache NUMA . PCI PCI (OS devices) PCI ( ) . hostbridge root complex . PCI . / PCI . PCI PCI ( 00:02.3). eth0 CUDA cuda0 . ( ) PCI PCI . / PCI . (datarate) PCI ( GB/s) ( / ). PCI ( lane PCI ). (idle) PCI . (LAYOUT) lstopo (heuristics) . ( NUMA ) . --vert --horiz --rect . Memory I/O Misc --children-order . . ( ) . // --children-order . hwloc CPU NUMA . --palette << >> . CPU NUMA : ( --pid ) CPU NUMA (binding mask) CPU . --binding-color . CPU NUMA ( ). ( --pid ) . CPU NUMA ( ). --disallowed-color . << >> (allowed set) CPU NUMA (bind) . . cpuset CPU NUMA . CPU NUMA . lstopo / CPU ( lstopo CPU lstopo CPU ). lstopo ( ) . (verbose) PU . (CUSTOM COLORS) --palette . "lstopoStyle" . (;) "=#rrggbb" rr gg bb RGB 0 255 (00 ff). : Background . Text (index) . Text2 (link speed) PCI. "lstopoStyle" hwloc-annotate ()hwloc_obj_add_info XML . (core) ( ): lstopo save.xml hwloc-annotate save.xml save.xml core:all info lstopoStyle "Background=#0000ff;Text=#ffffff" lstopo -i save.xml (EXAMPLES) : $ lstopo-no-graphics (ascii-art): $ lstopo-no-graphics -.ascii ( DISPLAY ): $ lstopo PNG: $ lstopo file.png XML : $ machine1$ lstopo file.xml $ machine2$ lstopo --input file.xml XML : $ lstopo file.xml <...> $ lstopo --input file.xml --thissystem XML 0 1 4 5: $ lstopo --input file.xml --restrict 0x33 newfile.xml XML numa 1 : $ lstopo --input file.xml --restrict $(hwloc-calc --input file.xml node:1) newfile.xml (Examples with textual output filtering) : $ lstopo -s : $ lstopo -v : $ lstopo --only core cpuset: $ lstopo --cpuset cpuset package: $ lstopo --only package --cpuset-only (More examples) NUMA : $ lstopo --input "node:2 2" : $ lstopo --append-legend "Kernel release: $(uname -r)" --append- legend "Kernel version: $(uname -v)" hwloc-ps: $ hwloc-ps --pid-children 23 --lstopo-misc - | lstopo --misc-from - (SEE ALSO) hwloc(7), hwloc-info(1), hwloc-bind(1), hwloc-annotate(1), hwloc-ps(1), hwloc-gather-topology(1), hwloc-gather-cpuid(1) 2.14.0 June 8, 2026 LSTOPO(1)