(PECL eio >= 0.0.1dev)
eio_sync_file_range — Sincornizar un segmento de fichero con el disco
$fd
, int $offset
, int $nbytes
, int $flags
[, int $pri = EIO_PRI_DEFAULT
[, callable $callback = NULL
[, mixed $data = NULL
]]] ) : resource
eio_sync_file_range() permite un control preciso al sincronizar el fichero abierto mencionado por el descriptor
de fichero fd con el disco.
fdEl descriptor de fichero
offsetEl 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)).
priLa 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]);
datason datos personalizados pasados a la petición.
resultes el valor del resultado específico de la petición; básicamente, el valor devuelto por la correspondiente llamada al sistema.
reqes 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.