lstopo - Online în cloud

PROGRAM:

NUME

lstopo, lstopo-no-graphics, hwloc-ls - Afișează topologia sistemului

REZUMAT

lstopo [ Opțiuni ]... [ nume de fișier ]

lstopo-no-graphics [ Opțiuni ]... [ nume de fișier ]

hwloc-ls [ Opțiuni ]... [ nume de fișier ]

Rețineți că hulloc(7) oferă o explicație detaliată a sistemului hwloc; ar trebui citit
înainte de a citi această pagină de manual

OPŢIUNI

--de , --format de iesire
Implementați rezultatul în formatul dat. Consultați secțiunea FORMATE DE IESIRE de mai jos.

-i , --intrare
Citiți topologia din fișierul XML (în loc să descoperi topologia pe
mașină locală). Dacă este „-”, este utilizată intrarea standard. Suportul XML trebuie
au fost compilate în hwloc pentru ca această opțiune să fie utilizabilă.

-i , --intrare
Citiți topologia din chroot-ul specificat de (în loc să descoperi
topologie pe mașina locală). Această opțiune este în general disponibilă numai pe Linux.
Chroot-ul a fost de obicei creat prin adunarea unei alte topologii de mașină cu hwloc-
aduna-topologie.

-i , --intrare
Simulați o ierarhie falsă (în loc să descoperiți topologia pe local
mașinărie). Dacă este „node:2 pu:3”, topologia va conține două NUMA
noduri cu 3 unități de procesare în fiecare dintre ele. The șirul trebuie să se termine
cu un număr de PU.

--dacă , --formatul de intrare
Forțați intrarea în formatul dat, printre xml, fsroot și sintetic.

--export-steaguri-sintetice
Aplicați steaguri atunci când exportați în format sintetic. Aceste steaguri sunt transmise
hwloc_topology_export_synthetic(). O valoare de 2 revine la formatul hwloc
v1.9. O valoare de 3 revine la formatul minimalist original (înainte de v1.9).

-v --verbos
Includeți detalii suplimentare. Instrumentul hwloc-info poate fi folosit pentru a afișa și mai multe
informații despre anumite obiecte.

-s --tăcut
Reduceți cantitatea de detalii de afișat.

-f --forta
Dacă fișierul destinație există deja, suprascrieți-l.

-l --logic
Afișează indecșii logici hwloc în loc de indecșii fizici/OS (implicit pentru console
ieșire). Acești indecși sunt prefixați cu „L#”. Indicii fizici ai unora
obiectele (PU și Node în mod implicit, toate obiectele dacă sunt detaliate) vor apărea ca obiect
atributul „P#...”.

-p --fizic
Afișați indici OS/fizici în loc de indecși logici hwloc (implicit pentru grafic
ieșire). Acești indecși sunt prefixați cu „P#” în loc de „L#” în consolă
ieșire.

-c --cpuset
Afișați setul de procesare al fiecărui obiect.

-C --cpuset-only
Afișează numai setul de procesare al fiecărui obiect; nu afișați nimic altceva despre
obiect.

--setul de sarcini
Afișați șirurile setului CPU în formatul recunoscut de programul de linie de comandă al setului de activități
în loc de formatul de șir set de CPU specific hwloc. Această opțiune ar trebui combinată
cu --cpuset or --cpuset-only, altfel va implica --cpuset.

--numai
Afișați numai obiectele de tipul dat în rezultatul textual.

--ignora
Ignorați toate obiectele de tip în topologie. hwloc acceptă ignorarea oricăror
tip, cu excepția PU-urilor și a dispozitivelor I/O. Cu toate acestea, lstopo încă oferă ignorarea PU prin ascundere
Obiecte PU în ieșirile grafice și textuale. Rețineți că PU nu poate fi ignorat
în ieșirea XML. Rețineți, de asemenea, că tipul de obiect de nivel superior nu poate fi ignorat
(de obicei, mașină sau sistem).

--fără-cache
Nu afișați cache-urile.

--no-cache-uri inutile
Nu afișați cache-urile care nu au un impact ierarhic. Aceasta cheamă
hwloc_topology_ignore_type_keep_structure() pentru obiectele cache.

--no-icaches
Nu afișați cache-urile de instrucțiuni, sunt afișate doar cache-urile de date și unificate.

--intregul sistem
Nu luați în considerare limitările de administrare.

--combina
Nu afișați niveluri care nu au un impact ierarhic. Aceasta cheamă
hwloc_topology_ignore_all_keep_structure().

--fara-colaps
Nu prăbușiți dispozitive PCI identice. În mod implicit, dispozitive PCI frați identice
(cum ar fi multe funcții virtuale dintr-un singur dispozitiv fizic) sunt prăbușite.

--restric
Restricționați topologia la setul de procesare dat.

--restric legare
Limitați topologia la legarea curentă a procesului. Această opțiune necesită utilizarea
a topologiei actuale a mașinii (sau orice altă topologie cu --acest sistem or
cu HWLOC_THISSYSTEM setat la 1 în mediu).

--restricționați-steaguri
Aplicați steaguri atunci când restricționați topologia. Valoarea implicită este 0. Aceste steaguri sunt
transferat la hwloc_topology_restrict().

--nu-io
Nu afișați niciun dispozitiv I/O sau bridge. În mod implicit, dispozitivele comune (GPU-uri, NIC-uri,
dispozitive bloc, ...) și punți interesante sunt prezentate.

--fără poduri
Nu afișați nicio punte I/O, cu excepția hostbridge-urilor. În mod implicit, dispozitivele comune (GPU-uri,
Sunt afișate NIC-uri, dispozitive bloc, ...) și poduri interesante.

--tot-io
Afișați toate dispozitivele I/O și punțile. În mod implicit, numai dispozitivele obișnuite (GPU-uri, NIC-uri,
dispozitive bloc, ...) și punți interesante sunt prezentate.

--acest sistem
Să presupunem că backend-ul selectat oferă topologia sistemului pe care noi
alearga. Acest lucru este util când se utilizează --restric legarea și încărcarea unui custom
topologie, cum ar fi un fișier XML.

--pid
Detectați topologia așa cum este văzută de proces , adică parcă proces a făcut
descoperirea în sine. Rețineți că acest lucru poate schimba, de exemplu, setul de permise
procesoare. De asemenea, arată acest proces legarea curentă a procesorului prin marcarea
PU corespunzătoare (în verde în rezultatul grafic, vezi secțiunea CULORI de mai jos,
sau prin anexare (legare) la ieșirea textului verbos). Dacă 0 este dat ca pid,
va fi afișată legarea curentă pentru procesul lstopo.

--ps --top
Afișați procesele existente ca obiecte diverse în rezultat. Pentru a evita inutil
aglomerarea ieșirii, doar procesele care sunt limitate la o anumită parte a
aparatul sunt prezentate. Pe Linux, firele de nucleu nu sunt afișate. Dacă multe procese
apare, rezultatul poate deveni oricum greu de citit, făcând programul hwloc-ps mai mult
practic.

--marimea fontului
Setați dimensiunea fontului textului.

--dimensiunea grilei
Setați dimensiunea marjei între elemente.

--oriz, --oriz=
Aspect grafic orizontal în loc de raport de aproape 4/3. Dacă o listă separată prin virgulă
de tipuri este dat, aspectul se aplică numai containerelor corespunzătoare.

--vert, --vert=
Aspect grafic vertical în loc de raportul de aproape 4/3. Dacă o listă separată prin virgulă
de tipuri este dat, aspectul se aplică numai containerelor corespunzătoare.

--rect, --rect=
Aspect grafic dreptunghiular cu un raport de aproape 4/3, inclusiv atunci când plasați NUMA
noduri. Dacă este dată o listă de tipuri separate prin virgulă, aspectul se aplică numai pentru
containere corespunzătoare.

--no-legendă
Eliminați legenda textului din partea de jos.

--adăugați-legendă
Adăugați linia de text în partea de jos a legendei în modul grafic. Dacă linia
este prea lung, va fi trunchiat în ieșire. Dacă adăugați mai multe linii, fiecare
linia ar trebui să fie dată separat prin trecerea acestei opțiuni de mai multe ori.

--versiune
Raportați versiunea și ieșiți.

DESCRIERE

lstopo și lstopo-no-graphics sunt capabile să afișeze o hartă topologică a sistemului în
o varietate de formate de ieșire diferite. Singura diferență dintre lstopo și lstopo-no-
grafica este că ieșirile grafice sunt acceptate doar de lstopo, pentru a reduce dependențele de
biblioteci externe. hwloc-ls este identic cu lstopo-no-graphics.

Numele fișierului specificat implică direct formatul de ieșire care va fi utilizat; vezi
secțiunea FORMATE DE IESIRE, mai jos. Formatele de ieșire care acceptă culoarea vor indica anumite
caracteristici despre procesoarele individuale după culoarea lor; vezi mai jos sectiunea CULORI.

REZULTATE FORMATE

În mod implicit, dacă niciun nume de fișier de ieșire nu este specific, rezultatul este trimis la o fereastră grafică dacă
posibil în mediul curent (variabila de mediu DISPLAY setată pe Unix etc.).
În caz contrar, un rezumat text este afișat în consolă.

Numele fișierului de pe linia de comandă determină de obicei formatul de ieșire. Există o
câteva nume de fișiere care indică anumite formate de ieșire și dispozitive (de exemplu, un nume de fișier „-”
va scoate un rezumat text către stdout), dar majoritatea numelor de fișiere indică rezultatul dorit
format după sufixul lor (de exemplu, "topo.png" loading="lazy" va scoate un fișier în format PNG).

Formatul de ieșire poate fi, de asemenea, modificat cu „--of”. De exemplu, „--of pdf” va
generați un fișier în format PDF pe rezultatul standard, în timp ce „--of fig toto” va scoate a
Fișier în format Xfig numit „toto”.

Lista formatelor acceptate în prezent este prezentată mai jos. Oricare dintre ele poate fi folosit cu
„--of” sau ca sufix de nume de fișier.

lipsă
Trimiteți rezultatul către o fereastră sau către consolă, în funcție de mediu.

consolă
Trimiteți un rezumat text către stdout. Procesoare obligatorii, nepermise sau offline sunt numai
adnotat în acest mod dacă este verbos; vezi mai jos sectiunea CULORI.

ascii Produceți o reprezentare artistică ASCII a hărții (denumită anterior txt). Dacă iese
la stdout și dacă culorile sunt acceptate pe terminal, ieșirea va fi
colorat.

smochin Produceți o reprezentare a hărții care poate fi încărcată în Xfig.

pdf Dacă lstopo a fost compilat cu suportul adecvat, lstopo scoate o reprezentare PDF
a hărții.

ps Dacă lstopo a fost compilat cu suportul adecvat, lstopo scoate un Postscript
reprezentarea hărții.

png Dacă lstopo a fost compilat cu suportul adecvat, lstopo scoate o reprezentare PNG
a hărții.

svg Dacă lstopo a fost compilat cu suportul adecvat, lstopo scoate un SVG
reprezentarea hărții.

sintetic
Dacă topologia este simetrică (ceea ce necesită ca obiectul rădăcină să aibă sale
set de câmpuri symmetric_subtree), lstopo emite un șir de descriere sintetică. Acest
ieșirea poate fi reutilizată ca o descriere a topologiei sintetice de intrare mai târziu. Rețineți că
Dispozitivele I/O cauzează adesea asimetrie topologică. Adăugarea --no-io poate fi utilă atunci când
exportul sintetic eșuează. Vezi, de asemenea, secțiunea Topologii sintetice din
documentație.

xml Dacă lstopo a fost compilat cu suportul adecvat, lstopo scoate un XML
reprezentarea hărții. Poate fi reutilizat ulterior, chiar și pe o altă mașină, cu
lstopo --input, variabila de mediu HWLOC_XMLFILE sau
funcția hwloc_topology_set_xml().

Pot fi folosite următoarele denumiri speciale:

- Trimiteți un rezumat text către stdout.

/dev/stdout
Trimiteți un rezumat text către stdout. Este efectiv același cu specificarea „-”.

-.
Dacă întregul nume de fișier este „-. ", lstopo se comportă ca și cum „--of -" a fost
dat, ceea ce înseamnă că un fișier cu formatul dat este trimis la ieșirea standard.

Consultați rezultatul „lstopo --help” pentru o listă specifică a formatelor de ieșire grafică
acceptat în instalarea dvs. hwloc.

CULORI

Procesoarele individuale sunt colorate în formatele grafice de ieșire pentru a indica diferite
caracteristici:

Verde Topologia este raportată așa cum este văzută de un proces specific (vezi --pid), și dat
CPU este în acest proces masca de legare CPU.

Alb CPU este în setul permis (vezi mai jos). Dacă topologia este raportată așa cum este văzută de
un proces specific (vezi --pid), CPU-ul dat nu este, de asemenea, în acest procesor
masca de legare.

Roșu CPU nu este în setul permis (vezi mai jos).

Negru CPU este offline (nu toate sistemele de operare suportă afișarea procesoarelor offline).

„Setul permis” este setul de procesoare la care procesul curent este permis să se lege. The
setul permis este de obicei fie moștenit de la procesul părinte, fie stabilit de administrativ
qpolitici asupra sistemului. Seturile de procesoare Linux sunt un exemplu de limitare a setului permis pentru a
procesului și copiii săi să fie mai mici decât setul complet de procesoare de pe sistem.

Procesele diferite pot avea, prin urmare, procesoare diferite în setul permis. Prin urmare, invocarea
lstopo în contexte diferite și/sau ca utilizatori diferiți pot afișa culori diferite pentru
aceleași procesoare individuale (de exemplu, rularea lstopo într-un context poate afișa un anumit procesor ca
roșu, dar rularea lstopo într-un context diferit poate afișa același procesor ca alb).

Unele moduri de ieșire lstopo, de exemplu modul consolă (ieșire negrafică implicită), nu
susține deloc culorile. Modul consolă afișează caracteristicile de mai sus prin adăugare
text la fiecare linie PU dacă sunt activate mesajele detaliate.

PERSONALIZAT CULORI

Culoarea fiecărui obiect din rezultatul grafic poate fi impusă prin specificarea a
Atributul de informații „lstopoStyle” în acel obiect. Valoarea sa ar trebui să fie separată de un punct și virgulă
lista de " =#rrggbb" unde rr, gg și bb sunt componentele RGB ale unei culori, fiecare
între 0 și 255, în hexazecimal (00 la ff). poate

Context
Setează culoarea de fundal a casetei obiectului principal.

Background2
Setează culoarea de fundal a casetei suplimentare pentru obiect, de exemplu
caseta de memorie în interiorul unei casete de nod NUMA.

Text Setează culoarea textului arătând numele obiectului, tipul, indexul etc.

Textul 2 Setează culoarea textului suplimentar din apropierea obiectului, de exemplu viteza conexiunii
în spatele unui pod PCI.

Informațiile „lstopoStyle” pot fi adăugate la o topologii XML salvate temporar cu hwloc-
adnotare sau cu hwloc_obj_add_info(). De exemplu, pentru a afișa toate obiectele de bază în albastru
(cu nume albe):

lstopo save.xml
hwloc-annotate save.xml save.xml core:toate informațiile lstopoStyle
„Background=#0000ff;Text=#ffffff”
lstopo -i salvez.xml

STRUCTURA

În ieșirea sa grafică, lstopo folosește euristici dreptunghiulare simple pentru a încerca să obțină un 4/3
raportul dintre latime si inaltime. Cu toate acestea, în cazul particular al nodurilor NUMA, aspectul
este întotdeauna un dreptunghi plat, pentru a evita lăsarea utilizatorului să creadă în orice topologie NUMA anume
(lstopo nu este capabil să redea asta încă). Dispunerea unui nivel poate fi schimbată cu
--vert, --horiz și --rect.

EXEMPLE

Pentru a afișa topologia mașinii în modul textual:

lstopo-no-graphics

Pentru a afișa topologia mașinii în modul ascii-art:

lstopo-no-graphics -.ascii

Pentru a afișa în modul grafic (presupunând că variabila de mediu DISPLAY este setată la a
valoare relevantă):

lstopo

Pentru a exporta topologia într-un fișier PNG:

lstopo file.png

Pentru a exporta un fișier XML pe o mașină și a afișa ulterior rezultatul grafic corespunzător
alta masina:

machine1$ lstopo file.xml

machine2$ lstopo --input file.xml

Pentru a salva topologia actuală a mașinii în XML și, ulterior, a o reîncărca mai repede cât timp este încă
considerând-o ca fiind mașina actuală:

$ lstopo file.xml
<...>
$ lstopo --input file.xml --thissystem

Pentru a restricționa o topologie XML doar la procesoarele fizice 0, 1, 4 și 5:

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

Pentru a restricționa o topologie XML la numai nodul numa al cărui index logic este 1:

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

Pentru a afișa un rezumat al topologiei:

lstopo -s

Pentru a obține mai multe detalii despre topologie:

lstopo -v

Pentru a afișa numai nuclee:

lstopo --doar miezul

Pentru a afișa cpusets:

lstopo --cpuset

Pentru a afișa numai seturile de procese ale pachetului:

lstopo --only package --cpuset-only

Simulați o ierarhie falsă; acest exemplu arată cu 2 noduri NUMA a 2 unități de procesor:

lstopo --input "n:2 2"

Pentru a număra numărul de procesoare logice din sistem

lstopo --numai pu | wc -l

Pentru a adăuga ediția și versiunea nucleului la legenda grafică:

lstopo --append-legend „Versiune kernel: $(uname -r)” --append-legend „Versiune kernel:
$(uname -v)"

Utilizați lstopo online folosind serviciile onworks.net