Handbücher für die Kommandozeile

Man » discover-Handbuch online - detaillierte Online-Dokumentation für die discover-Manpage

🌍
discover — Hardware-Erkennungsdienstprogramm

SYNOPSIS

discover [DATEN_OPTIONEN] [ANZEIGE_OPTIONEN] [--bus-summary] [bus ...]

discover [DATEN_OPTIONEN] [ANZEIGE_OPTIONEN] --type-summary [type ...]

discover [DATEN_OPTIONEN] --data-path=pfad/zu/daten ... [--data-version=version] [--normalizewhitespace] [--format=format-string] [type | id ...]

DATEN_OPTIONEN

-d | --disable-bus=bus

-e | --enable-bus=bus

--insert-url=url

--append-url=url

-v | --verbose

ANZEIGE_OPTIONEN

--model | --no-model

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

--vendor | --no-vendor

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

Beschreibung

discover bietet eine erweiterbare Hardware-Erkennungs- und Berichtsschnittstelle. Hardware-
Informationen werden in einem XML-Datenformat gespeichert und können über das Netzwerk abgerufen werden.

Grundlegende Betriebsarten:

Anzeigen einer Liste von Hardwaregeräten basierend auf dem Gerätetyp oder dem Systembus, auf dem sich die Geräte befinden, über --type-summary oder --bus-summary (letzteres ist das Standardverhalten).

Abrufen angegebener Daten für angeschlossene Hardware über --data-path.

Optionen

-h | --help

Anzeigen einer einfachen Hilfemeldung.

-v | --verbose

Weisen Sie das Tool an, während des Betriebs Feedback zu geben. Dies wirkt sich auf die Ausgabe aus, wenn discover bestimmte Argumente analysiert, daher sollte dies früh in der Befehlszeile stehen.

-V | --version

Anzeigen des Tool-Namens und der Version.

-b | --bus-summary

Dies ist das Standardverhalten: Zeigen Sie grundlegende Informationen zu allen Geräten auf den entsprechenden Bussen an. Siehe "Auswählen von Bussen" >.

-t | --type-summary

Fassen Sie Geräte nach Hardwareklasse zusammen. Beispiele für gültige Gerätetypen sind Broadband, Fixeddisk, Display und Netzwerk. Siehe "Gerätetypen" >.

--data-path=pfad/zu/daten

Abrufen detaillierter Informationen für übereinstimmende Geräte. Geräte-spezifische Daten werden in einer hierarchischen Weise gespeichert, und das Abfrageargument besteht aus Zeichenketten, die jede Ebene in dieser Hierarchie benennen.

In der Regel ist die oberste Komponente des Datenpfads das "Platform", das die Informationen benötigt, z. B. Linux oder XFree86. Um beispielsweise den Linux-Kernel-Modulnamen für ein Hardware-Gerät abzurufen, wäre das Argument --data-path "linux/module/name".

Wenn mehrere --data-path-Argumente angegeben werden und kein Format-String (siehe --format) angegeben wird, wird nur der letzte Pfad verwendet.

Siehe auch das Argument --data-version.

--data-version=version

Geben Sie eine Versionszeichenkette für die Plattform an, die die durch das Argument für --data-path angegebenen Informationen verwendet.

Diese Zeichenkette muss in der Form von "punkt-dezimaler" Notation vorliegen, um mit einer Reihe von Werten übereinzustimmen, und kann daher kürzer sein als die tatsächliche Version.


--format=format string
Bestimmt die Ausgabe der Ergebnisse der durch die Argumente --data-path angegebenen Abfragen. Diese Formatzeichenfolge sollte den Spezifikationen von [printf]({filename}../../printf)(3) folgen, obwohl nur %s und geeignete Flags, Präzisions- und Breitenwerte unterstützt werden (oder sinnvoll sind); Literaltext und %% können ebenfalls verwendet werden. Das Verhalten, wenn die Zeichenfolge schlecht formatiert ist, ist undefiniert. Siehe auch --normalize-whitespace.

-d | --disable-bus=bus
Verwenden Sie diese Option, um die standardmäßig in discover.conf definierte Liste der zu scannenden Busse zu überschreiben. Verwenden Sie "all" als Argument, um alle Busse zu deaktivieren; dies ist nur dann nützlich, wenn es von --enable-bus (oder -e)-Argumenten gefolgt wird.

-e | --enable-bus=bus
Geben Sie einen zu scannenden Bus an.

--insert-url=url
Fügen Sie eine URL am Anfang der Liste der Netzwerkressourcen ein, die in der Suche nach Hardwareinformationen enthalten sind. Frühere Daten überschreiben spätere Daten; um die lokalen Datenquellen zu überschreiben, fügen Sie URLs in die Liste ein. Siehe auch --append-url.

--append-url=url
Fügen Sie eine URL am Ende der Liste der Netzwerkressourcen hinzu, die nach Hardwareinformationen durchsucht werden sollen. Siehe auch --insert-url.

--model
Schließen Sie die Modellbeschreibung in die Zusammenfassungsinformationen ein. Dies ist standardmäßig aktiviert.

--model-id
Schließen Sie die numerische Modell-ID in die Zusammenfassungsinformationen ein.

--no-model
Schließen Sie die Modellbeschreibung nicht in die Zusammenfassungsinformationen ein.

--no-model-id
Schließen Sie die numerische Modell-ID nicht in die Zusammenfassungsinformationen ein. Dies ist der Standard.

--vendor
Schließen Sie die Herstellerbeschreibung in die Zusammenfassungsinformationen ein. Dies ist standardmäßig aktiviert.

--vendor-id
Schließen Sie die numerische Hersteller-ID in die Zusammenfassungsinformationen ein.

--no-vendor
Schließen Sie die Herstellerbeschreibung nicht in die Zusammenfassungsinformationen ein.

--no-vendor-id
Schließen Sie die numerische Hersteller-ID nicht in die Zusammenfassungsinformationen ein. Dies ist der Standard.

--normalize-whitespace
Konsolidieren Sie Leerzeichen in den Ergebnissen einer --data-path-Abfrage. Standardmäßig werden die Leerzeichen nicht konsolidiert, wodurch der gesamte Text in den rohen XML-Daten originalgetreu wiedergegeben wird.

Mit dieser Option werden führende und nachfolgende Leerzeichen entfernt, und alle aufeinanderfolgenden internen Leerzeichen werden auf ein einzelnes Leerzeichen reduziert.

Auswahl von Bussen

discover.conf definiert zwei Listen von Systembussen: eine, die standardmäßig gescannt wird (verwendet vom Befehl discover), und eine, die niemals gescannt wird (verwendet von der Discover-Bibliothek).

Sie können die Liste der Standardbusse mit --disable-bus und --enable-bus überschreiben und/oder erweitern. Die Liste der zu ignorierenden Busse kann nicht überschrieben werden, ohne discover.conf zu ändern, sodass diese Liste nur für Busse verwendet werden sollte, deren Sondierung möglicherweise gefährlich ist.

Beide Argumente akzeptieren die Zeichenfolge "all" als Wert.

Wenn eine Buszusammenfassung durchgeführt wird, was entweder durch die Anwesenheit von --bus-summary oder durch das Fehlen von --type-summary und --data-path angezeigt wird, werden alle nicht angehängten Argumente auf der Befehlszeile als die einzigen zu scannenden Busse interpretiert. Dies entspricht der Verwendung von --disable-bus all, bevor --enable-bus für die interessierenden Busse aufgerufen wird.


Die folgenden Busse werden derzeit von Discover unterstützt:

ata

pci

pcmcia

scsi

usb

Gerätetypen

Discover definiert seine eigenen Gerätetypen, denen die von jedem Bus verwendeten Gerätetypen zugeordnet werden. Discover erkennt derzeit die folgenden Gerätetypen:

audio

Ein Gerät, das in der Lage ist, ein analoges oder digitales Audiosignal zu erzeugen, ist ein Audiogerät.
Typischerweise wird jedes Gerät, das üblicherweise als „Soundkarte“ bezeichnet wird, von Discover als Audiogerät klassifiziert.

bridge

Ein Gerät, das den Zugriff auf Geräte eines anderen Typs ermöglicht, üblicherweise auf einem anderen
Bus, ist ein Bridge-Gerät. Beispielsweise verfügen Consumer-PCI-Chipsätze oft über eine Bridge zu
ATA-Geräten (auch bekannt als IDE).

broadband

Ein Schnittstellengerät für ein Computernetzwerk, das auf einer Technologie implementiert ist, die nicht explizit dafür ausgelegt ist, ist ein Breitbandgerät. Beispiele hierfür sind ISDN-Terminaladapter sowie DSL- und Kabel-„Modems“; analoge Telefonleitungsmodems sind von dieser Klassifizierung ausgenommen (siehe „Modem“ unten).

display

Ein Gerät, das von der CPU des Host-Rechners gesteuert wird und in der Lage ist, ein analoges oder digitales Videosignal für die Ausgabe zu erzeugen, ist ein Anzeigegerät.
Typischerweise wird jedes Gerät, das üblicherweise als „Grafikkarte“ bezeichnet wird, von Discover als Anzeigegerät klassifiziert.

fixeddisk

Ein schnelles, festes magnetisches Speichergerät wie eine Festplatte ist ein Festplattengerät.
Entfernbare Medien wie Diskettenlaufwerke, CD-ROM-Laufwerke, magneto-optische Geräte, Bandlaufwerke und Compact-Flash-Kartenlesegeräte sind von dieser Klassifizierung ausgenommen.

humaninput

Ein Gerät, das taktile Eingaben von einer Person entgegennimmt, um die Aktivität eines Computers zu steuern, ist ein Eingabegerät.
Beispiele hierfür sind Tastaturen, Mäuse, Trackballs, Joysticks, Gamepads, digitale Tablets, die mit einem Stift oder Finger bedient werden, und so weiter.
Eingabegeräte, die sich auf nicht-taktile Mittel verlassen, um die Absicht einer Person zu bestimmen, wie z. B. Spracherkennungssysteme oder Kameras, sind von dieser Klassifizierung ausgenommen.

imaging

Ein Gerät, das Standbilder für die Eingabe erfasst, ist ein Bildgebungsgerät.
Scanner und Digitalkameras sind Beispiele für Bildgebungsgeräte. Bewegungsaufnahmegeräte wie Fernseh-Tuner-Karten, Webcams und Digitalkameras sind von dieser Klassifizierung ausgenommen.

miscellaneous

Jedes Gerät, das nicht logisch als ein anderer Gerätetyp klassifiziert werden kann, ist ein Sonstiges-Gerät.

modem

Ein analoges Telefonleitungsmodulator/Demodulator (Modem) wird von Discover als Modem-Gerät klassifiziert.
Kein anderes Gerät wird so klassifiziert.

network

Ein Schnittstellengerät für ein herkömmliches Computernetzwerk, das keine Verwendung eines Terminaladapters erfordert, ist ein Netzwerkgerät.
Beispielsweise sind Ethernet- und Token-Ring-Netzwerkadapter Netzwerkgeräte. Analoge Telefonleitungsmodems, Terminaladapter für Technologien wie ISDN und DSL sowie „Kabelmodems“ sind keine „Netzwerk“-Geräte.

    optisch

Ein optisches Speichergerät, das oft nicht-beschreibbare Medien verwendet, ist ein optisches Gerät. Die häufigsten Beispiele für diese Geräte sind CD-ROM- und DVD-ROM-Laufwerke, einschließlich Versionen dieser Laufwerke, die optische Discs beschreiben ("brennen") können.

    drucker

    Ein Gerät, das visuelle Ausgaben dauerhaft oder halbdauerhaft auf einem physischen Medium erzeugt, ist ein Drucker. In der Regel wird jedes Gerät, das umgangssprachlich als
    "Drucker" bezeichnet wird, auch von Discover als Drucker klassifiziert.

    entfernbareslaufwerk

Speichergeräte, die austauschbare Medien verwenden, die auf fast jeder Technologie basieren, mit Ausnahme von Magnetband, CD-ROM- und DVD-ROM-Laufwerken, sind entfernbare Laufwerke. Beispiele sind Diskettenlaufwerke, magneto-optische Laufwerke und Compact-Flash-Kartenlesegeräte.

    band

    Ein sequenziell zugreifbares Massenspeichergerät, das Magnetband verwendet, ist ein Bandlaufwerk. DAT-Laufwerke, die häufig für Archivierungs- und Backup-Zwecke verwendet werden, sind Beispiele für

Bandlaufwerke.

    video

    Ein Gerät, das ein Echtzeit-Digitalvideosignal für Eingabezwecke erzeugt, ist ein Videogerät. Webcams, digitale Videokameras und Fernseh-Tuner sind Beispiele für Videogeräte. Beachten Sie, dass

digitale Kameras mit "Video"-Funktion nicht als Videogeräte betrachtet werden, es sei denn, sie können das Live-Videosignal in Echtzeit an den Host senden.

Beispiele

Lokale Busse scannen

    # discover
    Intel Corporation 82815 Chipset Host Bridge und Memory Controller Hub
    unbekannt unbekannt
    unbekannt unbekannt
    unbekannt unbekannt
    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]
    3com Corporation 3c905C-TX [Fast Etherlink]
    Ensoniq ES1371 [AudioPCI-97]
    unbekannt unbekannt

    PCI-Videokarten anzeigen

    # discover -v --type-summary --disable-bus all --enable-bus pci display
    Pci deaktiviert
    Pcmcia deaktiviert
    Scsi deaktiviert
    Usb deaktiviert
    Pci aktiviert
    XML-Daten werden geladen... Pci Fertig
    Busse werden gescannt... Pci Fertig
    ATI Technologies, Inc. Rage 128 Pro GL [PF]

    Abfrage nach dem Treibermodul für XFree86-Server Version 4.2.0

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

    Modell- und Herstellerinformationen nach Typ abrufen

    $ discover -t --no-model
    Intel Corporation
    NVIDIA Corporation
    3com Corporation
    $ discover -t --no-vendor
    82815 System Management Bus Controller
    Vanta [NV6]
    3905C-TX [Fast Etherlink]

Dateien

    /etc/discover.conf.d

Das Verzeichnis, das Konfigurationsdateien enthält, die das Standardverhalten sowohl für das discover-Tool als auch für die Discover-Bibliothek steuern.

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

Eine XML-Datei, die URLs mit Hardwareinformationen enthält. Diese Liste kann mit --append-url und --extend-url erweitert werden.

Autoren

Josh Bressers, John R. Daily und G. Branden Robinson haben die aktuelle Implementierung von Discover für Progeny Linux Systems entwickelt.


Die Linux-Implementierung der systemspezifischen Schnittstellen basiert auf „detect“ von MandrakeSoft SA.

Siehe auch

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