eio_sync_file_range - Синхронизирует сегмент файла с данными файла на внешнем хранилище
Вернуться к: Eio Функции
eio_sync_file_range
(PECL eio >= 0.0.1dev)
eio_sync_file_range — Синхронизирует сегмент файла с данными файла на внешнем хранилище
Описание
$fd
, int $offset
, int $nbytes
, int $flags
[, int $pri
= EIO_PRI_DEFAULT
[, callable $callback
= NULL
[, mixed $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
в случае ошибки.
Вернуться к: Eio Функции