eio_fallocate
(PECL eio >= 0.0.1dev)
eio_fallocate — Allows the caller to directly manipulate the allocated disk space for a file
説明
$fd
, int $mode
, int $offset
, int $length
[, int $pri = EIO_PRI_DEFAULT
[, callable $callback = NULL
[, mixed $data = NULL
]]] )
eio_fallocate() allows the caller to directly manipulate the allocated disk space for the
file specified by fd file descriptor for the byte
range starting at offset and continuing for
length bytes.
注意: File should be opened for writing
EIO_O_CREATshould be logically OR'd withEIO_O_WRONLY, orEIO_O_RDWR
パラメータ
-
fd -
The file descriptor, e.g. returned by eio_open().
-
mode -
Currently only one flag is supported for mode:
EIO_FALLOC_FL_KEEP_SIZE(the same as POSIX constantFALLOC_FL_KEEP_SIZE). -
offset -
Specifies start of the byte range.
-
length -
Specifies length the byte range.
-
pri -
リクエストの優先順位。
EIO_PRI_DEFAULT、EIO_PRI_MIN、EIO_PRI_MAXあるいはNULLを指定します。NULLを渡した場合、priは内部的にEIO_PRI_DEFAULTとなります。 -
callback -
callback関数が、リクエスト終了時にコールされます。 この関数のプロトタイプは、に一致しなければなりません。void callback($data, $result);$dataは、リクエストに渡すカスタムデータです。$resultにはリクエスト固有の結果が格納されます。基本的には、対応するシステムコールが返すそのままの値となります。 -
data -
Arbitrary variable passed to
callback.
返り値
eio_fallocate() returns request resource on success or FALSE on error.
