SENDFILE

名前

書式

ssize_t sendfile(int out_fd, int in_fd, off_t *offset, size_t count);  

説明

in_fd は読み込みのためにオープンされたファイル・ディスクリプタ、 out_fd は書き込みのためにオープンされたディスクリプタでなければならない。

offset が NULL でない場合、 offset は sendfile() が in_fd のどこからデータを読み始めるかを示すファイル・オフセットを保持する変数への ポインタである。 sendfile() は復帰する時、この変数に最後に読み込んだバイトの 次のバイトのオフセットを書き込む。 offset が NULL でない場合、 sendfile() は in_fd のファイル・オフセットの現在値を変更しない。 NULL の場合は、ファイル・オフセットの現在値を in_fd から読み込んだバイト数を反映した位置に調整する。

count は、ファイル・ディスクリプタ間でコピーするバイト数である。

今のところ (Linux 2.6.9 では)、 in_fd は mmap(2) 風の操作ができるファイルを指していなければならない (ソケットを指してはならない)。また、 out_fd はソケットを指していなければならない。

sendfile() が EINVAL や ENOSYS で失敗するような場合は、 アプリケーションは read(2)/write(2) に戻すことを考えてもよいかもしれない。  

返り値

エラー

EAGAIN

O_NONBLOCK を用いて非ブロック I/O が選択されたが、書き込みがブロックされた。

EBADF

入力ファイルが読み込みのためにオープンされていないか、 出力ファイルが書き込みのためにオープンされていない。

EFAULT

アドレスがおかしい。

EINVAL

ディスクリプタが有効でないか、ロックされている。もしくは mmap(2) 風の操作が in_fd では利用できない。

EIO

in_fd から読み込んでいるうちに予期しないエラーが起こった。

ENOMEM

in_fd から読み込むための十分なメモリがない。

バージョン

準拠

他の Unix システムでは、異なった方式やプロトタイプで sendfile() を実装している。移植性を考慮したプログラムでは使用すべきではない。  

注意

Linux 2.4 とそれ以前のバージョンでは、 out_fd は通常のファイルを参照でき、 sendfile() はそのファイルのオフセットの現在値を変更していた。  

関連項目

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

関連項目