Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

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  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 octets nul (« \0 »)
       jusqu'à ce que d'autres données y soient écrites.

VALEUR RENVOYÉE

       lseek(),  si  elle  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 bien la
              position  demandée  serait  négative,  ou  après  la  fin   d'un
              périphérique.

       EOVERFLOW
              La  position résultante dans le fichier ne peut être représentée
              dans 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 ici ne correspond  pas  à  une  utilisation
       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 quels périphériques doivent gérer 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 macros suivantes :

       ancien   nouveau
       0        SEEK_SET
       1        SEEK_CUR
       2        SEEK_END
       L_SET    SEEK_SET
       L_INCR   SEEK_CUR
       L_XTND   SEEK_END

       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)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.32 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'équipe   de   traduction
       francophone       au       sein        du        projet        perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>   (2003-2006).   Julien
       Cristau et l'équipe francophone de traduction de Debian (2006-2009).

       Veuillez   signaler   toute   erreur   de   traduction  en  écrivant  à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « man -L C <section> <page_de_man> ».