コマンドラインのマニュアル

Man » discover マニュアルオンライン - discover マニュアルページの詳細なオンラインドキュメント

🌍
discover — ハードウェア検出ユーティリティ

概要

discover [データオプション] [表示オプション] [--bus-summary] [バス...]

discover [データオプション] [表示オプション] --type-summary [タイプ...]

discover [データオプション] --data-path=パス/データ ... [--data-version=バージョン] [--normalizewhitespace] [--format=フォーマット文字列] [タイプ | ID...]

データオプション

-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

ツールが動作中にフィードバックを提供するように指示します。これは出力に影響を与えるため、コマンドラインの早い段階で表示する必要があります。

-V | --version

ツールの名前とバージョンを表示します。

-b | --bus-summary

これはデフォルトの動作です。適切なバス上のすべてのデバイスに関する基本的な情報を表示します。 「バスの選択」を参照してください。

-t | --type-summary

ハードウェアのクラス別にデバイスを要約します。有効なデバイスタイプの例には、ブロードバンド、固定ディスク、ディスプレイ、ネットワークなどがあります。 「デバイスタイプ」を参照してください。

--data-path=パス/データ

詳細な情報を取得するために、一致するデバイスをクエリします。デバイス固有のデータは階層的に保存され、クエリ引数は、その階層の各レベルの名前を含む文字列で構成されます。

通常、データパスの最上位コンポーネントは、platform であり、情報が必要なプラットフォーム(例:linux または xfree86)になります。たとえば、ハードウェアの Linux カーネルモジュール名を取得するには、--data-path 引数は linux/module/name になります。

複数の --data-path 引数が指定され、フォーマット文字列(--format を参照)が提供されていない場合、最後のパスのみが使用されます。

--data-version 引も参照してください。

--data-version=バージョン

--data-path 引で指定された情報を使用するプラットフォームのバージョン文字列を指定します。

この文字列は、ドット付き 10 進表記で指定する必要があり、範囲に一致するようにするため、実際のバージョンよりも短い場合があります。


--format=format 文字列
--data-path 引数で指定されたクエリの結果の出力を指定します。
このフォーマット文字列は、[printf]({filename}../../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 は、システムのバスの 2 つのリストを定義します。1 つはデフォルトでスキャンするバスのリスト(discover コマンドで使用)、もう 1 つは決してスキャンしないバスのリスト(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

ホストマシンの CPU によって制御され、出力用にアナログまたはデジタルビデオ信号を生成できるデバイスは、ディスプレイデバイスです。通常、一般に「ビデオカード」と呼ばれるデバイスは、Discover によってディスプレイデバイスとして分類されます。

fixeddisk

高速で固定された磁気記憶装置(ハードディスクドライブなど)は、固定ディスクデバイスです。リムーバブルメディアデバイス(フロッピーディスクドライブ、CD-ROM ドライブ、磁気光学デバイス、テープドライブ、およびコンパクトフラッシュカードリーダーなど)はこの分類には含まれません。

humaninput

人間からの触覚的な入力を受け取り、コンピューターの動作を指示する目的で使用されるデバイスは、人間入力デバイスです。例としては、キーボード、マウス、トラックボール、ジョイスティック、ゲームパッド、スタイラスまたは指で操作するデジタルタブレットなどがあります。
人間の意図を触覚以外の手段で判断する入力デバイス(音声認識デバイスまたはカメラなど)はこの分類には含まれません。

imaging

入力用に静止画像をキャプチャするデバイスは、イメージングデバイスです。スキャナーとデジタルカメラは、イメージングデバイスの例です。モーションキャプチャデバイス(テレビチューナーカード、ウェブカメラ、デジタルビデオカメラなど)はこの分類には含まれません。

miscellaneous

他のデバイスタイプとして論理的に分類できないデバイスは、さまざまなデバイスです。

modem

アナログ回線モジュレーター/復調器(モデム)は、Discover によってモデムデバイスとして分類されます。
他の種類のデバイスは、この分類には含まれません。

network

従来のコンピューターデータ通信ネットワークへのインターフェイスデバイスであり、ターミナルアダプターの使用を必要としないデバイスは、ネットワークデバイスです。たとえば、イーサネットおよびトークンリングネットワークインターフェイスカードは、ネットワークデバイスです。アナログ回線モデム、ISDN や DSL などのテクノロジー用のターミナルアダプター、および「ケーブルモデム」は、「ネットワーク」デバイスではありません。

optical

光学技術ストレージデバイスで、通常は読み取り専用メディアを使用するものは、光学デバイスです。最も一般的な例としては、CD-ROMドライブとDVD-ROMドライブがあり、これらのドライブの「書き込み」バージョンも含まれます。

printer

物理メディアに永続的または半永続的な視覚的出力を作成するデバイスは、プリンターです。一般的に、口語的に「プリンター」と呼ばれるデバイスは、Discoverによってもプリンターとして分類されます。

removabledisk

磁気テープ、CD-ROM、DVD-ROMドライブ以外の技術を使用した、取り外し可能なメディアを備えたストレージデバイスは、リムーバブルディスクデバイスです。例としては、フロッピーディスクドライブ、磁気光学ドライブ、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

ハードウェア情報を含むURLを含むXMLファイル。--append-url--extend-urlを使用して、このリストを拡張できます。

著者

Josh Bressers、John R. Daily、およびG. Branden Robinsonが、Progeny Linux Systems用にDiscoverの現在の実装を開発しました。


Linux 実装におけるシステム依存インターフェースは、MandrakeSoft SA の detect から派生しています。

関連項目

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