draft/man2/pciconfig_read.2

   1 .\" Contributed by Niki A. Rahimi, LTC Security Development
   2 .\" narahimi@us.ibm.com
   3 .\"
   4 .\" %%%LICENSE_START(FREELY_REDISTRIBUTABLE)
   5 .\" May be freely distributed.
   6 .\" %%%LICENSE_END
   7 .\"
   8 .\"*******************************************************************
   9 .\"
  10 .\" This file was generated with po4a. Translate the source file.
  11 .\"
  12 .\"*******************************************************************
  13 .\"
  14 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
  15 .\"         all rights reserved.
  16 .\" Translated Sat Jun 19 17:51:11 JST 2004
  17 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  18 .\"
  19 .TH PCICONFIG_READ 2 2003\-07\-14 Linux "Linux Programmer's Manual"
  20 .SH 名前
  21 pciconfig_read, pciconfig_write, pciconfig_iobase \- pci デバイス情報を扱う
  22 .SH 書式
  23 .nf
  24 \fB#include <pci.h>\fP
  25 .sp
  26 \fBint pciconfig_read(unsigned long \fP\fIbus\fP\fB, unsigned long \fP\fIdfn\fP\fB,\fP
  27 \fB          unsigned long \fP\fIoff\fP\fB, unsigned long \fP\fIlen\fP\fB, void *\fP\fIbuf\fP\fB);\fP
  28 \fBint pciconfig_write(unsigned long \fP\fIbus\fP\fB, unsigned long \fP\fIdfn\fP\fB,\fP
  29 \fB          unsigned long \fP\fIoff\fP\fB, unsigned long \fP\fIlen\fP\fB, void *\fP\fIbuf\fP\fB);\fP
  30 \fBint pciconfig_iobase(long \fP\fIwhich\fP\fB, unsigned long \fP\fIbus\fP\fB,\fP
  31 \fB          unsigned long \fP\fIdevfn\fP\fB);\fP
  32 .fi
  33 .SH 説明
  34 .PP
  35 PCI デバイスとのやり取り (interaction) は カーネル PCI レイヤですでに処理されているので、
  36 通常はこららの関数をユーザ空間からアクセスする必要はない。
  37 .TP
  38 \fBpciconfig_read\fP()
  39 デバイス \fIdev\fP のオフセット \fIoff\fP の値を \fIbuf\fP に読み込む。
  40 .TP
  41 \fBpciconfig_write\fP()
  42 デバイス \fIdev\fP のオフセット \fIoff\fP に \fIbuf\fP の値を書き込む。
  43 .TP
  44 \fBpciconfig_iobase\fP()
  45 bus/devfn ペアをこの関数に渡し、 メモリオフセット (prep のようなものでは、この値は 0xc0000000 である) と PIO
  46 サイクルの IO ベースの物理アドレスを取得する。 また、もしあるならば ISA hole の物理アドレスを取得する。
  47 .SH 返り値
  48 .TP
  49 \fBpciconfig_read\fP()
  50 成功した場合、0 が返される。 エラーの場合、\-1 が返され、 \fIerrno\fP が適切に設定される。
  51 .TP
  52 \fBpciconfig_write\fP()
  53 成功した場合、0 が返される。 エラーの場合、\-1 が返され、 \fIerrno\fP が適切に設定される。
  54 .TP
  55 \fBpciconfig_iobase\fP()
  56 \fIwhich\fP の値に基づいて、物理メモリ内の様々な I/O 領域の位置情報が返される。 \fIwhich\fP の値は、
  57 \fBIOBASE_BRIDGE_NUMBER\fP, \fBIOBASE_MEMORY\fP, \fBIOBASE_IO\fP, \fBIOBASE_ISA_IO\fP,
  58 \fBIOBASE_ISA_MEM\fP である。
  59 .SH エラー
  60 .TP
  61 \fBEINVAL\fP
  62 \fIlen\fP の値が無効である。 このエラーは \fBpciconfig_iobase\fP()  には適用されない。
  63 .TP
  64 \fBEIO\fP
  65 I/O エラー。
  66 .TP
  67 \fBENODEV\fP
  68 \fBpciconfig_iobase\fP()  の場合、でホース (hose) の値が NULL である。 他の呼び出しの場合、スロット (slot)
  69 が見つからない。
  70 .TP
  71 \fBENOSYS\fP
  72 このシステムはこれらの呼び出しを実装していない。 (\fBCONFIG_PCI\fP が定義されていない)。
  73 .TP
  74 \fBEOPNOTSUPP\fP
  75 この返り値は \fBpciconfig_iobase\fP()  でのみ有効である。 このエラーは \fIwhich\fP の値が無効であるときに返される。
  76 .TP
  77 \fBEPERM\fP
  78 ユーザが \fBCAP_SYS_ADMIN\fP 権限を持っていない。 このエラーは \fBpciconfig_iobase\fP()  には適用されない。
  79 .SH 準拠
  80 これらの呼び出しは Linux 特有のものであり、 Linux 2.0.26/2.1.11 から使用可能である。
  81 .SH 関連項目
  82 \fBcapabilities\fP(7)
  83 .SH この文書について
  84 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
  85 である。プロジェクトの説明とバグ報告に関する情報は
  86 http://www.kernel.org/doc/man\-pages/ に書かれている。