eio_fallocate

(PECL eio >= 0.0.1dev)

eio_fallocate — Позволяет напрямую управлять размером используемого дискового пространства для файла

Описание

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

eio_fallocate() позволяет напрямую управлять размером используемого дискового пространства для файла. Дескриптор файла указывается в параметре fd, размер определяется диапазоном в байтах, начиная от смещения offset и до length.

Замечание: Файл должен быть открытым для записи

EIO_O_CREAT OR (одна из констант EIO_O_WRONLY, EIO_O_RDWR

Список параметров

fd

Поток, указатель на сокет, или числовой дескриптор файла, например возвращённый eio_open().

mode

Доступен только один флаг: EIO_FALLOC_FL_KEEP_SIZE (то же самое, что FALLOC_FL_KEEP_SIZE в POSIX).

offset

Определяет смещение диапазона в байтах.

length

Определяет размер диапазона.

pri

Приоритет запросов: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, или null. Если передан null, то pri устанавливается в EIO_PRI_DEFAULT.

callback

Функция callback вызывается при завершении запроса. Она должна удовлетворять следующему прототипу:

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

data: является пользовательскими данными, переданными в запросе.
result: содержит результирующее значение, зависящее от запроса; обычно это значение, возвращаемое соответствующим системным вызовом.
req: является опциональным запрашиваемым ресурсом, который может использоваться с такими функциями как eio_get_last_error()

data

Произвольная переменная, передаваемая в callback-функцию.

Возвращаемые значения

eio_fallocate() возвращает указатель на запрос в случае успешного выполнения или false в случае возникновения ошибки.

add a note

User Contributed Notes

There are no user contributed notes for this page.