read、readx、 read64x、readv、readvx、eread、ereadv、pread、または preadv サブルーチン

目的

ファイルから読み取る。

ライブラリー

構文

#include <unistd.h>

ssize_t read (FileDescriptor, Buffer, NBytes)
int FileDescriptor;
void * Buffer;
size_t NBytes;

int readx (FileDescriptor, Buffer, NBytes, Extension)
int FileDescriptor;
char * Buffer;
unsigned int NBytes;
int Extension;

int read64x (FileDescriptor, Buffer, NBytes, Extension)
int FileDescriptor;
void *Buffer;
size_t NBytes;
void *Extension;

ssize_t pread (int fildes, void *buf, size_t nbyte, off_t offset);

#include <sys/uio.h>

ssize_t readv (FileDescriptor, iov, iovCount)
int FileDescriptor;
const struct iovec * iov;
int iovCount;

ssize_t readvx (FileDescriptor, iov, iovCount, Extension)
int FileDescriptor;
struct iovec *iov;
int iovCount;
int Extension;

#include <unistd.h>
#include <sys/uio.h>

ssize_t preadv ( 
int  FileDescriptor,
const struct iovec * iov,
int iovCount,
offset_t offset);

ssize_t eread (FileDescriptor, Buffer, Nbytes,  labels)
int FileDescriptor;
const void * Buffer;
size_t  NBytes;
sec_labels_t * labels;

ssize_t ereadv (FileDescriptor, iov, iovCount, labels)
int FileDescriptor;
const struct iovec * iov;
int iovCount;
sec_labels_t * labels;

説明

read サブルーチンは、 FileDescriptor パラメーターに関連したファイルから、 Buffer パラメーターが指すバッファーに NBytes のデータを読み取ろうとします。

readv サブルーチンは同じアクションを実行しますが、 iov パラメーターが指す iovec 構造体の配列によって指定される iovCount バッファーに入力データを分散させます。 各 Iovec 項目は、データを入れる必要があるメモリー内の領域の基底アドレスと長さを指定します。 READV サブルーチンは、次の処理に進む前に、常に区域を完全に埋めます。

Readx サブルーチンと Readvx サブルーチンは、それぞれ 読み取り サブルーチンと READV サブルーチンと同じですが、一部のデバイス・ドライバーから読み取るとき、およびディレクトリーを読み取るときに必要な 拡張 パラメーターが追加されています。 ディレクトリーは直接読み取ることができますが、 OpenDIR 呼び出しと Readdir 呼び出しは、より移植性の高いインターフェースであるため、代わりに使用します。

シーク可能な通常のファイルおよびデバイスでは、 read は、 FileDescriptor パラメーターに関連付けられたファイル・ポインターによって指定されたファイル内の位置から始まります。 読み取り サブルーチンから戻ると、ファイル・ポインターは、実際に読み取られたバイト数だけ増分されます。

シークできないデバイスは、常に現在位置から読み取られます。 そのようなファイルに関連付けられているファイル・ポインターの値は未定義です。

ディレクトリの場合、 readvxサブルーチンは、FileDescriptorパラメータに関連付けられたファイルポインタで指定された位置から開始する。 このファイル・ポインターの値は、0、またはこのディレクトリーの Readvx サブルーチンに対する直前の呼び出しの直後にファイル・ポインターが持っていた値のいずれかでなければなりません。 Readvx サブルーチンから戻ると、ファイル・ポインターは、バッファーにコピーされたバイト数に対応しない数だけ増分します。

システムが空のパイプ (先入れ先出し (FIFO)) から読み取ろうとすると、次のようになります。

• 書き込み用のパイプが開かれているプロセスがない場合、 読み取り はファイルの終わりを示す 0 を戻します。
• 何らかのプロセスが、書き込みのためにパイプをオープンしている場合:
  • O_NDELAY (Y) および O_ 非ブロック がクリアされている場合 (デフォルト)、 読み取り は、一部のデータが書き込まれるか、パイプを書き込み用にオープンするすべてのプロセスによってパイプがクローズされるまでブロックします。
  • O_NDELAY (Y) が設定されている場合、 読み取り サブルーチンは値 0 を戻します。
  • O_NONBLOCK が設定されている場合、 read サブルーチンは -1 の値を戻し、グローバル変数 errno を EAGAINに設定します。

システムが、端末などの非ブロッキング読み取りをサポートするキャラクター・スペシャル・ファイルから読み取ろうとして、使用可能なデータがない場合。

• O_NDELAY (Y) および O_ 非ブロック がクリアされている場合 (デフォルト)、 読み取り サブルーチンはデータが使用可能になるまでブロックします。
• O_NDELAY (Y) が設定されている場合、 読み取り サブルーチンは 0 を返します。
• O_NONBLOCK が設定されている場合、 read サブルーチンは -1 を戻し、使用可能なデータがない場合は、 errno グローバル変数を EAGAIN に設定します。

システムが強制モード・レコード・ロックをサポートする通常ファイルを読み取ろうとしていて、読み取る領域の全部または一部が別のプロセスによってロックされている場合:

• O_NDELAY (Y) および O_ 非ブロック がクリアされている場合、 読み取り はロックが解放されるまで呼び出しプロセスをブロックします。
• O_NDELAY または O_NONBLOCK が設定されている場合、 read は -1 を戻し、グローバル変数 errno をEAGAINに設定します。

割り込まれた 読み取り サブルーチンの動作は、到着するシグナルのハンドラーがどのようにインストールされたかによって異なります。

ハンドラーがインストールされていて、サブルーチンを再始動してはならないことが示されている場合、 read サブルーチンは -1 の値を戻し、グローバル変数 errno は EINTR に設定されます (一部のデータが既に除去されている場合でも)。

ハンドラーがインストールされている場合は、サブルーチンを再始動する必要があることを示します。

• 割り込みが処理されたときにデータが読み取られなかった場合、この 読み取り は値を戻しません (再始動されます)。
• 割り込みが処理されたときにデータが読み取られた場合、この 読み取り サブルーチンは除去されたデータの量を戻します。

read64x サブルーチンは、 Readx サブルーチンと同じです。ここで、 拡張 パラメーターは、 j2_ext 構造体へのポインターです ( j2/j2_cntl.h ファイルを参照)。 read64x サブルーチンは、暗号化されたファイルをロー・モードで読み取るために使用されます ( fcntl.h ファイルの O_RAW を参照してください)。 暗号化されたファイルで O_RAW フラグを使用する場合は、通常のファイルで O_DIRECT を使用する場合と同じ制限があります。

読み取り および エレディフ サブルーチンは、ストリームから読み取り、メッセージを取り出します。 eread サブルーチンは、データのバイト数をバッファーから FileDescriptor パラメーターに関連したストリームにコピーします。 N バイト パラメーターは、バイト数を指定します。 バッファー パラメーターはバッファーを指します。 セキュリティー情報は、 ラベル パラメーターが指す構造体に戻されます。

スプレッド 関数は、ファイル・ポインターを変更せずにファイル内の特定の位置から読み取ることを除き、 読み取りと同じアクションを実行します。 スプレッド の最初の 3 つの引数は、 読み取り と同じですが、ファイル内の目的の位置のオフセットである 4 番目の引数が追加されています。 シークできないファイルに対して スプレッド を実行しようとすると、エラーになります。

ssize_t pread64(int fildes , void *buf , size_t nbytes , off64_t offset)

pread64 サブルーチンは スプレッド と同じアクションを実行しますが、ファイル記述子に関連付けられているファイルがブロック特殊ファイルまたは文字特殊ファイルの場合は、ファイル記述子と DEV_OFF_MAX に関連付けられているファイルの最大ファイル・サイズに対するオフセットの制限があります。 フィルド がソケットを参照する場合、 読み取り はフラグが設定されていない 受信 サブルーチンと同等です。

シャM_OPEN サブルーチンへの呼び出しから取得したファイル・ディスクリプターを使用して 読み取り サブルーチンまたは スプレッド サブルーチンを使用すると、 ENXIO (X)で失敗します。

プリアドフ サブルーチンは、 READV サブルーチンと同じアクションを実行します。ただし、 プリアドフ サブルーチンは、ファイル・ポインターを変更せずにファイル内の特定の位置から読み取ります。 プリアドフ サブルーチンの最初の 3 つの引数は、 READV サブルーチンと同じですが、ファイル内の必要な位置を指す オフセット 引数が追加されています。 プリアドフ サブルーチンが読み取るファイルがシークできない場合は、エラーが発生します。

パラメーター

caddr_t iov_base;
size_t iov_len;

戻り値

正常終了すると、 読み取り、 Readx、 read64x、 READV、 Readvx、 スプレッド、および プリアドフ サブルーチンは、読み取られてバッファーに入れられたバイト数を戻します。 システムは、記述子が、ファイルの終わりに達する前に残されたバイト数と同じバイト数を持つ通常ファイルを参照する場合、要求されたバイト数を読み取ることを保証しますが、それ以外の場合は保証しません。

ファイルの終わりに達すると、値 0 が戻されます。 (通信ファイルについては、 Ioctl ファイルと テルミオ ファイルを参照してください。)

それ以外の場合は、値 -1 が戻され、グローバル変数 errno がエラーを識別するように設定され、 Buffer または iov パラメーターが指すバッファーの内容は不確定です。

正常終了すると、 読み取り および エレディフ サブルーチンは値 0 を戻します。 それ以外の場合は、エラーを識別するためにグローバル変数 エラー番号 が設定されます。

エラー・コード

読み取り、 Readx、 read64x、 READV、 Readvx、 スプレッド、 読み取り、 エレディフ、および プリアドフ サブルーチンは、以下の 1 つ以上が該当する場合には失敗します。

読み取り、 Readx、 READV、 Readvx、 スプレッド、および プリアドフ サブルーチンは、以下の条件が満たされている場合は失敗する可能性があります。

ネットワーク・ファイル・システム (NFS) がシステムにインストールされている場合、以下の条件が満たされていると、 read システム・コールも失敗する可能性があります。