(PECL eio >= 0.0.1dev)
eio_fallocate — Permite ao chamador manipular diretamente o espaço alocado em disco para um arquivo
$fd
,$mode
,$offset
,$length
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULL
eio_fallocate() permite ao chamador manipular diretamente o espaço alocado
em disco para o arquivo especificado elo descrito de arquivo fd
para o
intervalo de byte iniciando em offset
e continuando pelo númer de bytes
informado em length
.
Nota: O arquivo deve ser aberto para escrita
EIO_O_CREAT
deve ser combinado através de uma operação lógica OR comEIO_O_WRONLY
ouEIO_O_RDWR
fd
Fluxo, recurso de socket ou descritor numérico de arquivo, por exemplo, retornado por eio_open().
mode
Atualmente apenas uma opção de modo é suportada:
EIO_FALLOC_FL_KEEP_SIZE
(o mesmo que a constante POSIX
FALLOC_FL_KEEP_SIZE
).
offset
Especifica o início do intervalo de bytes.
length
Especifica o comprimento do intervalo de bytes.
pri
A prioridade da requisição: EIO_PRI_DEFAULT
, EIO_PRI_MIN
, EIO_PRI_MAX
ou null
.
Se null
for passado, o parâmetro pri
internamente será definido como
EIO_PRI_DEFAULT
.
callback
A função callback
é chamada quando a requisição é concluída.
Ela deve corresponder ao seguinte protótipo:
void callback(mixed $data, int $result[, resource $req]);
data
são dados personalizados passados para a requisição.
result
valor de resultado específico da requisição; basicamente, o valor retornado pela chamada de sistema correspondente.
req
é um recurso de requisição opcional que pode ser usado com funções como eio_get_last_error().
data
Variável arbitrária passada para callback
.
eio_fallocate() retorna o recurso da requisição em caso de sucesso, ou false
em caso de falha.