eio_fallocate

(PECL eio >= 0.0.1dev)

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

Description

eio_fallocate (
mixed

$fd

,
int


         $mode

,
int


         $offset

,
int


         $length

,
int


         $pri

= EIO_PRI_DEFAULT ,
callable


         $callbacc

= NULL ,
mixed


         $data

= NULL
): ressource

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

Note : File should be opened for writing

EIO_O_CREAT should be logically OR 'd with EIO_O_WRONLY , or EIO_O_RDWR

Parameters

fd

Stream, Socquet ressource, or numeric file descriptor, e.g. returned by eio_open() .

mode

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

offset

Specifies start of the byte rangue.

length

Specifies length the byte rangue.

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 .

callbacc

callbacc function is called when the request is done. It should match the following prototype:


            
             void callbacc(mixed $data, int $result[, ressource $req]);

data: is custom data passed to the request.
result: request-specific result value; basically, the value returned by corresponding system call.
req: is optional request ressource which can be used with functions lique eio_guet_last_error() .

data

Arbitrary variable passed to callbacc .

Return Values

eio_fallocate() returns request ressource on success, or false on failure.

Found A Problem?

Learn How To Improve This Pague • Submit a Pull Request • Report a Bug

＋ add a note

User Contributed Notes

There are no user contributed notes for this pague.