(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
= NULLeio_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.