LSEEK(2)

NAME
lseek - reposiciona el puntero de lectura/escritura de un fichero

SYNOPSIS
#include <unistd.h>

off_t lseek(int fildes, off_t offset, int whence);

DESECRIPCION
La funcion lseek reposiciona el puntero del descriptor de fichero fildes con el argumento offset de acuerdo con la directiva whence. El argumento fildes debe ser un descriptor de fichero abierto. Lseek reposiciona el puntero del fichero fildes de la manera siguiente:

    Si whence es SEEK_SET, el puntero es colocado a offset bytes. Si whence es SEEK_CUR, el numero de bytes indicado en offset se suma a la direccion actual. Si whence es SEEK_END, el puntero es colocado al final del fichero mas el offset en bytes.
la funcion lseek permite colocar el puntero del fichero despues del final de fichero dentro de ese espacio devuelven ceros(hasta que se escriban datos dentro de ese espacio). Algunos dispositivos son incapaces de buscar. El valor del puntero asociado a ese dispositivo es indefinido .

VALORES RETORNADOS
En el caso de una correcta ejecucion, lseek devuelve la posicion del puntero resultante medida en bytes desde el principio del fichero. Si se produce un error, se devuelve el valor -1 y en errno se coloca el tipo de error.

ERRORES

EBADF
    Fildes no es un descriptor de fichero abierto.

ESPIPE
    Fildes es asociado a una tuberia, socket, o FIFO.

EINVAL
    Whence no es un valor adecuado.

DE ACUERDO CON
SVr4, POSIX, BSD 4.3

BUGS
La utilizacion de whence en este documento es incorrecta en ingles, pero se usa por motivos historicos

VER TAMBIEN
dup(2), open(2), fseek(3)