(PECL eio >= 0.0.1dev)
eio_sync_file_range — Synchronise un segment de fichier avec le disque
$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.
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.
eio_sync_file_range() retourne la ressource demandée,
en cas de succès, ou FALSE si une erreur survient.