.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2004 Andries Brouwer . .\" and Copyright (c) 2020 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH lseek64 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM lseek64 \- Positionner la tête de lecture/écriture dans un fichier (version 64\ bits) .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#define _LARGEFILE64_SOURCE\fP /* Consultez feature_test_macros(7) */ \fB#include \fP \fB#include \fP .PP \fBoff64_t lseek64(int \fP\fIfd\fP\fB, off64_t \fP\fIdécalage\fP\fB, int \fP\fIorigine_décalage\fP\fB);\fP .fi .SH DESCRIPTION Les fonctions de la famille \fBlseek\fP() repositionnent la tête de lecture du fichier ouvert associé au descripteur de fichier \fIfd\fP à \fIdécalage\fP octets relativement au début du fichier, à la position actuelle ou à la fin du fichier lorsque \fIorigine_décalage\fP a respectivement la valeur \fBSEEK_SET\fP, \fBSEEK_CUR\fP ou \fBSEEK_END\fP. .PP Pour plus de détails sur les valeurs renvoyées et les erreurs, consultez \fBlseek\fP(2). .PP .\" .\" For some background details, see: .\" https://lore.kernel.org/linux-man/CAKgNAkhNSWR3uYhYYaxx74fZfJ3JrpfAAPVrK0AFk_cAOUsbDg@mail.gmail.com/ .\" Quatre interfaces sont disponibles\ : \fBlseek\fP(), \fBlseek64\fP(), \fBllseek\fP() et \fB_llseek\fP(). .SS lseek() Prototype\ : .PP .in +4n .EX \fBoff_t lseek(int \fP\fIfd\fP\fB, off_t \fP\fIoffset\fP\fB, int \fP\fIwhence\fP\fB);\fP .EE .in .PP La fonction enveloppe de la bibliothèque\ C \fBlseek\fP() utilise le type \fIoff_t\fP. C'est un type signé 32\ bits pour les architectures 32\ bits, à moins que l'on compile avec .PP .in +4n .EX #define _FILE_OFFSET_BITS 64 .EE .in .PP auquel cas c'est un type signé 64\ bits. .SS lseek64() Prototype\ : .PP .in +4n .EX \fBoff64_t lseek64(int \fP\fIfd\fP\fB, off64_t \fP\fIdécalage\fP\fB, int \fP\fIorigine_décalage\fP\fB);\fP .EE .in .PP La fonction de bibliothèque \fBlseek64\fP() utilise un type 64\ bits même si \fIoff_t\fP est un type 32\ bits. Son prototype (et le type \fIoff64_t\fP) n'est disponible que lorsqu'on compile avec .PP .in +4n .EX #define _LARGEFILE64_SOURCE .EE .in .PP .\" in glibc 2.0.94, not in glibc 2.0.6 .\" La fonction \fBlseek64\fP() est disponible depuis la glibc\ 2.1. .SS llseek() Prototype\ : .PP .in +4n .EX \fBloff_t llseek(int \fP\fIfd\fP\fB, loff_t \fP\fIdécalage\fP\fB, int \fP\fIorigine_décalage\fP\fB);\fP .EE .in .PP Le type \fIloff_t\fP est un type signé 64\ bits. La fonction de bibliothèque \fBllseek\fP() 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 \fBe2fsck\fP(8), la glibc\ 2.1.3 a ajouté un avertissement au moment de l'édition de liens .PP .in +4n "la fonction \fBllseek\fP peut être dangereuse\ ; utilisez \fBlseek64\fP à la place." .in .PP Cela fait que cette fonction est inutilisable si l'on souhaite une compilation vierge de tout avertissement. .PP .\" glibc commit 5c5c0dd747070db624c8e2c43691cec854f114ef .\" Depuis la version\ 2.28 de la glibc, ce symbole de fonction n'est plus disponible pour les applications nouvellement liées. .SS _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\ : .PP .in +4n .EX \fBint _llseek(int \fP\fIfd\fP\fB, off_t \fP\fIdécalage_haut\fP\fB, off_t \fP\fIdécalage_bas\fP\fB,\fP \fB loff_t *\fP\fIrésultat\fP\fB, int \fP\fIorigine_décalage\fP\fB);\fP .EE .in .PP Pour plus de détails, consultez \fBllseek\fP(2). .PP .\" In arch/x86/entry/syscalls/syscall_32.tbl, .\" we see the following line: .\" .\" 140 i386 _llseek sys_llseek .\" .\" This is essentially telling us that 'sys_llseek' (the name generated .\" by SYSCALL_DEFINE5(llseek...)) is exposed to user-space as system call .\" number 140, and that system call number will (IIUC) be exposed in .\" autogenerated headers with the name "__NR__llseek" (i.e., "_llseek"). .\" The "i386" is telling us that this happens in i386 (32-bit Intel). .\" There is nothing equivalent on x86-64, because 64 bit systems don't .\" need an _llseek system call. Les systèmes 64\ bits n'ont pas besoin de l'appel système \fB_llseek\fP(). Ils peuvent en effet utiliser l'appel système \fBlseek\fP(2) qui prend en charge les décalages de fichier 64\ bits. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBlseek64\fP() T} Sécurité des threads MT\-Safe .TE .sp 1 .SH NOTES \fBlseek64\fP() 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 \fIoff_t\fP 32\ bits. Comme indiqué plus haut, ce symbole est exposé par les fichiers d'en\-têtes si la macro de test de fonctionnalité \fB_LARGEFILE64_SOURCE\fP est elle\-même définie. Alternativement, sur un système 32\ bits, le symbole \fBlseek\fP devient un alias de \fBlseek64\fP si la macro \fB_FILE_OFFSET_BITS\fP est définie avec la valeur\ \fB64\fP. .SH "VOIR AUSSI" \fBllseek\fP(2), \fBlseek\fP(2) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Frédéric Hantrais et Lucien Gentis . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .