perkamon - en to fr translation catalogue (38 entries)

note: type: TH
en: 2023-04-03
fr: 3 avril 2023

note: type: TH
en: Linux man-pages 6.05.01
fr: Pages du manuel de Linux 6.05.01

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: read - read from a file descriptor
fr: read - Lire depuis un descripteur de fichier

note: type: SH
en: LIBRARY
fr: BIBLIOTHÈQUE

note: type: Plain text
en: Standard C library (I<libc>, I<-lc>)
fr: Bibliothèque C standard (I<libc>, I<-lc>)

note: type: Plain text
en: B<read>()  attempts to read up to I<count> bytes from file descriptor I<fd> into the buffer starting at I<buf>.
fr: B<read>() lit jusqu'à I<count> octets depuis le descripteur de fichier I<fd> dans le tampon pointé par I<buf>.

note: type: Plain text
en: On files that support seeking, the read operation commences at the file offset, and the file offset is incremented by the number of bytes read.  If the file offset is at or past the end of file, no bytes are read, and B<read>()  returns zero.
fr: Sur les fichiers permettant le positionnement, l'opération de lecture a lieu à la position actuelle dans le fichier et elle est déplacée du nombre d'octets lus. Si la position actuelle dans le fichier est à la fin du fichier ou après, aucun octet n'est lu et B<read>() renvoie zéro.

note: type: Plain text
en: If I<count> is zero, B<read>()  I<may> detect the errors described below.  In the absence of any errors, or if B<read>()  does not check for errors, a B<read>()  with a I<count> of 0 returns zero and has no other effects.
fr: Si I<count> vaut zéro, B<read>() I<pourrait> détecter les erreurs décrites ci-dessous. En l’absence d'erreur, ou si B<read>() ne vérifie pas les erreurs, un B<read>() avec un I<count> de B<0> renvoie zéro et n'a pas d'autres effets.

note: type: Plain text
en: According to POSIX.1, if I<count> is greater than B<SSIZE_MAX>, the result is implementation-defined; see NOTES for the upper limit on Linux.
fr: Selon POSIX.1, si I<count> est supérieur à B<SSIZE_MAX>, le résultat est défini par l'implémentation ; voir les NOTES pour la limite supérieure sous Linux.

note: type: SH
en: RETURN VALUE
fr: VALEUR RENVOYÉE

note: type: Plain text
en: On success, the number of bytes read is returned (zero indicates end of file), and the file position is advanced by this number.  It is not an error if this number is smaller than the number of bytes requested; this may happen for example because fewer bytes are actually available right now (maybe because we were close to end-of-file, or because we are reading from a pipe, or from a terminal), or because B<read>()  was interrupted by a signal.  See also NOTES.
fr: En cas de succès, le nombre d'octets lus est renvoyé (zéro indique une fin de fichier), et la tête de lecture est avancée de ce nombre. Le fait que le nombre renvoyé soit plus petit que le nombre demandé n'est pas une erreur. Cela se produit, par exemple, s'il y a moins d'octets disponibles (parce qu'on était peut-être près de la fin du fichier, ou parce qu'on lit depuis un tube ou un terminal) ou bien si B<read>() a été interrompu par un signal. Voir les NOTES.

note: type: Plain text
en: On error, -1 is returned, and I<errno> is set to indicate the error.  In this case, it is left unspecified whether the file position (if any) changes.
fr: En cas d'erreur, la valeur de retour est B<-1> et I<errno> est définie pour préciser l'erreur. Dans ce cas, il n'est pas indiqué si la position du fichier (s'il y en a) change.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The file descriptor I<fd> refers to a file other than a socket and has been marked nonblocking (B<O_NONBLOCK>), and the read would block.  See B<open>(2)  for further details on the B<O_NONBLOCK> flag.
fr: Le descripteur de fichier I<fd> fait référence à un fichier autre qu'un socket et a été marqué comme non bloquant (B<O_NONBLOCK>), et la lecture devrait bloquer. Voir B<open>(2) pour plus de détails sur l'attribut B<O_NONBLOCK>.

note: type: TP
en: B<EAGAIN> or B<EWOULDBLOCK>
fr: B<EAGAIN> ou B<EWOULDBLOCK>

note: Actually EAGAIN on Linux type: Plain text
en: The file descriptor I<fd> refers to a socket and has been marked nonblocking (B<O_NONBLOCK>), and the read would block.  POSIX.1-2001 allows either error to be returned for this case, and does not require these constants to have the same value, so a portable application should check for both possibilities.
fr: Le descripteur de fichier I<fd> fait référence à un socket et a été marqué comme non bloquant (B<O_NONBLOCK>), et la lecture devrait bloquer. POSIX.1-2001 permet de renvoyer l'une ou l'autre des erreurs dans ce cas et n'exige pas que ces constantes aient la même valeur. Une application portable devrait donc tester les deux possibilités.

note: type: Plain text
en: I<fd> is not a valid file descriptor or is not open for reading.
fr: I<fd> n'est pas un descripteur de fichier valable ou n'est pas ouvert en lecture.

note: type: Plain text
en: I<buf> is outside your accessible address space.
fr: I<buf> pointe en dehors de l'espace d'adressage accessible.

note: type: Plain text
en: The call was interrupted by a signal before any data was read; see B<signal>(7).
fr: B<read>() a été interrompu par un signal avant d'avoir eu le temps de lire quoi que ce soit ; consultez B<signal>(7).

note: type: Plain text
en: I<fd> is attached to an object which is unsuitable for reading; or the file was opened with the B<O_DIRECT> flag, and either the address specified in I<buf>, the value specified in I<count>, or the file offset is not suitably aligned.
fr: Le descripteur I<fd> correspond à un objet qu'il est impossible de lire. Ou bien le fichier a été ouvert avec l'attribut B<O_DIRECT>, et l'adresse de I<buf>, la valeur de I<count> ou la position actuelle de la tête de lecture ne sont pas alignées correctement.

note: type: Plain text
en: I<fd> was created via a call to B<timerfd_create>(2)  and the wrong size buffer was given to B<read>(); see B<timerfd_create>(2)  for further information.
fr: I<fd> a été créé par un appel à B<timerfd_create>(2) et une mauvaise taille de tampon a été donnée à B<read>() ; consultez B<timerfd_create>(2) pour plus d'informations.

note: type: Plain text
en: I/O error.  This will happen for example when the process is in a background process group, tries to read from its controlling terminal, and either it is ignoring or blocking B<SIGTTIN> or its process group is orphaned.  It may also occur when there is a low-level I/O error while reading from a disk or tape.  A further possible cause of B<EIO> on networked filesystems is when an advisory lock had been taken out on the file descriptor and this lock has been lost.  See the I<Lost locks> section of B<fcntl>(2)  for further details.
fr: Erreur d'entrée-sortie. Cela arrive, par exemple, si un processus est dans un groupe en arrière-plan et tente de lire depuis le terminal qui le gère et soit il ignore, soit il bloque un signal B<SIGTTIN>, ou bien son groupe est orphelin. Cela arrive également si une erreur d'entrée-sortie de bas niveau s'est produite pendant la lecture d'un disque ou d'une bande. Une autre cause possible de B<EIO> sur les systèmes de fichiers en réseau est la présence d'un verrou consultatif sur le descripteur de fichier et le fait qu'il a été perdu. Voir la section I<Perte de verrou> de B<fcntl>(2) pour plus de détails.

note: type: Plain text
en: I<fd> refers to a directory.
fr: I<fd> est un répertoire.

note: type: Plain text
en: Other errors may occur, depending on the object connected to I<fd>.
fr: D'autres erreurs peuvent se produire suivant le type d'objet associé à I<fd>.

note: type: SH
en: HISTORY
fr: HISTORIQUE

note: commit e28cc71572da38a5a12c1cfe4d7032017adccf69 type: Plain text
en: On Linux, B<read>()  (and similar system calls) will transfer at most 0x7ffff000 (2,147,479,552) bytes, returning the number of bytes actually transferred.  (This is true on both 32-bit and 64-bit systems.)
fr: Sur Linux, B<read>() (et les appels système équivalents) transfèreront au maximum 0x7ffff000 (2 147 479 552) octets et renverront le nombre d'octets transférés (cela est vrai aussi bien sur des systèmes 32 que 64 bits).

note: type: Plain text
en: On NFS filesystems, reading small amounts of data will update the timestamp only the first time, subsequent calls may not do so.  This is caused by client side attribute caching, because most if not all NFS clients leave I<st_atime> (last file access time)  updates to the server, and client side reads satisfied from the client's cache will not cause I<st_atime> updates on the server as there are no server-side reads.  UNIX semantics can be obtained by disabling client-side attribute caching, but in most situations this will substantially increase server load and decrease performance.
fr: Sur un système de fichiers NFS, la lecture de petites quantités de données ne mettra à jour l'horodatage du fichier que lors de la première lecture. Les lectures suivantes ne modifieront pas cette heure. Cela est dû à la mise en cache des attributs côté client, car la plupart, si ce n'est tous les clients NFS, mettent à jour sur le serveur I<st_atime> (heure de dernier accès au fichier), et les lectures côté client satisfaites par le cache du client n'effectueront pas la mise à jour de I<st_atime> sur le serveur, car il n'y a pas de lecture du côté serveur. La véritable sémantique UNIX peut être obtenue en désactivant le cache des attributs du côté client, mais généralement cela augmente sensiblement la charge du serveur et dégrade les performances.

note: type: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: According to POSIX.1-2008/SUSv4 Section XSI 2.9.7 ("Thread Interactions with Regular File Operations"):
fr: Selon POSIX.1-2008/SUSv4, Section XSI 2.9.7 (« Thread Interactions with Regular File Operations ») :

note: type: Plain text
en: All of the following functions shall be atomic with respect to each other in the effects specified in POSIX.1-2008 when they operate on regular files or symbolic links: ...
fr: Toutes les fonctions suivantes doivent être atomiques et ne pas se perturber mutuellement pour ce qui concerne les effets spécifiés dans POSIX.1-2008 lorsqu'elles opèrent sur les fichiers normaux ou sur les liens symboliques : ...

note: http://thread.gmane.org/gmane.linux.kernel/1649458 From: Michael Kerrisk (man-pages <mtk.manpages <at> gmail.com> Subject: Update of file offset on write() etc. is non-atomic with I/O Date: 2014-02-17 15:41:37 GMT Newsgroups: gmane.linux.kernel, gmane.linux.file-systems commit 9c225f2655e36a470c4f58
en: Among the APIs subsequently listed are B<read>()  and B<readv>(2).  And among the effects that should be atomic across threads (and processes)  are updates of the file offset.  However, before Linux 3.14, this was not the case: if two processes that share an open file description (see B<open>(2))  perform a B<read>()  (or B<readv>(2))  at the same time, then the I/O operations were not atomic with respect updating the file offset, with the result that the reads in the two processes might (incorrectly) overlap in the blocks of data that they obtained.  This problem was fixed in Linux 3.14.
fr: B<read>() et B<readv>(2) figurent parmi les API listées par la suite. En outre, la mise à jour du décalage de fichier fait partie des effets qui doivent être atomiques pour les threads (et pour les processus). Cependant, avant Linux 3.14, cela n'était pas le cas : si deux processus partageant un même descripteur de fichier ouvert (consultez B<open>(2)) effectuaient une action B<read>() (ou B<readv>(2)) simultanément, alors les opérations E/S n'étaient pas atomiques pour ce qui concernait la mise à jour du décalage de fichier. En conséquence, les lectures effectuées par les deux processus pouvaient se chevaucher au niveau des blocs des données récupérées (de façon incorrecte). Ce problème a été résolu dans Linux 3.14.

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: TH
en: 2022-12-04
fr: 4 décembre 2022

note: type: TH
en: Linux man-pages 6.03
fr: Pages du manuel de Linux 6.03

note: type: Plain text
en: The types I<size_t> and I<ssize_t> are, respectively, unsigned and signed integer data types specified by POSIX.1.
fr: Les types I<size_t> et I<ssize_t> sont respectivement des types de données d’entiers non signés et signés indiqués par POSIX.1.

note: type: TH
en: Linux man-pages 6.05
fr: Pages du manuel de Linux 6.05

note: type: TH
en: Linux man-pages 6.04
fr: Pages du manuel de Linux 6.04
