eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_range — Sync a file segment with disk

Descrição

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() permits fine control when synchronizing the open file referred to by the file descriptor fd with disk.

Parâmetros

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

A prioridade de requisição: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, ou NULL. Se NULL for passado, pri será internamente configurado para EIO_PRI_DEFAULT.

callback

A função callback é chamada quando a requisição for finalizada. Ela deve seguir o seguinte protótipo:


void callback($data, $result);

$data são dados customizados passados para a requisição. $result contém resultados específicas à requisição; basicamente, o valor retornado pela chamada de sistema correspondente.

data

Arbitrary variable passed to callback.

Valor Retornado

eio_sync_file_range() returns request resource on success or FALSE on error.