# eio_fallocate

(PECL eio >= 0.0.1dev)

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

### Beschreibung

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.

> Hinweis: File should be opened for writing

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

### Parameter-Liste

`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 the byte range.

`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`.

`callback`

  Die `callback`-Funktion wird aufgerufen, wenn die Anfrage abgeschlossen ist. Sie muss dem folgenden Prototyp entsprechen:

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

    sind die benutzerdefinierten Daten, die an die Anfrage übergeben werden.

  `result`

    der anfragespezifische Ergebniswert; im Grunde der Wert, der vom entsprechenden Systemaufruf zurückgegeben wird.

  `req`

    ist eine optionale Anfrage-Ressource, die in Funktionen wie eio_get_last_error() verwendet werden kann.

`data`

  Arbitrary variable passed to `callback`.

### Rückgabewerte

eio_fallocate() returns request resource on success,Bei einem Fehler wird `false` zurückgegeben..

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open