.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