eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_range — Sincornizar un segmento de fichero con el disco

Descripción

resource eio_sync_file_range ( mixed $fd , int $offset , int $nbytes , int $flags [, int $pri = EIO_PRI_DEFAULT [, callable $callback = NULL [, mixed $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.

Parámetros

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.

Valores devueltos

eio_sync_file_range() devuelve un recurso de petición en caso de éxito o FALSE en caso de error.