lstopo - Интернет в облаке

ПРОГРАММА:

ИМЯ

lstopo, lstopo-no-graphics, hwloc-ls - Показать топологию системы

СИНТАКСИС

лстопо [ кредита ] ... [ имя файла ]

лстопо-без-графики [ кредита ] ... [ имя файла ]

hwloc-ls [ кредита ] ... [ имя файла ]

Обратите внимание, что Халлок(7) дает подробное объяснение системы hwloc; это следует прочитать
перед прочтением этой страницы руководства

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--из , --Формат вывода
Обеспечить вывод в заданном формате. См. Раздел «ФОРМАТЫ ВЫВОДА» ниже.

-i , --Вход
Чтение топологии из XML-файла (вместо того, чтобы обнаруживать топологию на
локальная машина). Если стоит «-», используется стандартный ввод. Поддержка XML должна
были скомпилированы в hwloc для использования этой опции.

-i , --Вход
Считать топологию из корневого каталога, указанного (вместо того, чтобы открывать
топология на локальной машине). Эта опция обычно доступна только в Linux.
Обычно chroot создавался путем сбора топологии другой машины с помощью hwloc-
сборка-топология.

-i , --Вход
Смоделировать поддельную иерархию (вместо того, чтобы обнаруживать топологию на локальном
машина). Если "node: 2 pu: 3", топология будет содержать два NUMA
узлы с 3-мя процессорами в каждом из них. В строка должна заканчиваться
с рядом ПУ.

--если , - входной формат
Принудительно вводить данные в заданном формате, среди XML, фсрут и синтетический.

--export-синтетические-флаги
Применять флаги при экспорте в синтетический формат. Эти флаги передаются
hwloc_topology_export_synthetic (). Значение 2 возвращается к формату hwloc
v1.9. Значение 3 возвращается к исходному минималистичному формату (до версии 1.9).

-v --подробный
Включите дополнительную информацию. Инструмент hwloc-info может использоваться для отображения еще большего количества
информация о конкретных объектах.

-s --тихий
Уменьшите количество отображаемых деталей.

-f --сила
Если целевой файл уже существует, перезапишите его.

-l --логичный
Отображать логические индексы hwloc вместо физических индексов / индексов ОС (по умолчанию для консоли
выход). Эти индексы имеют префикс «L #». Физические показатели некоторых
объекты (PU и Node по умолчанию, все объекты, если подробные) будут отображаться как объект
атрибут «П # ...».

-p --физические
Отображать индексы OS / физических вместо логических индексов hwloc (по умолчанию для графических
выход). Эти индексы имеют префикс "P #" вместо "L #" в консоли.
вывод.

-c --cpuset
Отобразите процессор каждого объекта.

-C --cpuset-только
Отображать только набор процессоров каждого объекта; не отображать ничего другого о
объект.

--taskset
Показать строки набора ЦП в формате, распознаваемом программой командной строки набора задач
вместо специфичного для hwloc строкового формата набора ЦП. Этот вариант следует комбинировать
--cpuset or --cpuset-только, иначе это будет означать --cpuset.

--Только
Показывать в текстовом выводе только объекты данного типа.

- игнорировать
Игнорировать все объекты типа в топологии. hwloc поддерживает игнорирование любых
типа кроме ПУ и устройств ввода / вывода. Однако lstopo по-прежнему предлагает игнорировать PU путем скрытия
Объекты PU в графическом и текстовом выводах. Учтите, что ПУ нельзя игнорировать.
в выводе XML. Также обратите внимание, что тип объекта верхнего уровня нельзя игнорировать.
(обычно Machine или System).

--без кешей
Не показывать кеши.

--no-бесполезные кеши
Не показывать кеши, которые не имеют иерархического влияния. Это призывает
hwloc_topology_ignore_type_keep_structure () для объектов кеша.

- no-icaches
Не показывать кеши инструкций, отображаются только кеши данных и унифицированные кеши.

--целая система
Не считайте административные ограничения.

- объединить
Не показывать уровни, не влияющие на иерархию. Это призывает
hwloc_topology_ignore_all_keep_structure ().

- без обвала
Не сворачивайте идентичные устройства PCI. По умолчанию идентичные одноуровневые устройства PCI
(например, многие виртуальные функции внутри одного физического устройства) свернуты.

--ограничивать
Ограничьте топологию заданным процессором.

--ограничивать переплет
Ограничьте топологию привязкой текущего процесса. Этот вариант требует использования
фактической текущей топологии машины (или любой другой топологии с --эта система or
с HWLOC_THISSYSTEM, установленным в 1 в среде).

--restrict-флаги
Применять флаги при ограничении топологии. По умолчанию 0. Эти флаги
перешел к hwloc_topology_restrict ().

--нет-ио
Не показывать устройства ввода-вывода или мосты. По умолчанию обычные устройства (графические процессоры, сетевые адаптеры,
блочные устройства, ...) и интересные мосты.

--без мостов
Не показывать мосты ввода-вывода, кроме мостов хоста. По умолчанию обычные устройства (графические процессоры,
Сетевые карты, блочные устройства, ...) и интересные мосты.

--целое-ио
Показать все устройства ввода-вывода и мосты. По умолчанию только обычные устройства (графические процессоры, сетевые адаптеры,
блочные устройства, ...) и интересные мосты.

--эта система
Предположим, что выбранный бэкэнд предоставляет топологию для системы, в которой мы
бегут. Это полезно при использовании --ограничивать привязка и загрузка кастомной
топология, такая как файл XML.

--пид
Обнаружение топологии с точки зрения процесса , т.е. как бы процесс сделал
само открытие. Обратите внимание, что это может, например, изменить набор разрешенных
процессоры. Также покажите текущую привязку ЦП этого процесса, отметив
соответствующие PU (зеленым цветом в графическом выводе, см. раздел ЦВЕТА ниже,
или добавив (привязка) к подробному текстовому выводу). Если 0 задан как pid,
Будет показана текущая привязка для процесса lstopo.

--пс --Топ
Показывать существующие процессы как разные объекты на выходе. Чтобы избежать без толку
загромождая вывод, только процессы, которые ограничены некоторой частью
машины показаны. В Linux потоки ядра не отображаются. Если много процессов
В любом случае вывод может стать трудночитаемым, что делает программу hwloc-ps более сложной.
практично.

--размер шрифта
Установите размер шрифта текста.

--размер сетки
Установите размер поля между элементами.

--гориз, --гориззнак равно
Горизонтальный графический макет вместо соотношения почти 4/3. Если список, разделенный запятыми
типов, макет применяется только к соответствующим контейнерам.

--верт, --вертзнак равно
Вертикальная графическая раскладка вместо соотношения почти 4/3. Если список, разделенный запятыми
типов, макет применяется только к соответствующим контейнерам.

- правильно, - правильнознак равно
Прямоугольный графический макет с соотношением почти 4/3, в том числе при размещении NUMA
узлы. Если указан список типов, разделенных запятыми, макет применяется только к
соответствующие контейнеры.

- нет легенды
Удалите текстовую легенду внизу.

--append-легенда
Добавьте строку текста в конец легенды в графическом режиме. Если линия
слишком длинный, на выходе он будет обрезан. При добавлении нескольких строк каждая
строку следует указывать отдельно, передав эту опцию несколько раз.

--версия
Сообщить о версии и выйти.

ОПИСАНИЕ

lstopo и lstopo-no-graphics могут отображать топологическую карту системы в
множество различных форматов вывода. Единственная разница между lstopo и lstopo-no-
графика заключается в том, что графические выходные данные поддерживаются только lstopo, чтобы уменьшить зависимость от
внешние библиотеки. hwloc-ls идентичен lstopo-no-graphics.

Указанное имя файла напрямую подразумевает используемый выходной формат; увидеть
ФОРМАТЫ ВЫВОДА ниже. Форматы вывода, поддерживающие цвет, будут указывать на конкретные
характеристики отдельных ЦП по цвету; см. раздел ЦВЕТА ниже.

ВЫВОД ФОРМАТЫ

По умолчанию, если имя выходного файла не указано, выходные данные отправляются в графическое окно, если
возможно в текущей среде (переменная среды DISPLAY установлена ​​в Unix и т. д.).
В противном случае в консоли отображается текстовая сводка.

Имя файла в командной строке обычно определяет формат вывода. Есть
несколько имен файлов, которые указывают на определенные форматы вывода и устройства (например, имя файла "-"
выводит текстовое резюме на стандартный вывод), но большинство имен файлов указывают на желаемый результат
формат по их суффиксу (например, "topo.png" loading = "lazy" выведет файл в формате PNG).

Формат вывода также можно изменить с помощью «--of». Например, "--of pdf" будет
генерировать файл в формате PDF на стандартном выходе, а "--of fig toto" будет выводить
Файл в формате Xfig с именем "toto".

Список поддерживаемых в настоящее время форматов приведен ниже. Любой из них можно использовать с
"--of" или как суффикс имени файла.

по умолчанию
Отправьте вывод в окно или на консоль в зависимости от среды.

консоль
Отправить текстовую сводку на стандартный вывод. Связывающие, запрещенные или автономные процессоры доступны только
аннотируется в этом режиме, если он подробный; см. раздел ЦВЕТА ниже.

ASCII Выведите графическое представление карты в формате ASCII (ранее называлось текст). Если вывод
в стандартный вывод, и если на терминале поддерживаются цвета, вывод будет
раскрашенный.

инжир Выведите представление карты, которую можно загрузить в Xfig.

PDF Если lstopo был скомпилирован с надлежащей поддержкой, lstopo выводит представление PDF
карты.

ps Если lstopo был скомпилирован с надлежащей поддержкой, lstopo выводит Postscript
представление карты.

PNG Если lstopo был скомпилирован с надлежащей поддержкой, lstopo выводит представление PNG.
карты.

SVG Если lstopo был скомпилирован с надлежащей поддержкой, lstopo выводит SVG
представление карты.

синтетический
Если топология симметрична (что требует, чтобы у корневого объекта был
набор полей symric_subtree), lstopo выводит синтетическую строку описания. Этот
выходные данные могут быть повторно использованы в качестве входного описания синтетической топологии позже. Обратите внимание, что
Устройства ввода-вывода часто вызывают асимметрию топологии. Добавление --no-io может быть полезно, когда
синтетический экспорт терпит неудачу. См. Также раздел «Синтетические топологии» в
документация.

XML Если lstopo был скомпилирован с надлежащей поддержкой, lstopo выводит XML
представление карты. Его можно будет повторно использовать позже, даже на другом компьютере, с
lstopo --input, переменная среды HWLOC_XMLFILE или
функция hwloc_topology_set_xml ().

Могут использоваться следующие специальные имена:

- Отправить текстовую сводку на стандартный вывод.

/ dev / stdout
Отправить текстовую сводку на стандартный вывод. Фактически это то же самое, что и указание «-».

-.
Если полное имя файла - "-. ", lstopo ведет себя так, как если бы" --of -" было
задано, что означает, что файл заданного формата отправляется на стандартный вывод.

См. Вывод "lstopo --help" для получения конкретного списка форматов графического вывода.
поддерживается в вашей установке hwloc.

ЦВЕТЫ

Отдельные процессоры окрашены в графические выходные форматы для обозначения различных
характеристики:

Зеленый Топология отображается так, как ее видит конкретный процесс (см. --пид), а данный
ЦП находится в этой маске привязки ЦП.

Белый ЦП находится в разрешенном наборе (см. Ниже). Если топология сообщается так, как ее видит
конкретный процесс (см. --пид), данный ЦП также не входит в ЦП этого процесса.
обязательная маска.

Красный ЦП не входит в разрешенный набор (см. Ниже).

Черный ЦП отключен (не все ОС поддерживают отображение автономных ЦП).

«Разрешенный набор» - это набор процессоров, к которым разрешено связываться текущему процессу. В
разрешенный набор обычно либо наследуется от родительского процесса, либо устанавливается административным
qpolicies в системе. Процессоры Linux являются одним из примеров ограничения разрешенного набора для
процесс и его дочерние элементы должны быть меньше, чем полный набор процессоров в системе.

Следовательно, разные процессы могут иметь разные ЦП в разрешенном наборе. Следовательно, вызывая
lstopo в разных контекстах и ​​/ или поскольку разные пользователи могут отображать разные цвета для
одни и те же отдельные процессоры (например, запуск lstopo в одном контексте может отображать конкретный процессор как
красный, но запуск lstopo в другом контексте может отображать тот же процессор как белый).

Некоторые режимы вывода lstopo, например режим консоли (неграфический вывод по умолчанию), не
поддерживать цвета вообще. В режиме консоли указанные выше характеристики отображаются путем добавления
текст в каждую строку PU, если включены подробные сообщения.

CUSTOM ЦВЕТЫ

Цвет каждого объекта в графическом выводе можно принудительно установить, указав
Атрибут информации "lstopoStyle" в этом объекте. Его значение должно быть разделено точкой с запятой.
Список " = # rrggbb ", где rr, gg и bb - компоненты цвета RGB, каждый
от 0 до 255 в шестнадцатеричном формате (от 00 до ff). может быть

проверка данных
Устанавливает цвет фона основного блока объекта.

Background2
Устанавливает цвет фона дополнительного поля для объекта, например
блок памяти внутри блока узла NUMA.

Текст Устанавливает цвет текста, отображающего имя объекта, тип, индекс и т. Д.

Текст 2 Устанавливает цвет дополнительного текста рядом с объектом, например скорость ссылки
за мостом PCI.

Информация "lstopoStyle" может быть добавлена ​​к временно сохраненным XML-топологиям с помощью hwloc-
аннотировать или с помощью hwloc_obj_add_info (). Например, чтобы отобразить все основные объекты синим цветом
(с белыми именами):

лстопо сохранить.xml
hwloc-annotate save.xml save.xml core: вся информация lstopoStyle
«Фон = # 0000ff; Текст = # ffffff»
lstopo -я сохранить.xml

Палубы Prestige XXNUMX

В графическом выводе lstopo использует простую прямоугольную эвристику, чтобы попытаться достичь 4/3
соотношение ширины и высоты. Однако в частном случае узлов NUMA макет
всегда представляет собой плоский прямоугольник, чтобы пользователь не мог поверить в какую-либо конкретную топологию NUMA.
(lstopo пока не может это отобразить). Расположение уровня можно изменить с помощью
--vert, --horiz и --rect.

ПРИМЕРЫ

Чтобы отобразить топологию машины в текстовом режиме:

лстопо-без-графики

Чтобы отобразить топологию машины в режиме ascii-art:

lstopo-no-graphics -.ascii

Для отображения в графическом режиме (при условии, что для переменной среды DISPLAY установлено значение
соответствующее значение):

лстопо

Чтобы экспортировать топологию в файл PNG:

Файл lstop.png

Чтобы экспортировать XML-файл на компьютер и позже отобразить соответствующий графический вывод на
другая машина:

machine1 $ lstopo file.xml

machine2 $ lstopo --input file.xml

Чтобы сохранить текущую топологию машины в XML и позже перезагрузить ее быстрее, пока
рассматривая его как текущую машину:

$ файл lstopo.xml
<...>
$ lstopo --входной файл.xml --thissystem

Чтобы ограничить топологию XML только физическими процессорами 0, 1, 4 и 5:

lstopo --входной файл.xml --restrict 0x33 новый файл.xml

Чтобы ограничить топологию XML только узлом numa, логический индекс которого равен 1:

lstopo --input file.xml --restrict $ (hwloc-calc --input file.xml узел: 1) newfile.xml

Чтобы отобразить сводку топологии:

лстопо -с

Чтобы получить более подробную информацию о топологии:

лстопо -v

Чтобы показать только ядра:

lstopo - только ядро

Чтобы показать процессоры:

lstop --cpuset

Чтобы показать только процессоры пакета:

lstopo --only пакет --cpuset-only

Смоделировать фальшивую иерархию; этот пример показывает с 2 узлами NUMA из 2 процессорных блоков:

lstopo --input "n: 2 2"

Для подсчета количества логических процессоров в системе

lstopo --only pu | туалет -l

Чтобы добавить выпуск и версию ядра к графической легенде:

lstopo --append-legend "Версия ядра: $ (uname -r)" --append-legend "Версия ядра:
$ (uname -v) "

Используйте lstopo в Интернете с помощью сервисов onworks.net