lstopo - En ligne dans le Cloud

PROGRAMME:

Nom

lstopo, lstopo-no-graphics, hwloc-ls - Affiche la topologie du système

SYNOPSIS

l'arrêt [ Options ]... [ nom de fichier ]

lstopo-pas-de-graphiques [ Options ]... [ nom de fichier ]

hwloc-ls [ Options ]... [ nom de fichier ]

Notez que coquelicot(7) fournit une explication détaillée du système hwloc ; il faut le lire
avant de lire cette page de manuel

OPTIONS

--de , --format de sortie
Appliquer la sortie dans le format donné. Voir la section FORMATS DE SORTIE ci-dessous.

-i , --saisir
Lire la topologie à partir du fichier XML (au lieu de découvrir la topologie sur le
machine locale). Si est "-", l'entrée standard est utilisée. La prise en charge de XML doit
ont été compilés dans hwloc pour que cette option soit utilisable.

-i , --saisir
Lire la topologie à partir du chroot spécifié par (au lieu de découvrir le
topologie sur la machine locale). Cette option n'est généralement disponible que sur Linux.
Le chroot était généralement créé en rassemblant une autre topologie de machine avec hwloc-
topologie de rassemblement.

-i , --saisir
Simuler une fausse hiérarchie (au lieu de découvrir la topologie sur le local
machine). Si est "node:2 pu:3", la topologie contiendra deux NUMA
nœuds avec 3 unités de traitement dans chacun d'eux. Les la chaîne doit se terminer
avec un certain nombre de PU.

--si , --format-d'entrée
Appliquer l'entrée dans le format donné, parmi xml, racine_fs ainsi que haute .

--export-synthétiques-drapeaux
Appliquez les indicateurs lors de l'exportation au format synthétique. Ces drapeaux sont transmis à
hwloc_topology_export_synthetic(). Une valeur de 2 revient au format de hwloc
v1.9. Une valeur de 3 revient au format minimaliste d'origine (avant la v1.9).

-v --verbeux
Inclure des détails supplémentaires. L'outil hwloc-info peut être utilisé pour afficher encore plus
informations sur des objets spécifiques.

-s --silencieux
Réduisez le nombre de détails à afficher.

-f --Obliger
Si le fichier de destination existe déjà, écrasez-le.

-l --logique
Afficher les index logiques hwloc au lieu des index physiques/OS (par défaut pour la console
sortir). Ces index sont préfixés par "L#". Les index physiques de certains
les objets (PU et Node par défaut, tous les objets s'ils sont détaillés) apparaîtront en tant qu'objet
attribut "P#...".

-p --physique
Afficher les index OS/physiques au lieu des index logiques hwloc (par défaut pour les
sortir). Ces index sont préfixés par "P#" au lieu de "L#" dans la console
sortie.

-c --cpuset
Affichez le cpuset de chaque objet.

-C --cpuset-seulement
Afficher uniquement le cpuset de chaque objet ; n'affiche rien d'autre sur le
objet.

--ensemble de tâches
Afficher les chaînes d'ensemble de processeurs au format reconnu par le programme de ligne de commande de l'ensemble de tâches
au lieu du format de chaîne de définition de CPU spécifique à hwloc. Cette option doit être combinée
avec --cpuset or --cpuset-seulement, sinon cela impliquera --cpuset.

--seul
Afficher uniquement les objets du type donné dans la sortie textuelle.

--ignorer
Ignorer tous les objets de type dans la topologie. hwloc prend en charge l'ignorance de tout
type à l'exception des PU et des périphériques d'E/S. Cependant, lstopo propose toujours d'ignorer le PU en se cachant
Objets PU dans les sorties graphiques et textuelles. Notez que PU ne peut pas être ignoré
dans la sortie XML. Notez également que le type d'objet de niveau supérieur ne peut pas être ignoré
(généralement Machine ou Système).

--pas de cache
Ne pas afficher les caches.

--no-caches-inutiles
Ne pas afficher les caches qui n'ont pas d'impact hiérarchique. Cela appelle
hwloc_topology_ignore_type_keep_structure() pour les objets de cache.

--pas de caches
Ne pas afficher les caches d'instructions, seuls les caches de données et unifiés sont affichés.

--l'ensemble du système
Ne tenez pas compte des limitations administratives.

--fusionner
N'affichez pas les niveaux qui n'ont pas d'impact hiérarchique. Cela appelle
hwloc_topology_ignore_all_keep_structure().

--pas d'effondrement
Ne réduisez pas les périphériques PCI identiques. Par défaut, des périphériques PCI frères identiques
(telles que de nombreuses fonctions virtuelles à l'intérieur d'un seul périphérique physique) sont réduites.

--restreindre
Restreindre la topologie au cpuset donné.

--restreindre propriétés de liant
Restreignez la topologie à la liaison de processus actuelle. Cette option nécessite l'utilisation
de la topologie actuelle de la machine (ou toute autre topologie avec --ce système or
avec HWLOC_THISSYSTEM défini sur 1 dans l'environnement).

--restrict-drapeaux
Appliquez des indicateurs lors de la restriction de la topologie. La valeur par défaut est 0. Ces drapeaux sont
transmis à hwloc_topology_restrict().

--non-io
N'affiche aucun périphérique ou pont d'E/S. Par défaut, les périphériques courants (GPU, NIC,
blocs périphériques, ...) et des ponts intéressants sont affichés.

--pas de ponts
N'affiche aucun pont d'E/S à l'exception des ponts hôtes. Par défaut, les appareils courants (GPU,
Les cartes réseau, les périphériques de bloc, ...) et les ponts intéressants sont affichés.

--tout-io
Afficher tous les périphériques et ponts d'E/S. Par défaut, seuls les périphériques courants (GPU, NIC,
blocs périphériques, ...) et des ponts intéressants sont affichés.

--ce système
Supposons que le backend sélectionné fournisse la topologie du système sur lequel nous
sont en train de courir. Ceci est utile lors de l'utilisation --restreindre lier et charger un custom
topologie telle qu'un fichier XML.

--pid
Détecter la topologie vue par le processus , c'est-à-dire comme si le processus a fait le
découverte elle-même. Notez que cela peut par exemple changer l'ensemble des
processeurs. Affichez également la liaison CPU actuelle de ce processus en marquant le
les PU correspondantes (en Vert dans la sortie graphique, voir la section COULEURS ci-dessous,
ou en ajoutant (obligatoire) à la sortie de texte verbeux). Si 0 est donné comme pid, le
la liaison actuelle pour le processus lstopo sera affichée.

--PS --Haut
Afficher les processus existants en tant qu'objets divers dans la sortie. A éviter inutilement
encombrant la sortie, seuls les processus qui sont limités à une partie du
machine sont affichés. Sous Linux, les threads du noyau ne sont pas affichés. Si de nombreux processus
apparaissent, la sortie peut devenir difficile à lire de toute façon, rendant le programme hwloc-ps plus
pratique.

--taille de police
Définir la taille de la police du texte.

--taille de la grille
Définir la taille de la marge entre les éléments.

--horiz, --horiz=
Disposition graphique horizontale au lieu d'un rapport de près de 4/3. Si une liste séparée par des virgules
de types est donnée, la mise en page ne s'applique qu'aux conteneurs correspondants.

--vert, --vert=
Disposition graphique verticale au lieu d'un rapport de près de 4/3. Si une liste séparée par des virgules
de types est donnée, la mise en page ne s'applique qu'aux conteneurs correspondants.

--rect, --rect=
Disposition graphique rectangulaire avec un rapport de près de 4/3, y compris lors du placement de NUMA
nœuds. Si une liste de types séparés par des virgules est fournie, la mise en page ne s'applique qu'au
conteneurs correspondants.

--pas de légende
Supprimez la légende du texte en bas.

--append-légende
Ajouter la ligne de texte au bas de la légende en mode graphique. Si la ligne
est trop long, il sera tronqué dans la sortie. Si vous ajoutez plusieurs lignes, chacune
La ligne doit être fournie séparément en passant cette option plusieurs fois.

--version
Rapporter la version et quitter.

DESCRIPTION

lstopo et lstopo-no-graphics sont capables d'afficher une carte topologique du système dans
une variété de formats de sortie différents. La seule différence entre lstopo et lstopo-no-
graphiques est que les sorties graphiques ne sont prises en charge que par lstopo, pour réduire les dépendances sur
bibliothèques externes. hwloc-ls est identique à lstopo-no-graphics.

Le nom de fichier spécifié implique directement le format de sortie qui sera utilisé ; voir le
section FORMATS DE SORTIE, ci-dessous. Les formats de sortie qui prennent en charge la couleur indiqueront des
caractéristiques des processeurs individuels par leur couleur ; voir la section COULEURS, ci-dessous.

SORTIE FORMATS

Par défaut, si aucun nom de fichier de sortie n'est spécifique, la sortie est envoyée vers une fenêtre graphique si
possible dans l'environnement courant (variable d'environnement DISPLAY définie sous Unix, etc.).
Sinon, un résumé textuel s'affiche dans la console.

Le nom de fichier sur la ligne de commande détermine généralement le format de la sortie. Il y a un
quelques noms de fichiers qui indiquent des formats de sortie et des périphériques spécifiques (par exemple, un nom de fichier de "-"
affichera un résumé de texte sur stdout), mais la plupart des noms de fichiers indiquent la sortie souhaitée
format par leur suffixe (par exemple, "topo.png" loading="lazy" produira un fichier au format PNG).

Le format de la sortie peut également être modifié avec "--of". Par exemple, "--of pdf"
générer un fichier au format PDF sur la sortie standard, tandis que "--of fig toto" produira un
Fichier au format Xfig nommé "toto".

La liste des formats actuellement pris en charge est donnée ci-dessous. N'importe lequel d'entre eux peut être utilisé avec
"--of" ou comme suffixe de nom de fichier.

défaut
Envoyez la sortie vers une fenêtre ou vers la console en fonction de l'environnement.

console
Envoyez un résumé textuel à stdout. Les processeurs obligatoires, non autorisés ou hors ligne sont uniquement
annoté dans ce mode si verbeux ; voir la section COULEURS, ci-dessous.

ascii Sortez une représentation artistique ASCII de la carte (anciennement appelée txt). Si la sortie
à la sortie standard et si les couleurs sont prises en charge sur le terminal, la sortie sera
colorisé.

figue Sortez une représentation de la carte qui peut être chargée dans Xfig.

pdf Si lstopo a été compilé avec le support approprié, lstopo génère une représentation PDF
de la carte.

ps Si lstopo a été compilé avec le support approprié, lstopo génère un Postscript
représentation de la carte.

png Si lstopo a été compilé avec le support approprié, lstopo génère une représentation PNG
de la carte.

svg Si lstopo a été compilé avec le support approprié, lstopo génère un SVG
représentation de la carte.

haute
Si la topologie est symétrique (ce qui nécessite que l'objet racine ait son
symmetric_subtree field set), lstopo génère une chaîne de description synthétique. Cette
la sortie peut être réutilisée comme description de topologie synthétique d'entrée plus tard. Noter que
Les périphériques d'E/S provoquent souvent une asymétrie de topologie. L'ajout de --no-io peut alors être utile lorsque
l'export synthétique échoue. Voir aussi la section Topologies synthétiques dans le
Documentation.

xml Si lstopo a été compilé avec le support approprié, lstopo génère un XML
représentation de la carte. Il pourra être réutilisé ultérieurement, même sur une autre machine, avec
lstopo --input, la variable d'environnement HWLOC_XMLFILE ou le
fonction hwloc_topology_set_xml().

Les noms spéciaux suivants peuvent être utilisés :

- Envoyez un résumé textuel à stdout.

/dev/stdout
Envoyez un résumé textuel à stdout. C'est effectivement la même chose que de spécifier "-".

-.
Si le nom de fichier entier est "-. ", lstopo se comporte comme si "--of -" était
donné, ce qui signifie qu'un fichier du format donné est envoyé à la sortie standard.

Voir la sortie de "lstopo --help" pour une liste spécifique des formats de sortie graphiques
pris en charge dans votre installation hwloc.

DES COULEURS

Les processeurs individuels sont colorés dans les formats de sortie graphiques pour indiquer différents
Caractéristiques:

Vert La topologie est signalée telle qu'elle est vue par un processus spécifique (voir --pid), et la donnée
CPU est dans ce masque de liaison CPU de processus.

Blanc Le CPU est dans l'ensemble autorisé (voir ci-dessous). Si la topologie est signalée comme vue par
un processus spécifique (voir --pid), le CPU donné n'est pas non plus dans ce processus CPU
masque de liaison.

Rouge La CPU n'est pas dans l'ensemble autorisé (voir ci-dessous).

Noir Le processeur est hors ligne (tous les systèmes d'exploitation ne prennent pas en charge l'affichage des processeurs hors ligne).

L'« ensemble autorisé » est l'ensemble de processeurs auxquels le processus en cours est autorisé à se lier. Les
l'ensemble autorisé est généralement soit hérité du processus parent, soit défini par l'administrateur
qpolitiques sur le système. Les cpusets Linux sont un exemple de limitation de l'ensemble autorisé pour un
processus et ses enfants soient inférieurs à l'ensemble complet des processeurs du système.

Différents processus peuvent donc avoir des processeurs différents dans l'ensemble autorisé. Par conséquent, en invoquant
lstopo dans différents contextes et/ou car différents utilisateurs peuvent afficher des couleurs différentes pour
les mêmes processeurs individuels (par exemple, exécuter lstopo dans un contexte peut afficher un processeur spécifique comme
rouge, mais exécuter lstopo dans un contexte différent peut afficher le même processeur en blanc).

Certains modes de sortie lstopo, par exemple le mode console (sortie non graphique par défaut), ne
supporter les couleurs du tout. Le mode console affiche les caractéristiques ci-dessus en ajoutant
texte à chaque ligne PU si les messages détaillés sont activés.

SUR MESURE DES COULEURS

La couleur de chaque objet dans la sortie graphique peut être imposée en spécifiant un
Attribut d'information "lstopoStyle" dans cet objet. Sa valeur doit être un point-virgule séparé
liste de " =#rrggbb" où rr, gg et bb sont les composants RVB d'une couleur, chacun
entre 0 et 255, en hexadécimal (00 à ff). Peut être

Contexte
Définit la couleur d'arrière-plan de la boîte de l'objet principal.

Background2
Définit la couleur d'arrière-plan de la case supplémentaire pour l'objet, par exemple le
boîte de mémoire à l'intérieur d'une boîte de nœud NUMA.

Texte Définit la couleur du texte indiquant le nom, le type, l'index, etc. de l'objet.

Text2 Définit la couleur du texte supplémentaire près de l'objet, par exemple la vitesse de liaison
derrière un pont PCI.

Les informations "lstopoStyle" peuvent être ajoutées à des topologies XML temporairement enregistrées avec hwloc-
annoter, ou avec hwloc_obj_add_info(). Par exemple, pour afficher tous les objets principaux en bleu
(avec des noms blancs):

lstopo save.xml
hwloc-annotate save.xml save.xml core:toutes les infos lstopoStyle
"Arrière-plan=#0000ff;Texte=#ffffff"
lstopo -je sauvegarde.xml

LAYOUT

Dans sa sortie graphique, lstopo utilise une simple heuristique rectangulaire pour essayer d'atteindre un 4/3
rapport entre la largeur et la hauteur. Cependant, dans le cas particulier des nœuds NUMA, la disposition
est toujours un rectangle plat, pour éviter de laisser croire à l'utilisateur une topologie NUMA particulière
(lstopo n'est pas encore capable de le rendre). La disposition d'un niveau peut être modifiée avec
--vert, --horiz et --rect.

EXEMPLES

Pour afficher la topologie de la machine en mode textuel :

lstopo-pas-de-graphiques

Pour afficher la topologie de la machine en mode ascii-art :

lstopo-no-graphics -.ascii

Pour afficher en mode graphique (en supposant que la variable d'environnement DISPLAY est définie sur un
valeur pertinente):

l'arrêt

Pour exporter la topologie dans un fichier PNG :

fichier lstopo.png

Pour exporter un fichier XML sur une machine et afficher ultérieurement la sortie graphique correspondante sur
une autre machine :

machine1$ lstopo fichier.xml

machine2$ lstopo --input fichier.xml

Pour enregistrer la topologie actuelle de la machine au format XML et la recharger ultérieurement plus rapidement tout en
en la considérant comme la machine actuelle :

$ lstopo fichier.xml
<...>
$ lstopo --input fichier.xml --cesystème

Pour restreindre une topologie XML aux seuls processeurs physiques 0, 1, 4 et 5 :

lstopo --input fichier.xml --restrict 0x33 nouveaufichier.xml

Pour restreindre une topologie XML au seul nœud numa dont l'index logique est 1 :

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

Pour afficher un récapitulatif de la topologie :

lstopo -s

Pour obtenir plus de détails sur la topologie :

lstopo -v

Pour afficher uniquement les cœurs :

lstopo --seulement noyau

Pour afficher les cpusets :

lstopo --cpuset

Pour afficher uniquement les cpusets du package :

lstopo --only package --cpuset-only

Simulez une fausse hiérarchie ; cet exemple montre avec 2 nœuds NUMA de 2 unités de traitement :

lstopo --input "n:2 2"

Pour compter le nombre de processeurs logiques dans le système

lstopo --seulement pu | wc -l

Pour ajouter la version et la version du noyau à la légende graphique :

lstopo --append-legend "Version du noyau : $(uname -r)" --append-legend "Version du noyau :
$(uname -v)"

Utilisez lstopo en ligne en utilisant les services onworks.net