NAME

       lspci - 列出所有PCI設備

總覽 SYNOPSIS

       lspci [options]

描述 DESCRIPTION

       lspci 是一個用來顯示系統中所有PCI總線設備或連接到該總線上的所有設備的工具。

       為了能使用這個命令所有功能，你需要有  linux 2.1.82 或以上版本，支持 /proc/bus/pci 接口的核
       心。在舊版本核心中，PCI工具必須使用只有root才能執行的直接硬體訪問，而且總是出現競爭狀況以
       及其他問題。

       如果你要報告  PCI  設備驅動中，或者是  lspci 自身的 bugs，請在報告中包含 "lspci -vvx" 的輸
       出。

選項 OPTIONS

       -v     使得 lspci 以冗餘模式顯示所有設備的詳細信息。

       -vv    使得 lspci 以過冗餘模式顯示更詳細的信息 (事實上是 PCI 設備能給出的所有東西)。這些數
              據的確切意義沒有在此手冊頁中解釋，如果你想知道更多，請參照 /usr/include/linux/pci.h
              或者 PCI 規範。

       -n     以數字形式顯示 PCI 生產廠商和設備號，而不是在 PCI ID 數據庫中查找它們。

       -x     以十六進制顯示 PCI  配置空間  (configuration  space)  的前64個字節映像  (標準頭部信
              息)。此參數對調試驅動和 lspci 本身很有用。

       -xxx   以十六進制顯示所有  PCI 配置空間的映像。此選項只有 root 可用，並且很多 PCI 設備在你
              試圖讀取配置空間的未定義部分時會崩潰     (此操作可能不違反PCI標準，但是它至少非常愚
              蠢)。

       -b     以總線為中心進行查看。顯示所有   IRQ  號和記憶體地址，就像  PCI  總線上的卡看到的一
              樣，而不是核心看到的內容。

       -t     以樹形方式顯示包含所有總線、橋、設備和它們的連接的圖表。

       -s [[<bus>]:][<slot>][.[<func>]]
              僅顯示指定總線、插槽上的設備或設備上的功能塊信息。設備地址的任何部分都可以忽略，或
              以「*」代替  (意味著所有值)。所有數字都是十六進制。例如：「0：」指的是在0號總線上的
              所有設備；「0」指的是在任意總線上0號設備的所有功能塊；「0.3」選擇了所有總線上0號設
              備的第三個功能塊；「.4」則是只列出每一設備上的第四個功能塊。

       -d [<vendor>]:[<device>]
              只顯示指定生產廠商和設備  ID  的設備。  這兩個  ID 都以十六進制表示，可以忽略或者以
              「*」代替 (意味著所有值)。

       -i <file>
              使用 <file> 作為 PCI ID 數據庫而不是使用預設的 /usr/share/hwdata/pci.ids。

       -p <dir>
              使用 <dir> 作為包含 PCI 總線信息的目錄而不是使用預設的目錄 /proc/bus/pci。

       -m     以機器可讀的方式轉儲 PCI 設備數據 (支持兩種模式：普通和冗餘)，便於稿本解析。

       -M     使用總線映射模式，這種模式對總線進行全面地掃描以查明總線上的所有設備，包括配置錯誤
              的橋之後的設備。請注意，此操作只應在調試時使用，並可能造成系統崩潰  (只在設備有錯誤
              的時候，但是不幸的是它們存在)，此命令只有  root  可以使用。同時，在不直接接觸硬體的
              PCI  訪問模式中使用 -M 參數沒有意義，因為顯示的結果 (排除 lspci 中的 bug 的影響) 與
              普通的列表模式相同。

       --version
              顯示 lspci 的版本。這個選項應當單獨使用。

PCILIB 選項 PCILIB OPTIONS

       PCI 工具使用 PCILIB (一種可移植的庫，提供平台獨立的函數來訪問  PCI  配置空間)  來和PCI卡交
       互。下面的選項用來控制庫參數，特別是所用訪問模式的指定。預設情況下，PCILIB  使用第一種可用
       的訪問模式，不會顯示任何調試信息。每一個開關選項都列出了一組它所支持的硬體/軟體列表。

       -P <dir>
              使用 linux 2.1  風格的配置，直接訪問目錄  <dir>  而非  /proc/bus/pci  目錄。(只能在
              linux 2.1 或以上版本中使用)

       -H1    通過 Intel 架構 1 來實現直接硬體訪問。(只能用於 i386 及其相容機)

       -H2    通過Intel 架構 2 來實現直接硬體訪問。警告：此模式只能尋址任何總線上的前16個設備，並
              且在很多情況下相當不可靠。(只能用於 i386 及其相容機)

       -S     使用 PCI 系統調用訪問。(只能用於 Alpha 和 Ultra-Sparc 上的 Linux)

       -F <file>
              從所給的包含 lspci -x  命令輸出的檔案中獲取相關信息。這在分析使用者提交的錯誤報告時
              很有用，因為你可以用任何方式來顯示硬體配置信息而無需為了獲取更多信息打擾使用者。(可
              用於所有系統)

       -G     增加庫的調試等級。(可用於所有系統)

檔案 FILES

       /usr/share/hwdata/pci.ids
              所有已知 PCI ID 的清單 (廠商，設備名，類，子類)

       /proc/bus/pci
              linux 2.1.82 之後版本核心提供的 PCI 總線配置空間的接口。包含每個總線 (per-bus) 的子
              目錄以及每個設備卡  (per-card) 的配置空間檔案，還有一個 devices 檔案，包含所有PCI設
              備的列表。

參見 SEE ALSO

       setpci(8)

作者 AUTHOR

       Linux PCI 工具由 Martin Mares <mj@atrey.karlin.mff.cuni.cz> 維護。

[中文版維護人]

       所羅門 <solomen@email.com.cn>

[中文版最新更新]

       Nov 28 2000

《中國linux論壇man手冊頁翻譯計劃》:

       http://cmpp.linuxforum.net