php man page for eio_fallocate

EIO_FALLOCATE(3)							 1							  EIO_FALLOCATE(3)

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

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

DESCRIPTION
       eio_fallocate(3) 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.

       Note

	      File should be opened for writing

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

PARAMETERS
	      o $fd
		- Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open(3).

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

	      o $offset
		- Specifies start of the byte range.

	      o $length
		- Specifies length the byte range.

	      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_fallocate(3) returns request resource on success or FALSE on error.

PHP Documentation Group 													  EIO_FALLOCATE(3)