(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 petición: EIO_PRI_DEFAULT
, EIO_PRI_MIN
, EIO_PRI_MAX
, o null
.
Si se pasa null
, pri
es establecido internamente a
EIO_PRI_DEFAULT
.
callback
La función callback
es llamada cuando la petición está hecha.
Debería seguir el siguiente prototipo:
void callback(mixed $data, int $result[, resource $req]);
data
son datos personalizados pasados a la petición.
result
es el valor del resultado específico de la petición; básicamente, el valor devuelto por la correspondiente llamada al sistema.
req
es el recurso de petición opcional que puede usarse 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
en caso de error.