# eio_fallocate

(PECL eio >= 0.0.1dev)

eio_fallocate — Permitir al llamador manipular directamente el espacio de disco asignado a un fichero

### Descripción

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

eio_fallocate() permite al llamador manipular directamente el espacio de disco asignado al fichero especificado por el descriptor de fichero `fd` para el rango de bytes empezando por `offset` y continuando `length` bytes.

> Nota: El fichero debería abrirse para lectura

> Se debería usar OR entre `EIO_O_CREAT` y `EIO_O_WRONLY` o `EIO_O_RDWR`

### Parámetros

`fd`

  Un flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej., devuelto por eio_open().

`mode`

  Actualmente sólo está soportada una bandera para el modo: `EIO_FALLOC_FL_KEEP_SIZE` (lo mismo que la constante POSIX `FALLOC_FL_KEEP_SIZE`).

`offset`

  Especifica el inicio del rango de bytes.

`length`

  Especifica la longitud del rango de bytes.

`pri`

  La prioridad de petición: `EIO_PRI_DEFAULT`, `EIO_PRI_MIN`, `EIO_PRI_MAX`, o `null`. Si se pasa `null`, `pri` es establecido internamente a `EIO_PRI_DEFAULT`.

`callback`

  La función `callback` es llamada cuando la petición está hecha. Debería seguir el siguiente prototipo:

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

    son datos personalizados pasados a la petición.

  `result`

    es el valor del resultado específico de la petición; básicamente, el valor devuelto por la correspondiente llamada al sistema.

  `req`

    es el recurso de petición opcional que puede usarse con funciones como eio_get_last_error()

`data`

  Variable arbitraria pasada a `callback`.

### Valores devueltos

eio_fallocate() devuelve un recurso de petición en caso de éxito, o `false` en caso de error.