(PECL eio >= 0.0.1dev)
eio_sync_file_range — Synchronise un segment de fichier avec le disque
$fd
,$offset
,$nbytes
,$flags
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$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
.
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
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()
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.