manual/pciutils/draft/man8/setpci.8

   1 .\"
   2 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
   3 .\"         all rights reserved.
   4 .\" Translated Mon Mar  8 03:03:53 JST 2004
   5 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
   6 .\"
   7 .\"WORD:        PCI configuration space PCI 設定空間
   8 .\"WORD:        vendor                  ベンダ
   9 .\"WORD:        verbose                 詳細な
  10 .\"
  11 .TH setpci 8 "04 January 2003" "pciutils-2.1.11" "Linux PCI Utilities"
  12 .IX setpci
  13 .\"O .SH NAME
  14 .SH 名前
  15 .\"O setpci \- configure PCI devices
  16 setpci \- PCI デバイスを設定する
  17 .\"O .SH SYNOPSIS
  18 .SH 書式
  19 .B setpci
  20 .RB [ options ]
  21 .B devices
  22 .BR operations ...
  23 .\"O
  24 .\"O .SH DESCRIPTION
  25 .SH 説明
  26 .PP
  27 .\"O .B setpci
  28 .\"O is a utility for querying and configuring PCI devices.
  29 .B setpci
  30 は PCI デバイスの情報を取得したり設定したりするユーティリティである。
  31
  32 .\"O All numbers are entered in hexadecimal notation.
  33 全ての数値は 16 進数表記で入力される。
  34 .\"O
  35 .\"O .SH OPTIONS
  36 .SH オプション
  37 .TP
  38 .B -v
  39 .\"O Tells
  40 .\"O .I setpci
  41 .\"O to be verbose and display detailed information about configuration space accesses.
  42 .I setpci
  43 に情況を詳細に報告させ、設定空間アクセスの詳細な情報を表示させる。
  44 .TP
  45 .B -f
  46 .\"O Tells
  47 .\"O .I setpci
  48 .\"O not to complain when there's nothing to do (when no devices are selected).
  49 (デバイスが選択されなかったり) 何もすることがなくても、
  50 .I setpci
  51 にエラーを表示させない。
  52 .\"O This option is intended for use in widely-distributed configuration scripts
  53 .\"O where it's uncertain whether the device in question is present in the machine
  54 .\"O or not.
  55 このオプションは広く配布されている設定スクリプトで使うことを意図している。
  56 この設定スクリプトでは、問題としているデバイスが
  57 マシンに存在するか否かが確かでないためである。
  58 .TP
  59 .B -D
  60 .\"O `Demo mode' -- simulate configuration space accesses instead of really doing them.
  61 「デモモード」 -- 実際に実行しないで設定空間アクセスをシミュレートする。
  62 .\"O It's useful to try
  63 .\"O .B setpci -vD
  64 .\"O to see what your complex sequence of
  65 .\"O .B setpci
  66 .\"O operations does before you actually execute it.
  67 .B setpci -vD
  68 を試してみると、実際に実行する前に
  69 どれだけ複雑な
  70 .B setpci
  71 操作のシーケンスが実行されるかを見ることができて、役に立つ。
  72 .TP
  73 .B --version
  74 .\"O Shows
  75 .\"O .I setpci
  76 .\"O version. This option should be used standalone.
  77 .I setpci
  78 のバージョンを表示する。
  79 このオプションは単独で使用すべきである。
  80 .\"O
  81 .\"O .SH DEVICE SELECTION
  82 .SH デバイスの選択
  83 .PP
  84 .\"O Before each sequence of operations you need to select which devices you wish that
  85 .\"O operation to affect.
  86 操作のシーケンスの前に、操作の対象としたいデバイスを選択する必要がある。
  87 .TP
  88 .B -s [[<bus>]:][<slot>][.[<func>]]
  89 .\"O Select devices in specified bus, slot and function. Each component of the device
  90 .\"O address can be omitted or set as "*" meaning "any value". All numbers are
  91 .\"O hexadecimal.  E.g., "0:" means all devices on bus 0, "0" means all functions of device 0
  92 .\"O on any bus, "0.3" selects third function of device 0 on all busses and ".4" selects only
  93 .\"O fourth function of each device.
  94 指定されたバス (bus)・スロット (slot)・機能 (func) のデバイスを選択する。
  95 デバイスの指定の各要素は省略可能で、また "*" は「任意の値」を意味する。
  96 全ての数値は 16 進数で入力する。
  97 例えば、"0:" はバス 0 の全てのデバイスを、
  98 "0" は全てのバスのデバイス 0 で全ての機能を意味し、
  99 "0.3" は全てのバスのデバイス 0 で 3 番目の機能を選択し、
 100 ".4" は各デバイスの 4 番目の機能を選択する。
 101 .TP
 102 .B -d [<vendor>]:[<device>]
 103 .\"O Select devices with specified vendor and device ID. Both ID's are given in
 104 .\"O hexadecimal and may be omitted or given as "*" meaning "any value".
 105 指定されたベンダ ID とデバイス ID を持つデバイスを選択する。
 106 両 ID とも 16 進で与えられる。省略も可能である。
 107 また、「任意の値」を意味する "*" を指定することも可能である。
 108 .\"O
 109 .\"O .SH OPERATIONS
 110 .SH 操作
 111 .PP
 112 .\"O To query value of a configuration register, just name it (either by typing its name or
 113 .\"O by typing register address with optional
 114 .\"O .BR .B ,
 115 .\"O .B .W
 116 .\"O or
 117 .\"O .B .L
 118 .\"O suffix specifying register width as byte, word or longword).
 119 設定レジスタの値を取得するには、単に名前を指定すること
 120 (名前を入力してもよいし、
 121 レジスタのアドレスを入力してもよい。
 122 レジスタのアドレスには、オプションとして
 123 .BR .B ,
 124 .BR .W,
 125 .B .L
 126 というバイト・ワード・ロングワードのレジスタ長を指定する
 127 サフィックスを付けることもできる)。
 128 .PP
 129 .\"O To set a register, write
 130 .\"O .BR reg = values
 131 .\"O where
 132 .\"O .B reg
 133 .\"O is the same you would use to query the register and
 134 .\"O .B values
 135 .\"O is a comma-separated list of values you want to write starting with the given
 136 .\"O address.
 137 レジスタを設定するには
 138 .BR reg = values
 139 と書くこと。
 140 ここで
 141 .B reg
 142 はレジスタの情報を取得するのに使ったのと同じ書式であり、
 143 .B values
 144 は指定したアドレスを開始点として書き込むコンマ区切りの値のリストである。
 145 .\"O
 146 .\"O .SH REGISTER NAMES
 147 .SH レジスタ名
 148 .PP
 149 .\"O .B setpci
 150 .\"O knows the following configuration register names. See PCI bus specs for their precise
 151 .\"O meaning or consult
 152 .\"O .B /usr/include/linux/pci.h
 153 .\"O for few comments.
 154 .B setpci
 155 は以下の設定レジスタ名を認識する。
 156 これらの正確な意味については、PCI バスの仕様を参照するか、
 157 .B /usr/include/linux/pci.h
 158 にあるいくつかのコメントを見よ。
 159 .PP
 160 .nf
 161 VENDOR_ID
 162 DEVICE_ID
 163 COMMAND
 164 STATUS
 165 REVISION
 166 CLASS_PROG
 167 CLASS_DEVICE
 168 CACHE_LINE_SIZE
 169 LATENCY_TIMER
 170 HEADER_TYPE
 171 BIST
 172 BASE_ADDRESS_0
 173 BASE_ADDRESS_1
 174 BASE_ADDRESS_2
 175 BASE_ADDRESS_3
 176 BASE_ADDRESS_4
 177 BASE_ADDRESS_5
 178 CARDBUS_CIS
 179 SUBSYSTEM_VENDOR_ID
 180 SUBSYSTEM_ID
 181 ROM_ADDRESS
 182 INTERRUPT_LINE
 183 INTERRUPT_PIN
 184 MIN_GNT
 185 MAX_LAT
 186 PRIMARY_BUS
 187 SECONDARY_BUS
 188 SUBORDINATE_BUS
 189 SEC_LATENCY_TIMER
 190 IO_BASE
 191 IO_LIMIT
 192 SEC_STATUS
 193 MEMORY_BASE
 194 MEMORY_LIMIT
 195 PREF_MEMORY_BASE
 196 PREF_MEMORY_LIMIT
 197 PREF_BASE_UPPER32
 198 PREF_LIMIT_UPPER32
 199 IO_BASE_UPPER16
 200 IO_LIMIT_UPPER16
 201 BRIDGE_ROM_ADDRESS
 202 BRIDGE_CONTROL
 203 CB_CARDBUS_BASE
 204 CB_CAPABILITIES
 205 CB_SEC_STATUS
 206 CB_BUS_NUMBER
 207 CB_CARDBUS_NUMBER
 208 CB_SUBORDINATE_BUS
 209 CB_CARDBUS_LATENCY
 210 CB_MEMORY_BASE_0
 211 CB_MEMORY_LIMIT_0
 212 CB_MEMORY_BASE_1
 213 CB_MEMORY_LIMIT_1
 214 CB_IO_BASE_0
 215 CB_IO_BASE_0_HI
 216 CB_IO_LIMIT_0
 217 CB_IO_LIMIT_0_HI
 218 CB_IO_BASE_1
 219 CB_IO_BASE_1_HI
 220 CB_IO_LIMIT_1
 221 CB_IO_LIMIT_1_HI
 222 CB_SUBSYSTEM_VENDOR_ID
 223 CB_SUBSYSTEM_ID
 224 CB_LEGACY_MODE_BASE
 225 .\"O
 226 .\"O .SH PCILIB OPTIONS
 227 .SH PCILIB オプション
 228 .\"O The PCI utilities use PCILIB (a portable library providing platform-independent
 229 .\"O functions for PCI configuration space access) to talk to the PCI cards. The following
 230 .\"O options control parameters of the library, especially what access method it uses.
 231 PCI utilities は PCI カードとやりとりをするために
 232 PCILIB (PCI 設定空間にアクセスするための機能を提供する、
 233 プラットフォームに依存せず移植性の高いライブラリ) を用いている。
 234 .\"O By default, PCILIB uses the first available access method and displays no debugging
 235 .\"O messages. Each switch is accompanied by a list of hardware/software configurations
 236 .\"O it's supported in.
 237 デフォルトでは、PCILIB はアクセス方法で可能なもののうち最初のものを用い、
 238 何らデバッグメッセージを表示しない。
 239 各々のスイッチには、そのスイッチに対応している
 240 ハードウェア/ソフトウェアの設定リストが付随する。
 241 .\"O
 242 .TP
 243 .B -P <dir>
 244 .\"O Force use of Linux /proc/bus/pci style configuration access, using
 245 .\"O .B <dir>
 246 .\"O instead of /proc/bus/pci. (Linux 2.1 or newer only)
 247 /proc/bus/pci の代わりに、
 248 .B <dir>
 249 を使った Linux /proc/bus/pci スタイルの設定でアクセスを行わせる。
 250 (Linux 2.1 またはそれ以降でのみ有効)
 251 .TP
 252 .B -H1
 253 .\"O Use direct hardware access via Intel configuration mechanism 1. (i386 and compatible only)
 254 インテル設定メカニズム 1 (Intel configuration mechanism 1) を使って、
 255 ハードウェアに直接アクセスする。(i386 及びその互換でのみ有効)
 256 .TP
 257 .B -H2
 258 .\"O Use direct hardware access via Intel configuration mechanism 2. Warning: This method
 259 .\"O is able to address only first 16 devices on any bus and it seems to be very
 260 .\"O unrealiable in many cases. (i386 and compatible only)
 261 インテル設定メカニズム 2 (Intel configuration mechanism 2) を使って、
 262 ハードウェアに直接アクセスする。
 263 警告: この方法では各バスの最初の 16 デバイスしか扱えず、
 264 多くの場合殆んど信頼できない。(i386 及びその互換でのみ有効)
 265 .TP
 266 .B -S
 267 .\"O Use PCI access syscalls. (Linux on Alpha and UltraSparc only)
 268 PCI アクセスシステムコールを使う。(Alpha/Linux と UltraSparc でのみ有効)
 269 .TP
 270 .B -F <file>
 271 .\"O Extract all information from given file containing output of lspci -x. This is very
 272 .\"O useful for analysis of user-supplied bug reports, because you can display the
 273 .\"O hardware configuration in any way you want without disturbing the user with
 274 .\"O requests for more dumps. (All systems)
 275 lspci -x の実行結果を格納しているファイルから、全ての情報を取り出す。
 276 ユーザーから提供されたバグ報告の解析に役立つ。
 277 なぜならば、さらなるダンプをユーザーに要求する事なく、
 278 ハードウェアの設定をあなたの好きなやり方で表示する事ができる。
 279 (全てのシステムで有効)
 280 .TP
 281 .B -G
 282 .\"O Increase debug level of the library. (All systems)
 283 ライブラリのデバッグレベルを上げる。(全てのシステムで有効)
 284 .\"O
 285 .\"O .SH EXAMPLES
 286 .SH 例
 287 .PP
 288 .\"O `setpci -d *:* latency_timer=40' sets the latency timer to 64 (40 hexadecimal).
 289 `setpci -d *:* latency_timer=40' レイテンシタイマを
 290 64 (16 進数の 40) に設定する。
 291 .PP
 292 .\"O `setpci -s 0 device_id vendor_id' lists ID's of devices in slot 0 in all busses.
 293 `setpci -s 0 device_id vendor_id' 全てのバスのスロット 0 にある
 294 デバイスの ID をリストする。
 295 .PP
 296 .\"O `setpci -s 12:3.4 3c.l=1,2,3' writes longword 1 to register 3c, 2 to register 3d
 297 .\"O and 3 to register 3e of device at bus 12, slot 3, function 4.
 298 `setpci -s 12:3.4 3c.l=1,2,3' バス 12・スロット 3・機能 4 のデバイスの
 299 レジスタ 3c にロングワード 1、レジスタ 3d に 2、
 300 レジスタ 3e に 3 を書き込む。
 301 .\"O
 302 .\"O .SH SEE ALSO
 303 .SH 関連項目
 304 .BR lspci (8)
 305 .\"O
 306 .\"O .SH AUTHOR
 307 .SH 著者
 308 .\"O The Linux PCI Utilities are maintained by Martin Mares <mj@ucw.cz>.
 309 Linux PCI Utilities は Martin Mares <mj@ucw.cz> に
 310 よって保守されている。