НАЗВАНИЕ

lspci - выводит список всех устройств на шине PCI

СИНТАКСИС

lspci [опции]

ОПИСАНИЕ

Утилита lspci служит для вывода информации о всех имеющихся в системе шинах PCI и всех подключенных к ним устройствах.

Если вы собираетесь отправить отчёт об ошибках в драйвере PCI-устройства или в самом lspci, пожалуйста включите в отчёт вывод команды "lspci -vvx".

ОПЦИИ

-v

Предписывает lspci быть многословной и выводить подробную информацию о всех устройствах.

-vv

Указывает lspci быть очень многословной и показывать ещё больше информации (фактически всё, что PCI-устройство способно выдать). В этой странице руководства, точный смысл этих данных не разъясняется, если вы хотите узнать больше, посмотрите /usr/include/linux/pci.h или спецификации PCI.

-n

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

-x

Показать шестнадцатеричный дамп первых 64 байт конфигурационного пространства PCI (стандартный заголовок). Полезно для отладки драйверов и самой lspci.

-xxx

Показать шестнадцатеричный дамп всего конфигурационного пространства PCI. Опция доступна только суперпользователю, поскольку некоторые устройства PCI могут вызвать сбой, когда вы попытаетесь прочитать неопределённые части конфигурационного пространства (такое поведение возможно и не нарушает стандарта PCI, хотя это по меньше мере несуразно).

-b

Магистральный вид. Показать все номера IRQ и адреса, так как их увидели устройства на шине, вместо увиденного ядром.

-t

Отобразить древовидную схему, содержащую все шины, мосты, устройства и соединения между ними.

-s [[<шина>]:][<слот>][.[<функция>]]

Показывать устройства только конкретной шины, слота и функции. Можно опустить каждый из компонентов адреса устройства или заменить на "*", что означает "любое допустимое значение". Все числа шестнадцатеричные. Таким образом, "0:" отберёт все устройства на шине 0; "0" выделит все функции устройства 0 на любой шине; "0.3" выберет третью функцию устройства 0 на всех шинах; и ".4" покажет только четвёртую функцию каждого из устройств.

-d [<поставщик>]:[<устройство>]

Показывать абонентов шины с идентификаторами только определённого поставщика и устройства. Оба идентификатора задаются в шестнадцатеричном виде, и могут быть опущены или заменены на "*", что подразумевает "любое допустимое значение".

-i <файл>

Использовать <файл>, как базу данных идентификаторов PCI, взамен /usr/share/pci.ids.

-p <каталог>

Использовать <каталог>, как каталог содержащий информацию шины PCI, вместо /proc/bus/pci.

-m

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

-M

Активировать режим отображения шины, который тщательно сканирует шину для нахождения всех устройств, включая те, что скрыты за неправильно сконфигурированными мостами и т.п. Пожалуйста, обратите внимание, что это предназначено только для отладки и поскольку может привести к краху системы (только в случае наличия сбойных устройств, но к сожалению такое встречается), данная опция доступна только суперпользователю. К тому же не имеет смысла использование -M при методах доступа к PCI, которые непосредственно не связываются с аппаратными средствами, т.к. результаты будут (за исключением ошибок в lspci) идентичны выводу команды в нормальных режимах.

--version

Отобразить версию lspci. Эта опция должна применяться отдельно от других.

ОПЦИИ PCILIB

Для общения с PCI-картами, утилиты PCI используют PCILIB (переносимая библиотека предоставляющая платформонезависимые функции для доступа к пространству конфигурации PCI). Следующие опции позволяют контролировать параметры библиотеки, в особенности применяемый метод доступа. По умолчанию, PCILIB использует первый доступный метод и не показывает отладочные сообщения. Каждый переключатель сопровождается списком поддерживаемого аппаратного/программного обеспечения.

-P <каталог>

Принудительный доступ к конфигурации в стиле Linux /proc/bus/pci, используя <каталог> вместо /proc/bus/pci. (Только для Linux 2.1 или выше.)

-H1

Использовать прямой доступ к аппаратному обеспечению посредством механизма конфигурации Intel 1. (Только для i386 и совместимых.)

-H2

Использовать прямой доступ к аппаратному обеспечению через механизм конфигурации Intel 2. Предупреждение: этот метод может адресовать только первые 16 устройств на любой шине и во многих случаях выглядит очень ненадёжным. (Только для i386 и совместимых.)

-S

Использовать системные вызовы доступа к PCI. (Только для Linux на Alpha и UltraSparc.)

-F <файл>

Извлечь всю информацию из заданного файла, содержащего вывод команды lspci -x. Это очень полезно для анализа отчётов об ошибках предоставленных пользователями, так как не беспокоя пользователя запросами о дополнительных дампах, вы можете отобразить аппаратную конфигурацию любым желаемым способом. (Для всех систем.)

-G

Повысить уровень отладки библиотеки. (Для всех систем.)

ФАЙЛЫ

/usr/share/pci.ids

Список всех известных идентификаторов PCI (поставщики, устройства, классы и подклассы).

/proc/bus/pci

Интерфейс к конфигурационному пространству PCI, предоставляемый пост-2.1.82 ядрами Linux. Содержит подкаталоги для каждой шины с файлами пространств конфигурации и файлом устройств, содержащим список всех PCI-устройств.

СМ. ТАКЖЕ

setpci(8),update-pciids(8)

АВТОР

Утилиты PCI в Linux сопровождаются Мартином Маресом (Martin Mares) <mj@ucw.cz>.

ПЕРЕВОД

Василий Коломеец (Vasily Kolomeets) <boojuman@gmail.com>