(PECL eio >= 0.0.1dev)
eio_fallocate — Permitir al llamador manipular directamente el espacio de disco asignado a un fichero
$fd
,$mode
,$offset
,$length
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULL
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
yEIO_O_WRONLY
oEIO_O_RDWR
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
.
eio_fallocate() devuelve un recurso de petición en caso de éxito, o false
en caso de error.