(PECL eio >= 0.0.1dev)
eio_sync_file_range — Sincornizar un segmento de fichero con el disco
$fd
,$offset
,$nbytes
,$flags
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULL
eio_sync_file_range() permite un control preciso al sincronizar el fichero abierto mencionado por el descriptor
de fichero fd
con el disco.
fd
El descriptor de fichero
offset
El byte de inicio del rango del archivo a ser sincronizado
nbytes
Especifica la longitud del rango a ser sincronizado, en bytes. Si
nbytes
es cero, son sicronizados todos los bytes desde
offset
hasta el final del fichero.
flags
Una máscara de bits. Puede incluir cualquiera de los siguientes valores:
EIO_SYNC_FILE_RANGE_WAIT_BEFORE
,
EIO_SYNC_FILE_RANGE_WRITE
,
EIO_SYNC_FILE_RANGE_WAIT_AFTER
. Estas banderas tienen
el mismo significado que sus homónimas SYNC_FILE_RANGE_*
(véase la página del manual SYNC_FILE_RANGE(2)
).
pri
La prioridad de la petición: EIO_PRI_DEFAULT
, EIO_PRI_MIN
, EIO_PRI_MAX
, o null
.
Si null
es pasado, el parámetro pri
, internamente, es definido a
EIO_PRI_DEFAULT
.
callback
La función de retrollamada callback
es llamada cuando la petición está terminada.
Debe corresponder al siguiente prototipo:
void callback(mixed $data, int $result[, resource $req]);
data
representa los datos personalizados pasados a la petición.
result
representa el valor resultante específico de la petición; básicamente, el valor retornado por la llamada al sistema correspondiente.
req
es el recurso opcional de la petición que puede ser utilizado con funciones como eio_get_last_error().
data
Variable arbitraria pasada a callback
.
eio_sync_file_range() devuelve un recurso de petición en caso de éxito, o false
si ocurre un error.