Руководства по командной строке

Man » discover Manual online — подробная онлайн-документация для страницы руководства discover

🌍
discover — утилита для обнаружения оборудования

КРАТКОЕ ОПИСАНИЕ

discover [ОПЦИИ_ДЛЯ_ДАННЫХ] [ОПЦИИ_ОТОБРАЖЕНИЯ] [--bus-summary] [шина ...]

discover [ОПЦИИ_ДЛЯ_ДАННЫХ] [ОПЦИИ_ОТОБРАЖЕНИЯ] --type-summary [тип ...]

discover [ОПЦИИ_ДЛЯ_ДАННЫХ] --data-path=путь/к/данным ... [--data-version=версия] [--normalizewhitespace] [--format=строка_формата] [тип | идентификатор ...]

ОПЦИИ_ДЛЯ_ДАННЫХ

-d | --disable-bus=шина

-e | --enable-bus=шина

--insert-url=url

--append-url=url

-v | --verbose

ОПЦИИ_ОТОБРАЖЕНИЯ

--model | --no-model

--model-id | --no-model-id

--vendor | --no-vendor

--vendor-id | --no-vendor-id

ОПИСАНИЕ

discover предоставляет расширяемый интерфейс для обнаружения и отчета об оборудовании. Информация об оборудовании
хранится в XML-формате данных и может быть получена по сети.

Основные режимы работы:

Отображение списка устройств оборудования на основе типа устройства или системной шины, к которой принадлежат устройства, с помощью --type-summary или --bus-summary (последнее является режимом по умолчанию).

Запрос конкретных данных для подключенного оборудования с помощью --data-path.

ОПЦИИ

-h | --help

Отображение простого сообщения справки.

-v | --verbose

Инструкция для утилиты предоставлять обратную связь во время ее работы. Это повлияет на выходные данные, поскольку discover анализирует определенные аргументы, поэтому это должно происходить в начале командной строки.

-V | --version

Отображение имени и версии утилиты.

-b | --bus-summary

Это поведение по умолчанию: отображение базовой информации обо всех устройствах на соответствующих шинах. См. "Выбор шин" >.

-t | --type-summary

Сводная информация об устройствах по классу оборудования. Примеры допустимых типов устройств включают broadband, fixeddisk, display и network. См. "Типы устройств" >.

--data-path=путь/к/данным

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

Как правило, компонент верхнего уровня пути данных будет представлять собой «платформу», которой потребуются данные, например, linux или xfree86. Например, чтобы получить имя модуля ядра Linux для определенного оборудования, аргумент --data-path будет иметь вид linux/module/name.

Если указано несколько аргументов --data-path и не указана строка формата (см. --format), используется только последний путь.

См. также аргумент --data-version.

--data-version=версия

Укажите строку версии для платформы, которая будет использовать информацию, указанную в аргументе --data-path.

Эта строка должна быть в десятичном формате, чтобы ее можно было сопоставить с диапазоном значений, и, следовательно, может быть короче реальной версии.


--format=format string

Определяет формат вывода результатов запросов, указанных в аргументах --data-path. Эта строка формата должна соответствовать спецификации printf(3), хотя поддерживаются только %s и соответствующие флаги, точность и значения ширины (или имеют смысл); также можно использовать обычный текст и %% . Поведение при неправильном форматировании строки не определено. См. также --normalize-whitespace.

-d | --disable-bus=bus

Используйте эту опцию, чтобы переопределить список шин, которые необходимо сканировать по умолчанию, как определено в discover.conf. Используйте all в качестве аргумента, чтобы отключить все шины; это полезно только в том случае, если за этим следуют аргументы --enable-bus (или -e).

-e | --enable-bus=bus

Укажите шину, которую нужно сканировать.

--insert-url=url

Вставьте URL-адрес в начало списка сетевых ресурсов, которые нужно включить в поиск информации об оборудовании. Более ранние данные переопределяют более поздние данные; чтобы переопределить локальные источники данных, вставьте URL-адреса в список. См. также --append-url.

--append-url=url

Добавьте URL-адрес в конец списка сетевых ресурсов, которые нужно искать для получения информации об оборудовании. См. также --insert-url.

--model   Включите описание модели в сводную информацию. По умолчанию это включено.

--model-id

Включите числовой идентификатор модели в сводную информацию.

--no-model

Не включайте описание модели в сводную информацию.

--no-model-id

Не включайте числовой идентификатор модели в сводную информацию. Это значение по умолчанию.

--vendor  Включите описание производителя в сводную информацию. По умолчанию это включено.

--vendor-id

Включите числовой идентификатор производителя в сводную информацию.

--no-vendor

Не включайте описание производителя в сводную информацию.

--no-vendor-id

Не включайте числовой идентификатор производителя в сводную информацию. Это значение по умолчанию.

--normalize-whitespace

Объедините пробелы в результатах запроса --data-path. По умолчанию этого не делается, что точно воспроизводит весь текст в необработанных данных XML.

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

Выбор шин

Файл discover.conf определяет два списка системных шин: один для сканирования по умолчанию (используется командой discover) и один, который никогда не следует сканировать (используется библиотекой Discover).

Вы можете переопределить и/или расширить список шин по умолчанию с помощью --disable-bus и --enable-bus. Список шин, которые не следует сканировать, нельзя переопределить без изменения discover.conf, поэтому этот список следует использовать только для шин, которые могут быть опасны для зондирования.

Оба аргумента принимают строку "all" в качестве значения.

Если выполняется сводка шин, что указывается либо наличием --bus-summary, либо отсутствием --type-summary и --data-path, любые необъявленные аргументы в командной строке будут интерпретироваться как единственные шины, которые нужно сканировать. Это эквивалентно использованию --disable-bus all перед вызовом --enable-bus для интересующих шин.


В настоящее время Discover поддерживает следующие шины:

ata

pci

pcmcia

scsi

usb

Типы устройств

Discover определяет собственные типы устройств, на которые отображаются типы устройств, используемые каждой шиной. В настоящее время Discover распознает следующие типы устройств:

audio

Устройство, способное воспроизводить аналоговый или цифровой звуковой сигнал, является аудиоустройством.
Обычно любое устройство, обычно называемое «звуковой картой», классифицируется Discover как аудиоустройство.

bridge

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

broadband

Интерфейсное устройство для подключения к компьютерной сети, реализованное на основе технологии, явно не предназначенной для этого, является широкополосным устройством.
Примеры включают в себя адаптеры ISDN, а также DSL и кабельные «модемы»; аналоговые телефонные модемы не включены в эту классификацию (см. «модем» ниже).

display

Устройство, управляемое процессором хост-машины и способное выдавать аналоговый или цифровой видеосигнал для вывода, является устройством отображения.
Обычно любое устройство, обычно называемое «видеокартой», классифицируется Discover как устройство отображения.

fixeddisk

Высокоскоростное, фиксированное магнитное запоминающее устройство, такое как жесткий диск, является устройством fixeddisk.
Сменные носители, такие как дисководы, CD-ROM, магнитооптические устройства, ленточные накопители и устройства чтения карт Compact Flash, не включены в эту классификацию.

humaninput

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

imaging

Устройство, которое захватывает неподвижные изображения для ввода, является устройством imaging.
Примеры включают сканеры и цифровые камеры. Устройства захвата движения, такие как телевизионные тюнеры, веб-камеры и цифровые видеокамеры, не включены в эту классификацию.

miscellaneous

Любое устройство, которое не может быть логически классифицировано как другой тип устройства, является устройством miscellaneous.

modem

Аналоговый телефонный модем-демодулятор классифицируется Discover как модемное устройство.
Никакие другие типы устройств не классифицируются таким образом.

network

Интерфейсное устройство для подключения к обычной компьютерной сети, не требующее использования адаптера, является сетевым устройством.
Например, сетевые карты Ethernet и Token Ring являются сетевыми устройствами. Аналоговые телефонные модемы; адаптеры для технологий, таких как ISDN и DSL; и «кабельные модемы» не являются «сетевыми» устройствами.

optical

Устройство хранения, использующее оптические технологии, часто с использованием носителей, предназначенных только для чтения, является оптическим устройством. Наиболее распространенные примеры таких устройств — CD-ROM и DVD-ROM, включая версии этих устройств, которые могут «записывать» (записывать данные) на оптические диски.

printer

Устройство, которое создает визуальный вывод в постоянной или полупостоянной форме на физическом носителе, является принтером. Как правило, любое устройство, которое в обиходе называют «принтером», также классифицируется Discover как принтер.

removabledisk

Устройства хранения, которые используют сменные носители с использованием практически любой технологии, за исключением магнитной ленты, CD-ROM и DVD-ROM, являются устройствами removabledisk. Примеры включают дисководы, использующие гибкие диски, магнитооптические дисководы и устройства для чтения карт Compact Flash.

tape

Последовательное устройство массового хранения, использующее магнитную ленту, является ленточным устройством. Обычно используется для архивирования и резервного копирования; DAT-дисководы являются примерами ленточных устройств.

video

Устройство, которое создает цифровой видеосигнал в реальном времени для целей ввода, является видеоустройством. Веб-камеры, цифровые видеокамеры и телевизионные тюнеры являются примерами видеоустройств. Обратите внимание, что цифровые фотоаппараты со съемкой «видео» не считаются видеоустройствами, если они не могут передавать видеосигнал в реальном времени на хост-компьютер.

Примеры

Сканирование локальных шин

# discover
Intel Corporation 82815 Chipset Host Bridge and Memory Controller Hub
unknown unknown
unknown unknown
unknown unknown
Intel Corporation 82815 Chipset IDE controller
Intel Corporation 82815 Chipset USB (A)
Intel Corporation 82815 System Management bus controller
ATI Technologies, Inc. Rage 128 Pro GL [PF]
3om Corporation 3c905C-TX [Fast Etherlink]
Ensoniq ES1371 [AudioPCI-97]
unknown unknown

Просмотр видеокарт PCI

# discover -v --type-summary --disable-bus all --enable-bus pci display
Disabled pci
Disabled pcmcia
Disabled scsi
Disabled usb
Enabled pci
Loading XML data... pci Done
Scanning buses... pci Done
ATI Technologies, Inc. Rage 128 Pro GL [PF]

Запрос информации о модуле драйвера для XFree86 версии 4.2.0

# discover --data-path=xfree86/server/device/driver --data-version=4.2.0 display
ati

Получение информации о модели и производителе по типу

$ discover -t --no-model
Intel Corporation
NVIDIA Corporation
3om Corporation
$ discover -t --no-vendor
82815System Management bus controller
Vanta [NV6]
3905C-TX [Fast Etherlink]

Файлы

/etc/discover.conf.d

Каталог, содержащий файлы конфигурации, которые управляют поведением по умолчанию как для утилиты discover, так и для библиотеки Discover.

file:///lib/discover/list.xml

XML-файл, содержащий URL-адреса с информацией об оборудовании. Этот список можно расширить с помощью опций --append-url и --extend-url.

Авторы

Джош Брессерс, Джон Р. Дейли и Г. Бранден Робинсон разработали текущую реализацию Discover для Progeny Linux Systems.


Реализация системно-зависимых интерфейсов в Linux основана на detect от MandrakeSoft SA.

См. также

discover.conf(5), discover-modprobe(8)