(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
, если возникла ошибка.