LSEEK

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 24 septembre 2001
Index Menu principal  

NOM

lseek - Positionner la tête de lecture/écriture dans un fichier  

SYNOPSIS

#include <sys/types.h>
#include <unistd.h>

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

DESCRIPTION

La fonction lseek() place la tête de lecture/écriture à la position offset dans le fichier ouvert associé au descripteur fd en suivant la directive whence ainsi :
SEEK_SET
La tête est placée à offset octets depuis le début du fichier.
SEEK_CUR
La tête de lecture/écriture est avancée de offset octets.
SEEK_END
La tête est placée à la fin du fichier plus offset octets.

La fonction lseek() permet de placer la tête au-delà de la fin actuelle du fichier (mais cela ne modifie pas la taille du fichier). Si des données sont écrites à cet emplacement, une lecture ultérieure de l'espace intermédiaire (un « trou ») retournera des zéros (« \0 ») jusqu'à ce que d'autres données y soient écrites.  

VALEUR RENVOYÉE

lseek(), s'il réussit, renvoie le nouvel emplacement, mesuré en octets depuis le début du fichier. En cas d'échec, la valeur (off_t) -1 est renvoyée, et errno contient le code d'erreur.  

ERREURS

EBADF
fd n'est pas un descripteur de fichier ouvert.
EINVAL
whence n'est ni SEEK_SET, ni SEEK_CUR, ni SEEK_END, ou la tête de lecture serait négative, ou serait après la fin du périphérique.
EOVERFLOW
La tête de lecture ne peut pas être représentée sur un off_t.
ESPIPE
fd est associé à un tube (pipe), une socket, ou une file FIFO.
 

CONFORMITÉ

SVr4, BSD 4.3, POSIX.1-2001.  

NOTES

L'utilisation du mot whence n'est pas correcte en anglais mais ce mot est conservé pour des raisons historiques.

Certains périphériques ne permettent pas de positionnement direct, POSIX ne précise pas quels périphériques doivent accepter lseek().

Sous Linux, l'utilisation de lseek() sur un périphérique tty renvoie ESPIPE.

Lors de la conversion d'un ancien code, substituez les valeurs de whence par les constantes suivantes :
anciennouveau
0SEEK_SET
1SEEK_CUR
2SEEK_END
L_SETSEEK_SET
L_INCRSEEK_CUR
L_XTNDSEEK_END

SVr1-3 renvoie un long à la place d'un off_t, BSD renvoie un int.

Notez que les descripteurs de fichier dupliqués par dup(2) ou fork(2) partagent le même pointeur de position. Ainsi le déplacement sur de tels fichiers peut conduire à des problèmes d'accès concurrents.  

VOIR AUSSI

dup(2), fork(2), open(2), fseek(3), lseek64(3), posix_fallocate(3)  

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 octobre 1996 et révisée le 24 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 lseek ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 24 juin 2008