Manpages

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 [AT] atrey.cz> 维 护 。

[中 文 版 维 护 人 ]

所 罗 门 <solomen [AT] email.cn>

[中 文 版 最 新 更 新 ]

Nov 28 2000

《 中 国 linux论 坛 man手 册 页 翻 译 计 划 》 :

http://cmpp.linuxforum.net

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh