NOM

       lseek64 - Positionner la tête de lecture/écriture dans un fichier (version 64 bits)

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #define _LARGEFILE64_SOURCE     /* Consultez feature_test_macros(7) */
       #include <sys/types.h>
       #include <unistd.h>

       off64_t lseek64(int fd, off64_t décalage, int origine_décalage);

DESCRIPTION

       Les  fonctions  de  la famille lseek() repositionnent la tête de lecture du fichier ouvert
       associé au descripteur de fichier fd à décalage octets relativement au début du fichier, à
       la  position  actuelle ou à la fin du fichier lorsque origine_décalage a respectivement la
       valeur SEEK_SET, SEEK_CUR ou SEEK_END.

       Pour plus de détails sur les valeurs renvoyées et les erreurs, consultez lseek(2).

       Quatre interfaces sont disponibles : lseek(), lseek64(), llseek() et _llseek().

   lseek()
       Prototype :

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

       La fonction enveloppe de la bibliothèque C lseek() utilise le type off_t.  C'est  un  type
       signé 32 bits pour les architectures 32 bits, à moins que l'on compile avec

           #define _FILE_OFFSET_BITS 64

       auquel cas c'est un type signé 64 bits.

   lseek64()
       Prototype :

           off64_t lseek64(int fd, off64_t décalage, int origine_décalage);

       La  fonction  de  bibliothèque lseek64() utilise un type 64 bits même si off_t est un type
       32 bits. Son prototype (et le type off64_t) n'est disponible que lorsqu'on compile avec

           #define _LARGEFILE64_SOURCE

       La fonction lseek64() est disponible depuis la glibc 2.1.

   llseek()
       Prototype :

           loff_t llseek(int fd, loff_t décalage, int origine_décalage);

       Le type loff_t est un type  signé  64 bits.  La  fonction  de  bibliothèque  llseek()  est
       disponible  dans  la  glibc  et  fonctionne  sans  définition particulière. Cependant, les
       en-têtes de la glibc ne proposent pas de prototype. Les utilisateurs doivent donc  ajouter
       le prototype ci-dessus, ou quelque chose d'équivalent, dans leurs propres sources. Lorsque
       des utilisateurs se sont plaints à propos de pertes de  données  à  cause  d'une  mauvaise
       compilation  de e2fsck(8), la glibc 2.1.3 a ajouté un avertissement au moment de l'édition
       de liens

           "la fonction llseek peut être dangereuse ; utilisez lseek64 à la place."

       Cela fait que cette fonction est inutilisable si l'on souhaite une compilation  vierge  de
       tout avertissement.

       Depuis  la version 2.28 de la glibc, ce symbole de fonction n'est plus disponible pour les
       applications nouvellement liées.

   _llseek()
       Sur les architectures 32 bits, c'est l'appel système qui est  utilisé  par  les  fonctions
       enveloppes  de  la  bibliothèque C  pour  implémenter  toutes les fonctions ci-dessus. Son
       prototype est :

           int _llseek(int fd, off_t décalage_haut, off_t décalage_bas,
                       loff_t *résultat, int origine_décalage);

       Pour plus de détails, consultez llseek(2).

       Les systèmes 64 bits n'ont pas besoin de l'appel système _llseek(). Ils peuvent  en  effet
       utiliser l'appel système lseek(2) qui prend en charge les décalages de fichier 64 bits.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │Interface                                               │ Attribut             │ Valeur  │
       ├────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │lseek64()                                               │ Sécurité des threads │ MT-Safe │
       └────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

NOTES

       lseek64() est une des fonctions définies dans la spécification LFS (Large File Summit) qui
       a été achevée en 1996. Cette spécification avait pour but de fournir une prise  en  charge
       transitionnelle  qui  devait permettre aux applications sur des systèmes 32 bits d'accéder
       aux fichiers dont la taille dépassait la valeur qui pouvait être représentée par  le  type
       off_t  32 bits. Comme indiqué plus haut, ce symbole est exposé par les fichiers d'en-têtes
       si  la  macro  de  test  de  fonctionnalité  _LARGEFILE64_SOURCE  est  elle-même  définie.
       Alternativement,  sur  un système 32 bits, le symbole lseek devient un alias de lseek64 si
       la macro _FILE_OFFSET_BITS est définie avec la valeur 64.

VOIR AUSSI

       llseek(2), lseek(2)

TRADUCTION

       La traduction française de cette  page  de  manuel  a  été  créée  par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>, Thierry
       Vignaud <tvignaud@mandriva.com>, François Micaux, Alain  Portal  <aportal@univ-montp2.fr>,
       Jean-Philippe    Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-
       luc.coulon@wanadoo.fr>,   Julien    Cristau    <jcristau@debian.org>,    Thomas    Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,  Denis
       Barbier   <barbier@debian.org>,   David   Prévot  <david@tilapin.org>,  Frédéric  Hantrais
       <fhantrais@gmail.com> et Lucien Gentis <lucien.gentis@waika9.com>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.