(PECL eio >= 0.0.1dev)
eio_sync_file_range — Синхронизирует сегмент файла с данными файла на внешнем хранилище
$fd
,$offset
,$nbytes
,$flags
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULL
eio_sync_file_range() осуществляет необходимые проверки
и действия при синхронизации открытого файла fd
с дисковой подсистемой.
fd
Файловый описатель
offset
Начальная позиция, с которой будет проводиться синхронизация
nbytes
Задаёт длину сегмента файла в байтах, которую необходимо синхронизировать.
Если nbytes
равно нулю, будут синхронизированы все
данные от offset
до конца файла.
flags
Битовая маска. Может включать комбинацию из следующих значений:
EIO_SYNC_FILE_RANGE_WAIT_BEFORE
,
EIO_SYNC_FILE_RANGE_WRITE
,
EIO_SYNC_FILE_RANGE_WAIT_AFTER
. Эти флаги имеют то же
предназначение, что и аналогичные SYNC_FILE_RANGE_*
константы (смотрите страницу руководства SYNC_FILE_RANGE(2)
).
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
Данные, которые необходимо передать функции callback
.
eio_sync_file_range() возвращает ресурс запроса в случае успешного выполнения или false
в случае возникновения ошибки.