EIO_SYNC_FILE_RANGE(3) 1 EIO_SYNC_FILE_RANGE(3)
eio_sync_file_range - Sync a file segment with disk
SYNOPSIS
resource eio_sync_file_range (mixed $fd, int $offset, int $nbytes, int $flags, [int $pri = EIO_PRI_DEFAULT], [callable $callback =
NULL], [mixed $data = NULL])
DESCRIPTION
eio_sync_file_range(3) permits fine control when synchronizing the open file referred to by the file descriptor $fd with disk.
PARAMETERS
o $fd
- File descriptor
o $offset
- The starting byte of the file range to be synchronized
o $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.
o $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).
o $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.
o $callback
-$callback function is called when the request is done. It should match the following prototype:
void callback(mixed $data, int $result[, resource $req]);
o $data
-is custom data passed to the request.
o $result
-request-specific result value; basically, the value returned by corresponding system call.
o $req
-is optional request resource which can be used with functions like eio_get_last_error(3)
o $data
- Arbitrary variable passed to $callback.
RETURN VALUES
eio_sync_file_range(3) returns request resource on success or FALSE on error.
PHP Documentation Group EIO_SYNC_FILE_RANGE(3)
