名前

       sendfile - ファイルディスクリプター間でデータを転送する

書式

       #include <sys/sendfile.h>

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

説明

       sendfile()   は、あるファイルディスクリプターから別の ファイルディスクリプターへのデータの
       コピーを行う。  このコピーはカーネル内で行われるので、  sendfile()    は、   read(2)    と
       write(2)  を組み合わせるよりも効率がよい。  read(2)  や write(2)  ではユーザー空間との間で
       データの転送が必要となるからである。

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

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

       offset  が NULL の場合、データは in_fd の現在のファイルオフセットから読み出され、 ファイル
       オフセットはこの呼び出しで更新される。

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

       in_fd 引き数は mmap(2) 風の操作ができるファイルを指していなければならな い (ソケットを指定
       することはできない)。

       2.6.33  より前の  Linux カーネルでは out_fd はソケットを参照していなければな らない。Linux
       2.6.33      以降では、任意のファイルを参照することができる。      通常のファイルの場合には
       sendfile() はファイルオフセットを適切に変更する。

返り値

       転送に成功した場合、  out_fd に書き込まれたバイト数を返す。エラーの場合、-1 を返し、 errno
       に適切な値を設定する。

エラー

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

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

       EFAULT アドレスがおかしい。

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

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

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

バージョン

       sendfile は Linux 2.2 の新しい機能である。 インクルードファイル <sys/sendfile.h> は  glibc
       2.1 から存在している。

準拠

       POSIX.1-2001 や他の標準では規定されていない。

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

注意

       sendfile()  を使って TCP  ソケットにファイルを送ろうとしていて、  ファイルの内容の前にヘッ
       ダーデータを付け加える必要がある場合は、  パケット数を最小にして性能を上げるために  tcp(7)
       に記述されている TCP_CORK オプションを使うといいだろう。

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

       元々の  Linux sendfile() システムコールは大きなファイルオフセットを 扱えるように設計されて
       いなかった。その結果、Linux 2.4 で、 ビット幅の大きな offset  引き数を持った  sendfile64()
       が追加された。 glibc の sendfile() のラッパー関数はカーネルによるこの違いを吸収している。

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

       Linux 固有の splice(2) システムコールは、任意のファイル間 (例えば、 ソケット同士) でのデー
       タ転送をサポートしている。

関連項目

       mmap(2), open(2), socket(2), splice(2)

この文書について

       この  man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクト
       の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。