lstopo - Online en la nube

PROGRAMA:

NOMBRE

lstopo, lstopo-no-graphics, hwloc-ls: muestra la topología del sistema

SINOPSIS

lstopo [ opciones ] ... [ nombre de archivo ]

lstopo-sin-gráficos [ opciones ] ... [ nombre de archivo ]

hwloc-ls [ opciones ] ... [ nombre de archivo ]

Tenga en cuenta que hwloc(7) proporciona una explicación detallada del sistema hwloc; debe ser leído
antes de leer esta página de manual

CAMPUS

--de , --formato de salida
Hacer cumplir la salida en el formato dado. Consulte la sección FORMATOS DE SALIDA a continuación.

-i , --aporte
Leer topología del archivo XML (en lugar de descubrir la topología en el
máquina local). Si es "-", se utiliza la entrada estándar. El soporte XML debe
se han compilado en hwloc para que esta opción sea utilizable.

-i , --aporte
Leer topología del chroot especificado por (en lugar de descubrir el
topología en la máquina local). Esta opción generalmente solo está disponible en Linux.
El chroot generalmente se creaba reuniendo otra topología de máquina con hwloc-
recopilar topología.

-i , --aporte
Simule una jerarquía falsa (en lugar de descubrir la topología en el local
máquina). Si es "nodo: 2 pu: 3", la topología contendrá dos NUMA
nodos con 3 unidades de procesamiento en cada uno de ellos. los la cadena debe terminar
con una serie de PU.

--si , --formato de entrada
Hacer cumplir la entrada en el formato dado, entre xml, fsroot y sintético.

--banderas-sintéticas-de-exportación
Haga cumplir las banderas al exportar al formato sintético. Estas banderas se pasan a
hwloc_topology_export_synthetic (). Un valor de 2 vuelve al formato de hwloc
v1.9. Un valor de 3 vuelve al formato minimalista original (antes de la v1.9).

-v --verboso
Incluya detalles adicionales. La herramienta hwloc-info puede usarse para mostrar aún más
información sobre objetos específicos.

-s --silencio
Reduzca la cantidad de detalles para mostrar.

-f --fuerza
Si el archivo de destino ya existe, sobrescríbalo.

-l --lógico
Mostrar índices lógicos de hwloc en lugar de índices físicos / del sistema operativo (predeterminado para la consola
producción). Estos índices tienen el prefijo "L #". Los índices físicos de algunos
Los objetos (PU y Nodo por defecto, todos los objetos si son detallados) aparecerán como objeto
atributo "P # ...".

-p --físico
Muestra los índices físicos / del sistema operativo en lugar de los índices lógicos de hwloc (predeterminado para gráficos
producción). Estos índices tienen el prefijo "P #" en lugar de "L #" en la consola.
salida.

-c --cpuset
Muestre el cpuset de cada objeto.

-C --cpuset-solo
Muestra solo el cpuset de cada objeto; no muestre nada más sobre el
objeto.

--tareas
Mostrar cadenas de conjuntos de CPU en el formato reconocido por el programa de línea de comandos del conjunto de tareas
en lugar del formato de cadena de conjunto de CPU específico de hwloc. Esta opción debe combinarse
--cpuset or --cpuset-solo, de lo contrario implicará --cpuset.

--solo
Mostrar solo objetos del tipo dado en la salida textual.

--ignorar
Ignorar todos los objetos de tipo en la topología. hwloc admite ignorar cualquier
tipo excepto PU y dispositivos de E / S. Sin embargo, lstopo todavía ofrece PU ignorando al ocultar
Objetos PU en las salidas gráficas y textuales. Tenga en cuenta que PU no se puede ignorar
en la salida XML. Tenga en cuenta también que el tipo de objeto de nivel superior no se puede ignorar
(generalmente Máquina o Sistema).

--no-cachés
No mostrar cachés.

--no-inútiles-cachés
No muestre cachés que no tengan un impacto jerárquico. Esto llama
hwloc_topology_ignore_type_keep_structure () para objetos de caché.

--sin-caches
No mostrar cachés de instrucciones, solo se muestran cachés de datos y unificados.

- sistema completo
No considere las limitaciones de administración.

--unir
No muestre niveles que no tengan un impacto jerárquico. Esto llama
hwloc_topology_ignore_all_keep_structure ().

--no-colapso
No colapse dispositivos PCI idénticos. De forma predeterminada, dispositivos PCI hermanos idénticos
(como muchas funciones virtuales dentro de un solo dispositivo físico) están colapsados.

--restringir
Restrinja la topología al cpuset dado.

--restringir uniéndose
Restrinja la topología al enlace del proceso actual. Esta opción requiere el uso
de la topología de la máquina actual real (o cualquier otra topología con --este sistema or
con HWLOC_THISSYSTEM establecido en 1 en el entorno).

- banderas-de-restricción
Aplique banderas al restringir la topología. El valor predeterminado es 0. Estas banderas son
pasó a hwloc_topology_restrict ().

--no-io
No muestre ningún dispositivo de E / S o puente. De forma predeterminada, los dispositivos comunes (GPU, NIC,
dispositivos de bloque, ...) y se muestran puentes interesantes.

--no puentes
No muestre ningún puente de E / S excepto los puentes host. De forma predeterminada, los dispositivos comunes (GPU,
Se muestran NIC, dispositivos de bloque, ...) y puentes interesantes.

--todo-io
Muestre todos los dispositivos y puentes de E / S. De forma predeterminada, solo los dispositivos comunes (GPU, NIC,
dispositivos de bloque, ...) y se muestran puentes interesantes.

--este sistema
Suponga que el backend seleccionado proporciona la topología para el sistema en el que
estan corriendo. Esto es útil cuando se usa --restringir encuadernación y carga de una aduana
topología como un archivo XML.

--pid
Detecta la topología como la ve el proceso , es decir, como si un proceso hizo el
descubrimiento en sí. Tenga en cuenta que esto puede, por ejemplo, cambiar el conjunto de permitidos
procesadores. También muestre el enlace de CPU actual de este proceso marcando el
PU correspondientes (en verde en la salida gráfica, consulte la sección COLORES a continuación,
o agregando (vinculante) a la salida de texto detallado). Si 0 se da como pid, el
Se mostrará el enlace actual para el proceso lstopo.

--PD --cima
Muestre los procesos existentes como objetos misceláneos en la salida. Para evitar inútilmente
saturando la salida, solo los procesos que están restringidos a alguna parte del
se muestran la máquina. En Linux, no se muestran los subprocesos del kernel. Si muchos procesos
aparecen, la salida puede volverse difícil de leer de todos modos, haciendo que el programa hwloc-ps sea más
práctico.

--tamaño de fuente
Establecer el tamaño de la fuente del texto.

--tamaño de la cuadrícula
Establece el tamaño del margen entre elementos.

--horiz, --horiz=
Diseño gráfico horizontal en lugar de una relación de casi 4/3. Si una lista separada por comas
de tipos, el diseño solo se aplica a los contenedores correspondientes.

--vertir, --vertir=
Diseño gráfico vertical en lugar de una relación de casi 4/3. Si una lista separada por comas
de tipos, el diseño solo se aplica a los contenedores correspondientes.

--recto, --recto=
Diseño gráfico rectangular con una relación de casi 4/3, incluso al colocar NUMA
nodos. Si se proporciona una lista de tipos separados por comas, el diseño solo se aplica a
contenedores correspondientes.

--no-leyenda
Elimina la leyenda de texto en la parte inferior.

--añadir-leyenda
Agregue la línea de texto al final de la leyenda en modo gráfico. Si la linea
es demasiado largo, se truncará en la salida. Si agrega varias líneas, cada
La línea se debe dar por separado pasando esta opción varias veces.

--versión
Informar de la versión y salir.

DESCRIPCIÓN

lstopo y lstopo-no-graphics son capaces de mostrar un mapa topológico del sistema en
una variedad de formatos de salida diferentes. La única diferencia entre lstopo y lstopo-no-
gráficos es que las salidas gráficas solo son compatibles con lstopo, para reducir las dependencias en
bibliotecas externas. hwloc-ls es idéntico a lstopo-no-graphics.

El nombre de archivo especificado implica directamente el formato de salida que se utilizará; ver el
Sección FORMATOS DE SALIDA, a continuación. Los formatos de salida que admiten el color indicarán
características de las CPU individuales por su color; consulte la sección COLORES, a continuación.

SALIDA FORMATOS

De forma predeterminada, si no hay un nombre de archivo de salida específico, la salida se envía a una ventana gráfica si
posible en el entorno actual (variable de entorno DISPLAY configurada en Unix, etc.).
De lo contrario, se muestra un resumen de texto en la consola.

El nombre de archivo en la línea de comando generalmente determina el formato de la salida. Hay un
pocos nombres de archivo que indiquen dispositivos y formatos de salida específicos (por ejemplo, un nombre de archivo de "-"
generará un resumen de texto en stdout), pero la mayoría de los nombres de archivo indican la salida deseada
formato por su sufijo (por ejemplo, "topo.png" loading = "lazy" generará un archivo en formato PNG).

El formato de la salida también se puede cambiar con "--of". Por ejemplo, "--of pdf"
generar un archivo en formato PDF en la salida estándar, mientras que "--of fig toto" generará una
Archivo de formato Xfig llamado "toto".

La lista de formatos admitidos actualmente se proporciona a continuación. Cualquiera de ellos puede usarse con
"--of" o como sufijo de nombre de archivo.

tu préstamo estudiantil
Envíe la salida a una ventana oa la consola según el entorno.

un mueble consola
Envíe un resumen de texto a stdout. Los procesadores vinculantes, no permitidos o fuera de línea son solo
anotado en este modo si es detallado; consulte la sección COLORES, a continuación.

ascii Genere una representación artística ASCII del mapa (anteriormente llamado txt). Si emite
a stdout y si los colores son compatibles con el terminal, la salida será
coloreado.

higo Genere una representación del mapa que se puede cargar en Xfig.

pdf Si lstopo se compiló con el soporte adecuado, lstopo genera una representación en PDF
del mapa.

ps Si lstopo se compiló con el soporte adecuado, lstopo genera un Postscript
representación del mapa.

png Si lstopo se compiló con el soporte adecuado, lstopo genera una representación PNG
del mapa.

SVG Si lstopo se compiló con el soporte adecuado, lstopo genera un SVG
representación del mapa.

sintético
Si la topología es simétrica (lo que requiere que el objeto raíz tenga su
conjunto de campos symmetric_subtree), lstopo genera una cadena de descripción sintética. Esta
la salida se puede reutilizar como una descripción de topología sintética de entrada más adelante. Tenga en cuenta que
Los dispositivos de E / S a menudo causan asimetría en la topología. Agregar --no-io puede ser útil cuando
la exportación sintética falla. Consulte también la sección Topologías sintéticas en la
documentación.

xml Si lstopo se compiló con el soporte adecuado, lstopo genera un XML
representación del mapa. Puede reutilizarse más tarde, incluso en otra máquina, con
lstopo --input, la variable de entorno HWLOC_XMLFILE o la
Función hwloc_topology_set_xml ().

Se pueden utilizar los siguientes nombres especiales:

- Envíe un resumen de texto a stdout.

/ dev / stdout
Envíe un resumen de texto a stdout. Efectivamente, es lo mismo que especificar "-".

-.
Si el nombre de archivo completo es "-. ", lstopo se comporta como si" --de -" era
dado, lo que significa que se envía un archivo del formato dado a la salida estándar.

Consulte la salida de "lstopo --help" para obtener una lista específica de los formatos de salida gráficos
admitido en su instalación de hwloc.

COLORES

Las CPU individuales están coloreadas en los formatos de salida gráficos para indicar diferentes
características:

Verde La topología se informa como la ve un proceso específico (consulte --pid), y el dado
La CPU está en este proceso, la máscara de enlace de la CPU.

Blanco La CPU está en el conjunto permitido (ver más abajo). Si la topología se informa como la ve
un proceso específico (ver --pid), la CPU dada tampoco está en este proceso CPU
máscara de unión.

Rojo La CPU no está en el conjunto permitido (ver más abajo).

Negro La CPU está fuera de línea (no todos los sistemas operativos admiten CPU fuera de línea).

El "conjunto permitido" es el conjunto de CPU a las que se permite enlazar el proceso actual. los
El conjunto permitido generalmente se hereda del proceso principal o lo establece el administrador.
qpolíticas del sistema. Los cpusets de Linux son un ejemplo de cómo limitar el conjunto permitido para un
proceso y sus elementos secundarios sean menores que el conjunto completo de CPU del sistema.

Por lo tanto, diferentes procesos pueden tener diferentes CPU en el conjunto permitido. Por lo tanto, invocando
lstopo en diferentes contextos y / o como diferentes usuarios pueden mostrar diferentes colores para
las mismas CPU individuales (por ejemplo, ejecutar lstopo en un contexto puede mostrar una CPU específica como
rojo, pero ejecutar lstopo en un contexto diferente puede mostrar la misma CPU que en blanco).

Algunos modos de salida de lstopo, por ejemplo, el modo de consola (salida no gráfica predeterminada), no
Apoyar los colores en absoluto. El modo de consola muestra las características anteriores agregando
enviar texto a cada línea PU si los mensajes detallados están habilitados.

PERSONALIZADO COLORES

El color de cada objeto en la salida gráfica se puede aplicar especificando un
Atributo de información "lstopoStyle" en ese objeto. Su valor debe estar separado por punto y coma.
lista de " = # rrggbb "donde rr, gg y bb son los componentes RGB de un color, cada uno
entre 0 y 255, en hexadecimal (00 a ff). quizás

Antecedentes
Establece el color de fondo del cuadro del objeto principal.

Background2
Establece el color de fondo del cuadro adicional para el objeto, por ejemplo, el
caja de memoria dentro de una caja de nodo NUMA.

Texto Establece el color del texto que muestra el nombre del objeto, tipo, índice, etc.

Text2 Establece el color del texto adicional cerca del objeto, por ejemplo, la velocidad del enlace.
detrás de un puente PCI.

La información "lstopoStyle" se puede agregar a topologías XML guardadas temporalmente con hwloc-
anotar, o con hwloc_obj_add_info (). Por ejemplo, para mostrar todos los objetos principales en azul
(con nombres blancos):

lstopo guardar.xml
hwloc-annotate save.xml save.xml core: toda la información lstopoStyle
"Fondo = # 0000ff; Texto = # ffffff"
lstopo -yo guardo.xml

DISPOSICIÓN

En su salida gráfica, lstopo usa heurísticas rectangulares simples para tratar de lograr un 4/3
Relación entre ancho y alto. Sin embargo, en el caso particular de los nodos NUMA, el diseño
es siempre un rectángulo plano, para evitar que el usuario crea una topología NUMA en particular
(lstopo aún no puede representar eso). El diseño de un nivel se puede cambiar con
--vert, --horiz y --rect.

EJEMPLOS

Para mostrar la topología de la máquina en modo textual:

lstopo-sin-gráficos

Para mostrar la topología de la máquina en modo ascii-art:

lstopo-sin-gráficos -.ascii

Para mostrar en modo gráfico (asumiendo que la variable de entorno DISPLAY se establece en un
valor relevante):

lstopo

Para exportar la topología a un archivo PNG:

archivo lstopo.png

Para exportar un archivo XML en una máquina y luego mostrar la salida gráfica correspondiente en
otra maquina:

machine1 $ lstopo file.xml

machine2 $ lstopo - archivo de entrada.xml

Para guardar la topología actual de la máquina en XML y luego volver a cargarla más rápido mientras aún
considerándola como la máquina actual:

$ lstopo archivo.xml
<...>
$ lstopo - archivo de entrada.xml --este sistema

Para restringir una topología XML solo a los procesadores físicos 0, 1, 4 y 5:

lstopo --archivo de entrada.xml --restrict 0x33 nuevoarchivo.xml

Para restringir una topología XML solo a un nodo numa cuyo índice lógico es 1:

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

Para mostrar un resumen de la topología:

lstopo -s

Para obtener más detalles sobre la topología:

lstopo -v

Para mostrar solo núcleos:

lstopo: solo núcleo

Para mostrar cpusets:

lstopo --cpuset

Para mostrar solo los cpusets del paquete:

lstopo --solo paquete --cpuset-solo

Simular una jerarquía falsa; este ejemplo muestra con 2 nodos NUMA de 2 unidades de procesador:

lstopo --input "n: 2 2"

Para contar el número de procesadores lógicos en el sistema

lstopo --sólo pu | wc -l

Para agregar la versión del kernel y la versión a la leyenda gráfica:

lstopo --append-legend "Lanzamiento del kernel: $ (uname -r)" --append-legend "Versión del kernel:
$ (uname -v) "

Use lstopo en línea usando los servicios de onworks.net