eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_range — Sync a file segment with disk

Beschreibung

eio_sync_file_range(
    mixed $fd,
    int $offset,
    int $nbytes,
    int $flags,
    int $pri = EIO_PRI_DEFAULT,
    callable $callback = NULL,
    mixed $data = NULL
): resource

eio_sync_file_range() permits fine control when synchronizing the open file referred to by the file descriptor fd with disk.

Parameter-Liste

fd

File descriptor

offset

The starting byte of the file range to be synchronized

nbytes

Specifies the length of the range to be synchronized, in bytes. If nbytes is zero, then all bytes from offset through to the end of file are synchronized.

flags

A bit-mask. Can include any of the following values: EIO_SYNC_FILE_RANGE_WAIT_BEFORE, EIO_SYNC_FILE_RANGE_WRITE, EIO_SYNC_FILE_RANGE_WAIT_AFTER. These flags have the same meaning as their SYNC_FILE_RANGE_* counterparts(see SYNC_FILE_RANGE(2) man page).

pri

The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or null. If null passed, pri internally is set to EIO_PRI_DEFAULT.

callback

Die callback-Funktion wird aufgerufen, wenn die Anfrage abgeschlossen ist. Sie muss dem folgenden Prototyp entsprechen:

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

data: sind die benutzerdefinierten Daten, die an die Anfrage übergeben werden.
result: der anfragespezifische Ergebniswert; im Grunde der Wert, der vom entsprechenden Systemaufruf zurückgegeben wird.
req: ist eine optionale Anfrage-Ressource, die in Funktionen wie eio_get_last_error() verwendet werden kann

data

Arbitrary variable passed to callback.

Rückgabewerte

eio_sync_file_range() returns request resource on success,Bei einem Fehler wird false zurückgegeben..

add a note

User Contributed Notes

There are no user contributed notes for this page.