manページ  — SENDFILE

sendfile – ファイルをソケットに送信

ライブラリ 書式 解説 実装に関する注 チューニング 戻り値 エラー 関連項目 歴史 作者

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <sys/socket.h>

#include <sys/uio.h>

int
sendfile(int fd, int s, off_t offset, size_t nbytes, struct sf_hdtr *hdtr, off_t *sbytes, int flags);

sendfile() システムコールは、記述子 fd によって指定された通常のファイルを、記述子 s によって指定されたストリームソケットから送信します。

offset 引数はファイルのどこから開始すべきかを指定します。 offset がファイルの終りを超えていた場合は、システムは 次に説明されるように成功を返して、0 バイトを送信したと報告します。 nbytes 引数は、ファイルの何バイトを送信する必要があるかを指定します。 0 は、ファイルの終わりまで送信するという特殊な意味を持ちます。

オプションのヘッダまたはトレーラ、またはその両方は、構造体 sf_hdtr を 指すポインタを指定することによってファイルの前と後で送信できます。 struct sf_hdtr の構造は次のとおりです:

struct sf_hdtr {
        struct iovec *headers;  /* ヘッダ iovecs を指すポインタ */
        int hdr_cnt;            /* ヘッダ iovecs の数 */
        struct iovec *trailers; /* トレーラ iovecs を指すポインタ */
        int  trl_cnt;           /* トレーラ iovecs の数 */
};

headers ポインタと trailers ポインタは、 NULL でない場合に struct iovec 構造体の配列を指します。 iovec 構造体の詳細については、 writev() システムコールを参照してください。 これらの配列内の iovecs の数は、 hdr_cnt と trl_cnt によって指定されます。

NULL でない場合に、システムは、ソケット上に送信された合計バイト数を、 sbytes によって指された変数に書き込みます。

flags 引数として利用できる値は 1 つです: SF_NODISKIO 。 このフラグは、ディスク入出力でブロックされるであろうすべての sendfile() 呼び出しに対して、代わりに EBUSY を返させます。 ブロックされる転送要求を 1 つの分離された入出力ワーカスレッドにすることで、 忙しいサーバには役に立つことがあります。

非ブロッキング入出力用に指定されたソケットを使用するときに、 sendfile() は要求されたよりも少ないバイトを送信することがあります。 この場合、正常に書き込まれたバイト数が *sbytes (指定されている場合) に返され、エラー EAGAIN が返されます。

sendfile() の FreeBSD での実装は「0 コピー」です。 すなわち、ファイルデータのコピーが回避されるように最適化されています。

The sendfile function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

[EBADF]
	fd 引数が有効なファイル記述子ではありません。
[EBADF]
	s 引数が有効なソケット記述子ではありません。
[EBUSY]
	完全な転送を完了するにはディスク入出力が必要となるため、中断されました。 部分的なデータは送られたかもしれません (このエラーは SF_NODISKIO が指定されたときのみ起こります)。
[ENOTSOCK]
	s 引数がソケットではありません。
[EINVAL]
	fd 引数が通常のファイルではありません。
[EINVAL]
	s 引数が SOCK_STREAM 型のソケットではありません。
[EINVAL]
	offset 引数が負です。
[ENOTCONN]
	s 引数が、未接続のソケットを指しています。
[EPIPE]
	通信相手が接続を閉じてしまいました。
[EIO]	fd から読取り中に入出力エラーが発生しました。
[EFAULT]
	引数について無効なアドレスが指定されました。
[EINTR]
	sendfile() が完了する前にシグナルが割り込みました。 *sbytes が指定された場合には、成功裏に送出されたバイト数がここに格納されます。
[EAGAIN]
	ソケットは非ブロッキング入出力と指定されており、ソケットバッファが 満杯であるためにすべてのデータが送信されませんでした。 sbytes が指定された場合、送信が正常に完了したバイト数が *sbytes 内に返されます。

sendfile() システムコールは、 FreeBSD 3.0 ではじめて登場しました。 このマニュアルページは FreeBSD 3.1 ではじめて登場しました。

sendfile() システムコールとこのマニュアルページは David G. Lawrence <dg@dglawrence.com> が作成しました。