eio_fallocate

(PECL eio >= 0.0.1dev)

eio_fallocate — Allows the caller to directly manipulate the allocated disk space for a file

Опис

function eio_fallocate(
    mixed $fd,
    int $mode,
    int $offset,
    int $length,
    int $pri = EIO_PRI_DEFAULT,
    callable $callback = NULL,
    mixed $data = NULL
): resource

eio_fallocate() allows the caller to directly manipulate the allocated disk space for the file specified by fd file descriptor for the byte range starting at offset and continuing for length bytes.

Зауваження: File should be opened for writing
EIO_O_CREAT should be logically OR'd with EIO_O_WRONLY, or EIO_O_RDWR

Параметри

fd

Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open().

mode

Currently only one flag is supported for mode: EIO_FALLOC_FL_KEEP_SIZE (the same as POSIX constant FALLOC_FL_KEEP_SIZE).

offset

Specifies start of the byte range.

length

Specifies length of the byte range.

pri

Пріоритет запиту: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX або null. Якщо параметру pri задано значення null, то пріоритетом буде EIO_PRI_DEFAULT.

callback

Функція callback викликається після виконання запиту. Вона має відповідати наступному шаблону:

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

data: Користувацькі дані, що будуть в запиті.
result: Значення результату, що стосується запиту; повертається системним викликом.
req: Необов'язковий ресурс запиту, який використовують з такими функціями, як eio_get_last_error().

data

Arbitrary variable passed to callback.

Значення, що повертаються

eio_fallocate() returns request resource on success, або false в разі помилки.