lstopo - Online in de cloud

PROGRAMMA:

NAAM

lstopo, lstopo-no-graphics, hwloc-ls - Toon de topologie van het systeem

KORTE INHOUD

stopo [ opties ]... [ bestandsnaam ]

lstopo-geen-graphics [ opties ]... [ bestandsnaam ]

hwloc-ls [ opties ]... [ bestandsnaam ]

Merk op dat hoera(7) geeft een gedetailleerde uitleg van het hwloc-systeem; het moet gelezen worden
voordat je deze man-pagina leest

OPTIES

--van , --uitvoer-formaat
Dwing de uitvoer af in het opgegeven formaat. Zie het gedeelte UITVOERFORMATEN hieronder.

-i , --invoer
Topologie uit XML-bestand lezen (in plaats van de topologie te ontdekken op de
lokaal apparaat). Indien "-" is, wordt de standaard invoer gebruikt. XML-ondersteuning moet
zijn gecompileerd naar hwloc om deze optie bruikbaar te maken.

-i , --invoer
Lees topologie van de chroot gespecificeerd door (in plaats van het ontdekken van de
topologie op de lokale machine). Deze optie is over het algemeen alleen beschikbaar op Linux.
De chroot werd meestal gemaakt door een andere machinetopologie te verzamelen met hwloc-
verzamel-topologie.

-i , --invoer
Simuleer een nephiërarchie (in plaats van de lokale topologie te ontdekken)
machine). Indien is "node:2 pu:3", zal de topologie twee NUMA . bevatten
knooppunten met elk 3 verwerkingseenheden. De string moet eindigen
met een aantal PU's.

--indien , --invoer formaat
Dwing de invoer af in het opgegeven formaat, onder andere xml, fsroot en synthetisch.

--export-synthetische-vlaggen
Dwing vlaggen af ​​bij het exporteren naar het synthetische formaat. Deze vlaggen worden doorgegeven aan
hwloc_topology_export_synthetic(). Een waarde van 2 keert terug naar het formaat van hwloc
v1.9. Een waarde van 3 keert terug naar het oorspronkelijke minimalistische formaat (vóór v1.9).

-v --uitgebreid
Voeg extra details toe. De hwloc-info-tool kan worden gebruikt om nog meer weer te geven
informatie over specifieke objecten.

-s --stil
Verminder het aantal details dat moet worden weergegeven.

-f --kracht
Als het doelbestand al bestaat, overschrijft u het.

-l --logisch
Hwloc logische indexen weergeven in plaats van fysieke/OS-indexen (standaard voor console
uitgang). Deze indexen worden voorafgegaan door "L#". De fysieke indexen van sommige
objecten (standaard PU en Node, alle objecten indien uitgebreid) verschijnen als object
attribuut "P#...".

-p --fysiek
OS/fysieke indexen weergeven in plaats van hwloc logische indexen (standaard voor grafische)
uitgang). Deze indexen worden voorafgegaan door "P#" in plaats van "L#" in de console
uitgang.

-c --cpuset
Geef de cpuset van elk object weer.

-C --cpuset-alleen
Geef alleen de cpuset van elk object weer; laat niets anders zien over de
voorwerp.

--takenset
Toon CPU-setstrings in het formaat dat wordt herkend door het opdrachtregelprogramma van de taskset
in plaats van hwloc-specifieke CPU-set string-indeling. Deze optie moet worden gecombineerd
Met --cpuset or --cpuset-alleen, anders zal het impliceren --cpuset.

--enkel en alleen
Toon alleen objecten van het opgegeven type in de tekstuele output.

--negeren
Negeer alle objecten van het type in de topologie. hwloc ondersteunt het negeren van elke
type behalve PU's en I/O-apparaten. lstopo biedt echter nog steeds PU negeren door zich te verbergen
PU-objecten in de grafische en tekstuele output. Merk op dat PU niet mag worden genegeerd
in de XML-uitvoer. Merk ook op dat het objecttype op het hoogste niveau niet kan worden genegeerd
(meestal Machine of Systeem).

--geen-caches
Geen caches tonen.

--geen-nutteloze-caches
Toon geen caches die geen hiërarchische impact hebben. Dit roept
hwloc_topology_ignore_type_keep_structure() voor cache-objecten.

--geen-icaches
Instructiecaches niet weergeven, alleen gegevens- en unified caches worden weergegeven.

--hele systeem
Houd geen rekening met administratieve beperkingen.

--samenvoegen
Toon geen niveaus die geen hiërarchische impact hebben. Dit roept
hwloc_topology_ignore_all_keep_structure().

--geen instorting
Vouw identieke PCI-apparaten niet samen. Standaard identieke broer of zus PCI-apparaten
(zoals veel virtuele functies binnen een enkel fysiek apparaat) worden samengevouwen.

--beperken
Beperk de topologie tot de gegeven cpuset.

--beperken verbindend
Beperk de topologie tot de huidige procesbinding. Deze optie vereist het gebruik
van de huidige machinetopologie (of een andere topologie met --dit systeem or
met HWLOC_THISSYSTEM ingesteld op 1 in de omgeving).

--restrict-vlaggen
Vlaggen afdwingen bij het beperken van de topologie. De standaard is 0. Deze vlaggen zijn:
doorgegeven aan hwloc_topology_restrict().

--nee-io
Laat geen I/O-apparaat of bridge zien. Standaard kunnen gewone apparaten (GPU's, NIC's,
block devices, ...) en interessante bruggen worden getoond.

--geen-bruggen
Toon geen I/O-bridge behalve hostbridges. Standaard worden gewone apparaten (GPU's,
NIC's, block devices, ...) en interessante bridges worden getoond.

--geheel-io
Toon alle I/O-apparaten en bruggen. Standaard kunnen alleen gewone apparaten (GPU's, NIC's,
block devices, ...) en interessante bruggen worden getoond.

--dit systeem
Neem aan dat de geselecteerde backend de topologie biedt voor het systeem waarop we
lopen. Dit is handig bij het gebruik van --beperken een custom binden en laden
topologie, zoals een XML-bestand.

--pid
Detecteer topologie zoals gezien door proces , dat wil zeggen alsof proces deed de
ontdekking zelf. Merk op dat dit bijvoorbeeld de set van toegestane . kan veranderen
verwerkers. Toon ook de huidige CPU-binding van dit proces door de . te markeren
overeenkomstige PU's (in het groen in de grafische uitvoer, zie de sectie KLEUREN hieronder,
of door toe te voegen (verbindend) naar de uitgebreide tekstuitvoer). Als 0 wordt gegeven als pid, is de
huidige binding voor het lstopo-proces wordt weergegeven.

- --bovenkant
Toon bestaande processen als diverse objecten in de uitvoer. Nutteloos vermijden
verrommeling van de uitvoer, alleen processen die beperkt zijn tot een deel van de
automaat worden getoond. Op Linux worden kernelthreads niet getoond. Als veel processen
verschijnen, kan de uitvoer toch moeilijk leesbaar worden, waardoor het hwloc-ps-programma meer wordt
praktisch.

--lettertypegrootte
Stel de grootte van het tekstlettertype in.

--rastergrootte
Grootte van de marge tussen elementen instellen.

--horiz, --horiz=
Horizontale grafische lay-out in plaats van bijna 4/3 verhouding. Als een door komma's gescheiden lijst
soorten wordt gegeven, geldt de indeling alleen voor de bijbehorende containers.

--Groen, --Groen=
Verticale grafische lay-out in plaats van bijna 4/3 verhouding. Als een door komma's gescheiden lijst
soorten wordt gegeven, geldt de indeling alleen voor de bijbehorende containers.

--rectificeren, --rectificeren=
Rechthoekige grafische lay-out met bijna 4/3 verhouding, ook bij het plaatsen van NUMA
knooppunten. Als een door komma's gescheiden lijst met typen wordt gegeven, is de lay-out alleen van toepassing op de
bijbehorende containers.

--geen legende
Verwijder de tekstlegenda onderaan.

--toevoegen-legenda
Voeg de tekstregel toe aan de onderkant van de legenda in grafische modus. Als de lijn
te lang is, wordt deze afgekapt in de uitvoer. Als u meerdere regels toevoegt, wordt elk
regel moet afzonderlijk worden opgegeven door deze optie meerdere keren door te geven.

--versie
Rapporteer versie en sluit af.

PRODUCTBESCHRIJVING

lstopo en lstopo-no-graphics kunnen een topologische kaart van het systeem weergeven in
een verscheidenheid aan verschillende uitvoerformaten. Het enige verschil tussen lstopo en lstopo-no-
graphics is dat grafische uitvoer alleen wordt ondersteund door lstopo, om de afhankelijkheden van
externe bibliotheken. hwloc-ls is identiek aan lstopo-no-graphics.

De opgegeven bestandsnaam impliceert direct het uitvoerformaat dat zal worden gebruikt; zie de
UITVOERFORMATEN hieronder. Uitvoerformaten die kleur ondersteunen, geven specifiek aan
kenmerken over individuele CPU's op basis van hun kleur; zie het gedeelte KLEUREN hieronder.

OUTPUT FORMATS

Als er geen specifieke bestandsnaam voor de uitvoer is, wordt de uitvoer standaard naar een grafisch venster gestuurd als:
mogelijk in de huidige omgeving (DISPLAY omgevingsvariabele ingesteld op Unix, enz.).
Anders wordt een tekstoverzicht weergegeven in de console.

De bestandsnaam op de opdrachtregel bepaalt meestal het formaat van de uitvoer. Er zijn een
enkele bestandsnamen die specifieke uitvoerformaten en apparaten aangeven (bijv. een bestandsnaam van "-"
zal een tekstsamenvatting naar stdout uitvoeren), maar de meeste bestandsnamen geven de gewenste uitvoer aan
formaat door hun achtervoegsel (bijv. "topo.png" loading="lazy" zal een bestand in PNG-formaat uitvoeren).

Het formaat van de uitvoer kan ook worden gewijzigd met "--of". Bijvoorbeeld, "--of pdf" zal
genereer een bestand in PDF-formaat op de standaarduitvoer, terwijl "--of fig toto" a . zal uitvoeren
Xfig-bestand met de naam "toto".

De lijst met momenteel ondersteunde formaten wordt hieronder gegeven. Elk van hen kan worden gebruikt met:
"--of" of als achtervoegsel van een bestandsnaam.

verzuim
Stuur de uitvoer naar een venster of naar de console, afhankelijk van de omgeving.

console
Stuur een tekstsamenvatting naar stdout. Bindende, niet-toegestane of offline processors zijn alleen
geannoteerd in deze modus als uitgebreid; zie het gedeelte KLEUREN hieronder.

ascii Voer een ASCII-kunstrepresentatie van de kaart uit (voorheen genoemd txt). Als output
naar stdout en als kleuren worden ondersteund op de terminal, is de uitvoer
ingekleurd.

vijg Voer een weergave uit van de kaart die in Xfig kan worden geladen.

pdf Als lstopo is gecompileerd met de juiste ondersteuning, voert lstopo een PDF-weergave uit
van de kaart.

ps Als lstopo is gecompileerd met de juiste ondersteuning, voert lstopo een Postscript uit:
weergave van de kaart.

png Als lstopo is gecompileerd met de juiste ondersteuning, geeft lstopo een PNG-representatie af
van de kaart.

svg Als lstopo is gecompileerd met de juiste ondersteuning, voert lstopo een SVG uit
weergave van de kaart.

synthetisch
Als de topologie symmetrisch is (wat vereist dat het hoofdobject zijn
symmetric_subtree field set), voert lstopo een synthetische beschrijvingsreeks uit. Dit
uitvoer kan later opnieuw worden gebruikt als een synthetische invoertopologiebeschrijving. Let daar op
I/O-apparaten veroorzaken vaak topologieasymmetrie. Het toevoegen van --no-io kan dan handig zijn wanneer:
de synthetische export mislukt. Zie ook de sectie Synthetische topologieën in de
documentatie.

xml Als lstopo is gecompileerd met de juiste ondersteuning, voert lstopo een XML uit
weergave van de kaart. Het kan later opnieuw worden gebruikt, zelfs op een andere machine, met
lstopo --input, de HWLOC_XMLFILE omgevingsvariabele, of de
hwloc_topology_set_xml() functie.

De volgende speciale namen kunnen worden gebruikt:

- Stuur een tekstsamenvatting naar stdout.

/dev/stdout
Stuur een tekstsamenvatting naar stdout. Het is in feite hetzelfde als het specificeren van "-".

-.
Als de volledige bestandsnaam "-. ", lstopo gedraagt ​​zich alsof "--of -" was
gegeven, wat betekent dat een bestand van het opgegeven formaat naar de standaarduitvoer wordt gestuurd.

Zie de uitvoer van "lstopo --help" voor een specifieke lijst van wat grafische uitvoerformaten zijn
ondersteund in uw hwloc-installatie.

KLEUREN

Individuele CPU's zijn gekleurd in de grafische uitvoerformaten om verschillende aan te geven
kenmerken:

Groen De topologie wordt gerapporteerd zoals gezien door een specifiek proces (zie --pid), en de gegeven
CPU is in dit proces CPU-bindingsmasker.

Wit De CPU bevindt zich in de toegestane set (zie hieronder). Als de topologie wordt gerapporteerd zoals gezien door
een specifiek proces (zie --pid), is de gegeven CPU ook niet in dit proces CPU
bindend masker.

Rood De CPU bevindt zich niet in de toegestane set (zie hieronder).

Zwart De CPU is offline (niet alle besturingssystemen ondersteunen het weergeven van offline CPU's).

De "toegestane set" is de set CPU's waaraan het huidige proces mag binden. De
toegestane set wordt meestal overgenomen van het bovenliggende proces of ingesteld door de beheerder
qbeleid op het systeem. Linux-cpusets zijn een voorbeeld van het beperken van de toegestane set voor a
proces en zijn kinderen kleiner zijn dan de volledige set CPU's op het systeem.

Verschillende processen kunnen daarom verschillende CPU's hebben in de toegestane set. Vandaar, een beroep doend op
lstopo in verschillende contexten en/of omdat verschillende gebruikers verschillende kleuren kunnen weergeven voor
dezelfde individuele CPU's (bijv. het uitvoeren van lstopo in één context kan een specifieke CPU tonen als
rood, maar als lstopo in een andere context wordt uitgevoerd, wordt mogelijk dezelfde CPU als wit weergegeven).

Sommige lstopo-uitvoermodi, bijv. de consolemodus (standaard niet-grafische uitvoer), doen dat niet
helemaal geen kleuren ondersteunen. De consolemodus geeft de bovenstaande kenmerken weer door toe te voegen:
tekst naar elke PU-regel als uitgebreide berichten zijn ingeschakeld.

OP MAAT KLEUREN

De kleur van elk object in de grafische uitvoer kan worden afgedwongen door a . op te geven
"lstopoStyle" info-attribuut in dat object. De waarde moet een puntkomma gescheiden zijn
lijst van " =#rrggbb" waarbij rr, gg en bb de RGB-componenten van een kleur zijn, elk
tussen 0 en 255, in hexadecimaal (00 tot ff). misschien

Achtergrond
Stelt de achtergrondkleur van het hoofdobjectvak in.

Background2
Stelt de achtergrondkleur in van het extra vak voor het object, bijvoorbeeld de
geheugenbox in een NUMA-nodebox.

Tekst Stelt de kleur in van de tekst met de objectnaam, het type, de index, enz.

Text2 Stelt de kleur in van de aanvullende tekst bij het object, bijvoorbeeld de linksnelheid
achter een PCI-brug.

De "lstopoStyle"-info kan worden toegevoegd aan tijdelijk opgeslagen XML-topologieën met hwloc-
annoteren, of met hwloc_obj_add_info(). Om bijvoorbeeld alle kernobjecten in blauw weer te geven
(met witte namen):

lstopo opslaan.xml
hwloc-annoteren save.xml save.xml core:alle info lstopoStyle
"Achtergrond=#0000ff;Text=#ffffff"
lstopo -ik bewaar.xml

LAYOUT

In zijn grafische uitvoer gebruikt lstopo eenvoudige rechthoekige heuristieken om te proberen een 4/3 . te bereiken
verhouding tussen breedte en hoogte. In het specifieke geval van NUMA-knooppunten is de lay-out
is altijd een platte rechthoek, om te voorkomen dat de gebruiker een bepaalde NUMA-topologie gelooft
(lstopo kan dat nog niet weergeven). De indeling van een niveau kan worden gewijzigd met
--vert, --horiz en --rect.

Voorbeelden

Om de machinetopologie in tekstuele modus weer te geven:

lstopo-geen-graphics

Om de machinetopologie in ascii-art-modus weer te geven:

lstopo-no-graphics -.ascii

Om in grafische modus weer te geven (ervan uitgaande dat de omgevingsvariabele DISPLAY is ingesteld op a
relevante waarde):

stopo

Om de topologie naar een PNG-bestand te exporteren:

lstopo-bestand.png

Een XML-bestand exporteren naar een machine en later de bijbehorende grafische uitvoer weergeven op:
een ander apparaat:

machine1$ lstopo-bestand.xml

machine2$ lstopo --input bestand.xml

Om de huidige machinetopologie op te slaan in XML en deze later sneller opnieuw te laden terwijl u stilstaat
gezien het als de huidige machine:

$ lstopo-bestand.xml
<...>
$ lstopo --input file.xml --ditsysteem

Om een ​​XML-topologie te beperken tot alleen fysieke processors 0, 1, 4 en 5:

lstopo --input file.xml --restrict 0x33 nieuwbestand.xml

Om een ​​XML-topologie te beperken tot alleen numa-knooppunten waarvan de logische index 1 is:

lstopo --input file.xml --restrict $(hwloc-calc --input file.xml node:1) nieuwbestand.xml

Een samenvatting van de topologie weergeven:

lstopo -s

Voor meer informatie over de topologie:

lstopo -v

Om alleen kernen weer te geven:

lstopo --alleen kern

CPUsets weergeven:

lstopo --cpuset

Om alleen de CPUsets van het pakket te tonen:

lstopo --alleen pakket --cpuset-only

Simuleer een nephiërarchie; dit voorbeeld toont met 2 NUMA-knooppunten van 2 processoreenheden:

lstopo --invoer "n:2 2"

Het aantal logische processors in het systeem tellen

lstopo --alleen pu | wc -l

Om de kernelrelease en versie toe te voegen aan de grafische legenda:

lstopo --append-legend "Kernel-release: $(uname -r)" --append-legend "Kernelversie:
$(uname -v)"

Gebruik lstopo online met onworks.net-services