perkamon - en to fr translation catalogue (48 entries)

note: type: TH
en: 2018-04-30
fr: 30 avril 2018

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: fallocate - manipulate file space
fr: fallocate - Manipuler un espace de fichier

note: type: Plain text
en: B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */
    B<#include E<lt>fcntl.hE<gt>>
fr: B<#define _GNU_SOURCE>             /* Consultez feature_test_macros(7) */
    B<#include E<lt>fcntl.hE<gt>>

note: type: Plain text
en: This is a nonportable, Linux-specific system call.  For the portable, POSIX.1-specified method of ensuring that space is allocated for a file, see B<posix_fallocate>(3).
fr: C'est un appel système spécifique à Linux et non portable. Pour la méthode portable, spécifiée par POSIX.1, pour assurer que de l'espace est alloué pour un fichier, consultez B<posix_fallocate>(3).

note: type: Plain text
en: B<fallocate>()  allows the caller to directly manipulate the allocated disk space for the file referred to by I<fd> for the byte range starting at I<offset> and continuing for I<len> bytes.
fr: B<fallocate>() permet à l'appelant de manipuler directement l'espace disque alloué pour le fichier référencé par I<fd> pour la plage d'octets débutant à I<offset> et de longueur I<len> octets.

note: type: Plain text
en: The I<mode> argument determines the operation to be performed on the given range.  Details of the supported operations are given in the subsections below.
fr: Le paramètre I<mode> définit l'opération à effectuer sur la plage donnée. Les sous-sections suivantes apportent des précisions sur les opérations prises en charge.

note: type: SS
en: Allocating disk space
fr: Allocation d'espace disque.

note: type: Plain text
en: The default operation (i.e., I<mode> is zero) of B<fallocate>()  allocates the disk space within the range specified by I<offset> and I<len>.  The file size (as reported by B<stat>(2))  will be changed if I<offset>+I<len> is greater than the file size.  Any subregion within the range specified by I<offset> and I<len> that did not contain data before the call will be initialized to zero.  This default behavior closely resembles the behavior of the B<posix_fallocate>(3)  library function, and is intended as a method of optimally implementing that function.
fr: L'opération par défaut (c'est-à-dire si I<mode> est zéro) de B<fallocate>() alloue l'espace disque dans l'intervalle indiqué par I<offset> et I<len>. La taille du fichier (comme indiquée par B<stat>(2)) sera modifiée si I<offset>+I<len> est supérieur à la taille du fichier. Toute sous-région dans l'intervalle indiqué par I<offset> et I<len> sera initialisée à zéro si elle ne contient pas de données au moment de l'appel. Ce comportement par défaut ressemble beaucoup au comportement de la fonction de bibliothèque B<posix_fallocate>(3), et est conçu comme une méthode d'implémentation optimisée de cette fonction.

note: type: Plain text
en: After a successful call, subsequent writes into the range specified by I<offset> and I<len> are guaranteed not to fail because of lack of disk space.
fr: Après un appel réussi, les écritures suivantes dans l'intervalle indiqué par I<offset> et I<len> seront garanties sans échec dû à un manque d'espace disque.

note: type: Plain text
en: If the B<FALLOC_FL_KEEP_SIZE> flag is specified in I<mode>, the behavior of the call is similar, but the file size will not be changed even if I<offset>+I<len> is greater than the file size.  Preallocating zeroed blocks beyond the end of the file in this manner is useful for optimizing append workloads.
fr: Si l'attribut B<FALLOC_FL_KEEP_SIZE> est indiqué dans I<mode>, le comportement de l'appel est similaire, mais la taille du fichier ne sera pas modifiée si I<offset>+I<len> est supérieur à la taille du fichier. L'allocation préalable de blocs mis à zéro après la fin du fichier de cette façon permet d'optimiser la charge de travail d'ajout.

note: type: Plain text
en: Because allocation is done in block size chunks, B<fallocate>()  may allocate a larger range of disk space than was specified.
fr: Parce que l'allocation est effectuée en fragments de taille de blocs, B<fallocate>() peut allouer un espace de disque plus grand que celui qui a été indiqué.

note: type: SS
en: Deallocating file space
fr: Désallocation d'espace de fichier

note: type: Plain text
en: The B<FALLOC_FL_PUNCH_HOLE> flag must be ORed with B<FALLOC_FL_KEEP_SIZE> in I<mode>; in other words, even when punching off the end of the file, the file size (as reported by B<stat>(2))  does not change.
fr: Le paramètre B<FALLOC_FL_PUNCH_HOLE> doit être inclus avec B<FALLOC_FL_KEEP_SIZE> dans I<mode> (avec un OU binaire) ; autrement dit, même en faisant des trous après la fin du fichier, la taille du fichier (comme indiquée par B<stat>(2)) ne changera pas.

note: type: Plain text
en: Not all filesystems support B<FALLOC_FL_PUNCH_HOLE>; if a filesystem doesn't support the operation, an error is returned.  The operation is supported on at least the following filesystems:
fr: Les systèmes de fichiers ne prennent pas tous B<FALLOC_FL_PUNCH_HOLE> en charge ; si un système de fichiers n'accepte pas l'opération, une erreur est renvoyée. L'opération est prise en charge notamment par les systèmes de fichiers suivants :

note: type: Plain text
en: XFS (since Linux 2.6.38)
fr: XFS (depuis Linux 2.6.38)

note: commit a4bb6b64e39abc0e41ca077725f2a72c868e7622 type: Plain text
en: ext4 (since Linux 3.0)
fr: ext4 (depuis Linux 3.0)

note: type: Plain text
en: Btrfs (since Linux 3.7)
fr: Btrfs (depuis Linux 3.7)

note: type: SS
en: Collapsing file space
fr: Réduction d'espace de fichier

note: commit 00f5e61998dd17f5375d9dfc01331f104b83f841 type: Plain text
en: Specifying the B<FALLOC_FL_COLLAPSE_RANGE> flag (available since Linux 3.15) in I<mode> removes a byte range from a file, without leaving a hole.  The byte range to be collapsed starts at I<offset> and continues for I<len> bytes.  At the completion of the operation, the contents of the file starting at the location I<offset+len> will be appended at the location I<offset>, and the file will be I<len> bytes smaller.
fr: Indiquer le paramètre B<FALLOC_FL_COLLAPSE_RANGE> (disponible depuis Linux 3.15) dans I<mode> supprime un intervalle d'octets d'un fichier sans laisser de trou. L'intervalle commence à I<offset> et continue pendant I<len> octets. Une fois l'opération terminée, les contenus du fichier au-délà de I<offset+len> seront déplacés à l'emplacement I<offset>, le fichier sera alors alors I<len> octets plus court.

note: type: Plain text
en: If the region specified by I<offset> plus I<len> reaches or passes the end of file, an error is returned; instead, use B<ftruncate>(2)  to truncate a file.
fr: Si la plage définie par I<offset> et I<len> atteint ou dépasse la fin du fichier, une erreur est renvoyée. Le fichier devrait être tronqué avec B<ftruncate>(2).

note: type: Plain text
en: No other flags may be specified in I<mode> in conjunction with B<FALLOC_FL_COLLAPSE_RANGE>.
fr: Aucun autre attribut de ne peut être indiqué dans I<mode> en plus de B<FALLOC_FL_COLLAPSE_RANGE>.

note: commit 9eb79482a97152930b113b51dff530aba9e28c8e commit e1d8fb88a64c1f8094b9f6c3b6d2d9e6719c970d type: Plain text
en: As at Linux 3.15, B<FALLOC_FL_COLLAPSE_RANGE> is supported by ext4 (only for extent-based files)  and XFS.
fr: Linux 3.15 prend en charge B<FALLOC_FL_COLLAPSE_RANGE> pour ext4 (seulement pour les fichiers à base de domaines ou « extent ») et XFS.

note: type: SS
en: Zeroing file space
fr: Initialisation d'espace de fichier

note: type: Plain text
en: Zeroing is done within the filesystem preferably by converting the range into unwritten extents.  This approach means that the specified range will not be physically zeroed out on the device (except for partial blocks at the either end of the range), and I/O is (otherwise) required only to update metadata.
fr: L’initialisation est réalisée dans le système de fichier de préférence en convertissant l’intervalle en « extents » non écrits. Cette approche signifie que l’intervalle indiqué ne sera pas physiquement initialisé sur le périphérique (à part les blocs partiels aux extrémités de l’intervalle) et qu’une E/S n’est (sinon) nécessaire que pour mettre à jour les métadonnées.

note: type: Plain text
en: If the B<FALLOC_FL_KEEP_SIZE> flag is additionally specified in I<mode>, the behavior of the call is similar, but the file size will not be changed even if I<offset>+I<len> is greater than the file size.  This behavior is the same as when preallocating space with B<FALLOC_FL_KEEP_SIZE> specified.
fr: Si l'attribut B<FALLOC_FL_KEEP_SIZE> est également indiqué dans I<mode>, le comportement de l'appel est similaire, mais la taille du fichier ne sera pas modifiée si I<offset>+I<len> est supérieur à la taille du fichier. Le comportement est le même lorsque de l'espace est préalloué et que B<FALLOC_FL_KEEP_SIZE> est indiqué.

note: type: Plain text
en: Not all filesystems support B<FALLOC_FL_ZERO_RANGE>; if a filesystem doesn't support the operation, an error is returned.  The operation is supported on at least the following filesystems:
fr: Les systèmes de fichiers ne prennent pas tous B<FALLOC_FL_ZERO_RANGE> en charge ; si un système de fichiers n'accepte pas l'opération, une erreur est renvoyée. L'opération est prise en charge notamment par les systèmes de fichiers suivants :

note: type: SH
en: RETURN VALUE
fr: VALEUR DE RETOUR

note: type: Plain text
en: On success, B<fallocate>()  returns zero.  On error, -1 is returned and I<errno> is set to indicate the error.
fr: En cas de succès, B<fallocate>() renvoie 0. En cas d'erreur, -1 est renvoyé et I<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: I<fd> is not a valid file descriptor, or is not opened for writing.
fr: I<fd> n'est pas un descripteur de fichier valable ou n'est pas ouvert en écriture.

note: type: Plain text
en: I<offset>+I<len> exceeds the maximum file size.
fr: I<offset>+I<len> excède la taille maximum de fichier.

note: FIXME . (raise a kernel bug) Probably the len==0 case should be a no-op, rather than an error. That would be consistent with similar APIs for the len==0 case. See "Re: [PATCH] fallocate.2: add FALLOC_FL_PUNCH_HOLE flag definition" 21 Sep 2012 http://thread.gmane.org/gmane.linux.file-systems/48331/fo
en: I<offset> was less than 0, or I<len> was less than or equal to 0.
fr: I<offset> était inférieur à 0, ou I<len> était inférieur ou égal à 0.

note: type: Plain text
en: I<mode> is B<FALLOC_FL_COLLAPSE_RANGE> and the range specified by I<offset> plus I<len> reaches or passes the end of the file.
fr: I<mode> vaut B<FALLOC_FL_COLLAPSE_RANGE> et la plage indiquée par I<offset> et I<len> atteint ou dépasse la fin du fichier.

note: type: Plain text
en: An I/O error occurred while reading from or writing to a filesystem.
fr: Une erreur d'entrée-sortie s'est produite durant la lecture ou l'écriture sur un système de fichiers.

note: type: Plain text
en: I<fd> does not refer to a regular file or a directory.  (If I<fd> is a pipe or FIFO, a different error results.)
fr: I<fd> ne fait pas référence à un fichier régulier ou un répertoire (si I<fd> est un tube ou une FIFO, une erreur différente en résultera).

note: type: Plain text
en: There is not enough space left on the device containing the file referred to by I<fd>.
fr: Il n'y a pas suffisamment d'espace disponible sur le périphérique où se trouve le fichier référencé par I<fd>.

note: type: Plain text
en: This kernel does not implement B<fallocate>().
fr: Ce noyau ne met pas en œuvre B<fallocate>().

note: type: Plain text
en: The filesystem containing the file referred to by I<fd> does not support this operation; or the I<mode> is not supported by the filesystem containing the file referred to by I<fd>.
fr: Le système de fichiers contenant le fichier référencé par I<fd> ne gère pas cette opération, ou le I<mode> n'est pas pris en charge par le système de fichiers contenant le fichier référencé par I<fd>.

note: type: Plain text
en: I<fd> refers to a pipe or FIFO.
fr: I<fd> fait référence à un tube ou une FIFO.

note: See http://sourceware.org/bugzilla/show_bug.cgi?id=14964 type: Plain text
en: B<fallocate>()  is available on Linux since kernel 2.6.23.  Support is provided by glibc since version 2.10.  The B<FALLOC_FL_*> flags are defined in glibc headers only since version 2.18.
fr: B<fallocate>() est disponible dans Linux depuis le noyau 2.6.23. La glibc le prend en charge depuis la version 2.10. Les paramètres B<FALLOC_FL_*> ne sont définis dans les en-têtes de la glibc que depuis la version 2.18.

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: type: Plain text
en: B<fallocate>()  is Linux-specific.
fr: B<fallocate>() est spécifique à Linux.

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

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.03 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.02 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.01 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.
