eio_fallocate
(PECL eio >= 0.0.1dev)
eio_fallocate — Allows the caller to directly manipulate the allocated disk space for a file
說明
mixed
$fd,int
$mode,int
$offset,int
$length,int
$pri = EIO_PRI_DEFAULT,callable
$callback = NULL,mixed
$data = NULL): resource
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 -
Stream, Socket resource, or numeric 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(mixed $data, int $result[, resource $req]);-
data -
傳遞給請求的用戶數據。
-
result -
針對請求的結果的值。通常是相應的系統呼叫返回的值。
-
req -
可選的請求資源，可被 eio_get_last_error() 之類的函式使用。
-
-
data -
Arbitrary variable passed to
callback.
返回值
eio_fallocate() returns request resource on success, 或者在失敗時返回 false.