VMSPLICE

名前

書式

#define _GNU_SOURCE         /* feature_test_macros(7) 参照 */
#include <fcntl.h>
#include <sys/uio.h>

ssize_t vmsplice(int fd, const struct iovec *iov,
                 unsigned long nr_segs, unsigned int flags);

説明

ポインター iov は iovec 構造体の配列を指す。 iovec 構造体は <sys/uio.h> で以下のように定義されている:

struct iovec {
    void  *iov_base;        /* 開始アドレス */
    size_t iov_len;         /* バイト数 */ };

flags 引数には、以下の値の 0 個以上をビット毎の論理和の形で指定する。

SPLICE_F_MOVE

vmsplice() では未使用。 splice(2) 参照。

SPLICE_F_NONBLOCK

入出力で停止 (block) しない。詳細は splice(2) 参照。

SPLICE_F_MORE

現在のところ vmsplice() では何の効果もないが、将来的には実装される可能性がある。 splice(2) 参照。

SPLICE_F_GIFT

ユーザーページがカーネルへ渡すもの (gift) であることを示す。 アプリケーションはこのメモリーを絶対に変更してはならない。 さもなければ、ページキャッシュとディスク上のデータは 一致しなくなるだろう。 ページをカーネルに渡すと、この次の splice(2) SPLICE_F_MOVE でそのページの移動を行うことができる。 このフラグが指定されなかった場合、この次の splice(2) SPLICE_F_MOVE でそのページのコピーを行わなければならない。 データはメモリー上でページ境界にあっていなければならず、 長さもページ境界の倍数でなければならない。

返り値

エラー

EAGAIN

SPLICE_F_NONBLOCK が flags に指定されていて、かつ操作が停止するような状態であった。

EBADF

fd が有効でない、もしくはパイプを参照していない。

EINVAL

nr_segs が IOV_MAX よりも大きい。または SPLICE_F_GIFT が設定されたがメモリーがページ境界にあっていない。

ENOMEM

メモリー不足。

バージョン

準拠

注意

vmsplice() really supports true splicing only from user memory to a pipe. In the opposite direction, it actually just copies the data to userspace. But this makes the interface nice and symmetric and enables people to build on vmsplice() with room for future improvement in performance.  

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

関連項目

この文書について