(PECL eio >= 0.0.1dev)
eio_sync_file_range — Sync a file segment with disk
$fd
, int $offset
, int $nbytes
, int $flags
[, int $pri
= EIO_PRI_DEFAULT
[, callable $callback
= NULL
[, mixed $data
= NULL
]]] )
eio_sync_file_range() permits fine control when synchronizing the open file referred to by the file
descriptor fd
with disk.
fd
File descriptor
offset
The starting byte of the file range to be synchronized
nbytes
Specifies the length of the range to be synchronized, in bytes. If
nbytes
is zero, then all bytes from offset
through
to the end of file are synchronized.
flags
A bit-mask. Can include any of the following values:
EIO_SYNC_FILE_RANGE_WAIT_BEFORE
,
EIO_SYNC_FILE_RANGE_WRITE
,
EIO_SYNC_FILE_RANGE_WAIT_AFTER
. These flags have
the same meaning as their SYNC_FILE_RANGE_*
counterparts(see SYNC_FILE_RANGE(2) man page).
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_sync_file_range() returns request resource on success or FALSE
on error.