(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 la petición: EIO_PRI_DEFAULT
, EIO_PRI_MIN
, EIO_PRI_MAX
, o null
.
Si null
es pasado, el parámetro pri
, internamente, es definido a
EIO_PRI_DEFAULT
.
callback
La función de retrollamada callback
es llamada cuando la petición está terminada.
Debe corresponder al siguiente prototipo:
void callback(mixed $data, int $result[, resource $req]);
data
representa los datos personalizados pasados a la petición.
result
representa el valor resultante específico de la petición; básicamente, el valor retornado por la llamada al sistema correspondiente.
req
es el recurso opcional de la petición que puede ser utilizado 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
si ocurre un error.