.TH lspci 8 "30 March 2002" "pciutils-2.1.10" "Linux PCI Utilities"
.IX lspci
.SH NAME
lspci \- 列出所有PCI設備
.SH 總覽 SYNOPSIS
.B lspci
.RB [ options ]
.SH 描述 DESCRIPTION
.B lspci
是一個用來顯示系統中所有PCI總線設備或連接到該總線上的所有設備的工具。

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

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

.SH 選項 OPTIONS
.TP
.B -v
使得
.I lspci
以冗餘模式顯示所有設備的詳細信息。
.TP
.B -vv
使得
.I lspci
以過冗餘模式顯示更詳細的信息 (事實上是 PCI 設備能給出的所有東西)。這些數據的確切意義沒有在此手冊頁中解釋，如果你想知道更多，請參照
.B /usr/include/linux/pci.h
或者 PCI 規範。
.TP
.B -n
以數字形式顯示 PCI 生產廠商和設備號，而不是在 PCI ID 數據庫中查找它們。
.TP
.B -x
以十六進制顯示 PCI 配置空間 (configuration space) 的前64個字節映象 (標準頭部信息)。此參數對調試驅動和
.I lspci
本身很有用。
.TP
.B -xxx
以十六進制顯示所有 PCI 配置空間的映象。此選項只有 root 可用，並且很多 PCI 設備在你試圖讀取配置空間的未定義部分時會崩潰 (此操作可能不違反PCI標準，但是它至少非常愚蠢)。
.TP
.B -b
以總線爲中心進行查看。顯示所有 IRQ 號和內存地址，就象 PCI 總線上的卡看到的一樣，而不是內核看到的內容。
.TP
.B -t
以樹形方式顯示包含所有總線、橋、設備和它們的連接的圖表。
.TP
.B -s [[<bus>]:][<slot>][.[<func>]]
僅顯示指定總線、插槽上的設備或設備上的功能塊信息。設備地址的任何部分都可以忽略，或以“*”代替 (意味着所有值)。所有數字都是十六進制。例如：“0：”指的是在0號總線上的所有設備；“0”指的是在任意總線上0號設備的所有功能塊；“0.3”選擇了所有總線上0號設備的第三個功能塊；“.4”則是隻列出每一設備上的第四個功能塊。
.TP
.B -d [<vendor>]:[<device>]
只顯示指定生產廠商和設備 ID 的設備。 這兩個 ID 都以十六進制表示，可以忽略或者以“*”代替 (意味着所有值)。
.TP
.B -i <file>
使用
.B <file>
作爲 PCI ID 數據庫而不是使用默認的 \fI/usr/share/hwdata/pci.ids\fR。
.TP
.B -p <dir>
使用
.B <dir>
作爲包含 PCI 總線信息的目錄而不是使用默認的目錄 \fI/proc/bus/pci\fR。
.TP
.B -m
以機器可讀的方式轉儲 PCI 設備數據 (支持兩種模式：普通和冗餘)，便於腳本解析。
.TP
.B -M
使用總線映射模式，這種模式對總線進行全面地掃描以查明總線上的所有設備，包括配置錯誤的橋之後的設備。請注意，此操作只應在調試時使用，並可能造成系統崩潰 (只在設備有錯誤的時候，但是不幸的是它們存在)，此命令只有 root 可以使用。同時，在不直接接觸硬件的 PCI 訪問模式中使用 \fI-M\fR 參數沒有意義，因爲顯示的結果 (排除 lspci 中的 bug 的影響) 與普通的列表模式相同。
.TP
.B --version
顯示
.I lspci
的版本。這個選項應當單獨使用。

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

.TP
.B -P <dir>
使用 linux 2.1 風格的配置，直接訪問目錄
.B <dir>
而非 \fI/proc/bus/pci\fR 目錄。(只能在 linux 2.1 或以上版本中使用)
.TP
.B -H1
通過 Intel 架構 \fB1\fR 來實現直接硬件訪問。(只能用於 i386 及其兼容機)
.TP
.B -H2
通過Intel 架構 \fB2\fR 來實現直接硬件訪問。警告：此模式只能尋址任何總線上的前16個設備，並且在很多情況下相當不可靠。(只能用於 i386 及其兼容機)
.TP
.B -S
使用 PCI 系統調用訪問。(只能用於 Alpha 和 Ultra-Sparc 上的 Linux)
.TP
.B -F <file>
從所給的包含 \fIlspci -x\fR 命令輸出的文件中獲取相關信息。這在分析用戶提交的錯誤報告時很有用，因爲你可以用任何方式來顯示硬件配置信息而無需爲了獲取更多信息打擾用戶。(可用於所有系統)
.TP
.B -G
增加庫的調試等級。(可用於所有系統)

.SH 文件 FILES
.TP
.B /usr/share/hwdata/pci.ids
所有已知 PCI ID 的清單 (廠商，設備名，類，子類)
.TP
.B /proc/bus/pci
\fIlinux 2.1.82\fR 之後版本內核提供的 PCI 總線配置空間的接口。包含每個總線 (per-bus) 的子目錄以及每個設備卡 (per-card) 的配置空間文件，還有一個
.I devices
文件，包含所有PCI設備的列表。

.SH 參見 SEE ALSO
.BR setpci (8)

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

.SH "[中文版維護人]"
.B 所羅門 <solomen@email.com.cn>
.SH "[中文版最新更新]"
.B Nov 28 2000
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net 
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR