(PECL eio >= 0.0.1dev)
eio_fallocate — Permitir al llamador manipular directamente el espacio de disco asignado a un fichero
$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_CREATyEIO_O_WRONLYoEIO_O_RDWR
fdUn flujo, un recurso Socket, o un descriptor numérico de fichero, p.ej., devuelto por eio_open().
modeActualmente sólo está soportada una bandera para el modo:
EIO_FALLOC_FL_KEEP_SIZE (lo mismo que la constante POSIX
FALLOC_FL_KEEP_SIZE).
offsetEspecifica el inicio del rango de bytes.
lengthEspecifica la longitud del rango de bytes.
priLa 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]);
datason datos personalizados pasados a la petición.
resultes el valor del resultado específico de la petición; básicamente, el valor devuelto por la correspondiente llamada al sistema.
reqes el recurso de petición opcional que puede usarse con funciones como eio_get_last_error()
data
Variable arbitraria pasada a callback.
eio_fallocate() devuelve un recurso de petición en caso de éxito o FALSE en caso de error.