eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_range — Synchronise un segment de fichier avec le disque

Description

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() permet un contrôle fin lors de la synchronisation d'un fichier ouvert spécifié par le descripteur de fichier fd avec le disque.

Liste de paramètres

fd

Le descripteur de fichier.

offset

La position de début d'intervalle à partir de laquelle la synchronisation doit s'effectuer.

nbytes

Spécifie la longueur de l'intervalle à synchroniser, en octets. Si nbytes vaut zéro, alors tous les octets depuis la position offset jusqu'à la fin du fichier seront synchronisés.

flags

Un masque. Peut inclure n'importe quelle valeur suivante : EIO_SYNC_FILE_RANGE_WAIT_BEFORE, EIO_SYNC_FILE_RANGE_WRITE, EIO_SYNC_FILE_RANGE_WAIT_AFTER. Ces drapeaux ont la même signification que leurs équivalents SYNC_FILE_RANGE_* (voir la page du manuel sur SYNC_FILE_RANGE(2)).

pri

La priorité de la requête : EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, ou NULL. Si NULL est passé, le paramètre pri, en interne, est défini à EIO_PRI_DEFAULT.

data: représente les données personnalisées passées à la requête.
result: représente la valeur résultante spécifique à la requête ; basiquement, la valeur retournée par l'appel système correspondant.
req: est la ressource optionnelle de la requête qui peut être utilisée avec les fonctions comme eio_get_last_error()

callback

La fonction de rappel callback est appelée lorsque la requête est terminée. Elle doit correspondre au prototype suivant :


void callback(mixed $data, int $result[, resource $req]);

data

Variables arbitraires à passer à la fonction de rappel callback.

Valeurs de retour

eio_sync_file_range() retourne la ressource demandée, en cas de succès, ou FALSE si une erreur survient.