perkamon - en to fr translation catalogue (59 entries)

note: type: TH
en: 2018-02-02
fr: 2 février 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: fts, fts_open, fts_read, fts_children, fts_set, fts_close - traverse a file hierarchy
fr: fts, fts_open, fts_read, fts_children, fts_set, fts_close - Parcourir une hiérarchie de fichiers

note: .Bl -tag -width "fts_namelen" type: Plain text
en: These fields are defined as follows:
fr: Les membres ont les significations suivantes\ :

note: type: Plain text
en: A directory being visited in preorder.
fr: Un répertoire visité en phase «\ preorder\ ».

note: type: Plain text
en: A directory that causes a cycle in the tree.  (The I<fts_cycle> field of the I<FTSENT> structure will be filled in as well.)
fr: Un répertoire introduisant une boucle dans l'arborescence. Le champ I<fts_cycle> de la structure I<FTSENT> sera également remplis.

note: type: Plain text
en: Any I<FTSENT> structure that represents a file type not explicitly described by one of the other I<fts_info> values.
fr: Toute structure I<FTSENT> représentant un type de fichier non décrit explicitement par l'une des autres valeurs de I<fts_info>.

note: type: Plain text
en: A directory which cannot be read.  This is an error return, and the I<fts_errno> field will be set to indicate what caused the error.
fr: Un répertoire ne pouvant être lu. C'est considéré comme une erreur, et le champ I<fts_errno> sera défini avec une valeur décrivant sa cause.

note: type: Plain text
en: A file named "." or ".." which was not specified as a filename to B<fts_open>()  (see B<FTS_SEEDOT>).
fr: Un fichier nommé « . » ou « .. » qui n'a pas été indiqué explicitement comme argument de B<fts_open>() (consultez B<FTS_SEEDOT>).

note: type: Plain text
en: A directory being visited in postorder.  The contents of the I<FTSENT> structure will be unchanged from when it was returned in preorder, that is, with the I<fts_info> field set to B<FTS_D>.
fr: Un répertoire visité en phase «\ postorder\ ». Le contenu de la structure I<FTSENT> ne sera pas différent de ce qu'il était après la phase «\ preorder\ ». C'est-à-dire quand le champ I<fts_info> valait B<FTS_D>.

note: type: Plain text
en: This is an error return, and the I<fts_errno> field will be set to indicate what caused the error.
fr: Il s'agit d'un retour d'erreur, le champ I<fts_errno> étant rempli pour indiquer la cause de l'erreur.

note: type: Plain text
en: A regular file.
fr: Un fichier normal.

note: type: Plain text
en: A file for which no B<stat>(2)  information was available.  The contents of the I<fts_statp> field are undefined.  This is an error return, and the I<fts_errno> field will be set to indicate what caused the error.
fr: Un fichier pour lequel aucune information provenant de B<stat>(2) n'est disponible. Le contenu du champ I<fts_statp> est indéfini. Il s'agit d'un cas d'erreur dont la cause est indiquée dans I<fts_errno>.

note: type: Plain text
en: A file for which no B<stat>(2)  information was requested.  The contents of the I<fts_statp> field are undefined.
fr: Un fichier pour lequel aucune information provenant de B<stat>(2) n'a été demandée. Le contenu du champ I<fts_statp> est indéfini.

note: type: Plain text
en: A symbolic link.
fr: Un lien symbolique.

note: .El type: Plain text
en: A symbolic link with a nonexistent target.  The contents of the I<fts_statp> field reference the file characteristic information for the symbolic link itself.
fr: Un lien symbolique pointant dans le vide. Le contenu du champ I<fts_statp> contient les caractéristiques du lien lui-même.

note: type: Plain text
en: A path for accessing the file from the current directory.
fr: Un chemin permettant d'accéder au fichier depuis le répertoire courant.

note: type: Plain text
en: The path for the file relative to the root of the traversal.  This path contains the path specified to B<fts_open>()  as a prefix.
fr: Le chemin d'accès au fichier à partir du point de départ du parcours. Il contient en préfixe le chemin fourni lors de l'invocation de B<fts_open>().

note: type: Plain text
en: The name of the file.
fr: Le nom du fichier.

note: type: Plain text
en: The length of the string referenced by I<fts_name>.
fr: La longueur de la chaîne pointée par I<fts_name>.

note: type: Plain text
en: The depth of the traversal, numbered from -1 to N, where this file was found.  The I<FTSENT> structure representing the parent of the starting point (or root)  of the traversal is numbered -1, and the I<FTSENT> structure for the root itself is numbered 0.
fr: La profondeur où le fichier a été trouvé dans l'arborescence, numérotée de -1 à N. La structure I<FTSENT> représentant le parent du point de départ est numérotée -1. La structure I<FTSENT> représentant la racine de départ elle-même est numérotée 0.

note: type: Plain text
en: This field is provided for the use of the application program and is not modified by the fts functions.  It is initialized to 0.
fr: Ce champ est mis à la disposition des programmes applicatifs, et n'est modifié par aucune fonction de la famille fts. Il est toutefois initialisé à zéro.

note: type: Plain text
en: This field is provided for the use of the application program and is not modified by the fts functions.  It is initialized to NULL.
fr: Ce champ est mis à la disposition des programmes applicatifs, et n'est modifié par aucune fonction de la famille fts. Il est toutefois initialisé à NULL.

note: type: Plain text
en: Upon return from the B<fts_children>()  function, the I<fts_link> field points to the next structure in the NULL-terminated linked list of directory members.  Otherwise, the contents of the I<fts_link> field are undefined.
fr: Au retour de la fonction B<fts_children>(), le champ I<fts_link> pointe sur la structure suivante dans la liste chaînée des membres du répertoires, liste terminée par un NULL. Dans les autres situations, le contenu du champ I<fts_link> est indéterminé.

note: type: Plain text
en: If a directory causes a cycle in the hierarchy (see B<FTS_DC>), either because of a hard link between two directories, or a symbolic link pointing to a directory, the I<fts_cycle> field of the structure will point to the I<FTSENT> structure in the hierarchy that references the same file as the current I<FTSENT> structure.  Otherwise, the contents of the I<fts_cycle> field are undefined.
fr: Si un répertoire introduit une boucle dans la hiérarchie (consultez B<FTS_DC>),soit à cause d'un lien physique entre deux répertoires, soit à cause d'un lien symbolique pointant vers un répertoire, le champ I<fts_cycle> pointera vers la structure I<FTSENT> de la hiérarchie qui référence le même fichier que celui représenté par la structure I<FTSENT>. Sinon, le contenu du champ I<fts_cycle> est indéfini.

note: .El type: Plain text
en: A pointer to B<stat>(2)  information for the file.
fr: Un pointeur vers les informations fournies par B<stat>(2).

note: type: Plain text
en: A single buffer is used for all of the paths of all of the files in the file hierarchy.  Therefore, the I<fts_path> and I<fts_accpath> fields are guaranteed to be null-terminated I<only> for the file most recently returned by B<fts_read>().  To use these fields to reference any files represented by other I<FTSENT> structures will require that the path buffer be modified using the information contained in that I<FTSENT> structure's I<fts_pathlen> field.  Any such modifications should be undone before further calls to B<fts_read>()  are attempted.  The I<fts_name> field is always null-terminated.
fr: Un tampon unique est utilisé pour tous les chemins d'accès de tous les fichiers de la hiérarchie. Ainsi, les champs I<fts_path> et I<fts_accpath> sont assurés d'être terminés par un caractère nul I<seulement> pour le fichier renvoyé le plus récemment par B<fts_read>(). Pour utiliser ces champs pour référencer un fichier représenté par une autre structure I<FTSENT>, il faut que le chemin du tampon soit modifié avec l'information contenu dans le champ I<fts_pathlen> de cette structure I<FTSENT>. Tout autre modification devra être défaite avant que d'autres appels à B<fts_read>() ne soient tentés. Le champ I<fts_name> est toujours terminé par un caractère nul.

note: type: Plain text
en: The B<fts_open>()  function takes a pointer to an array of character pointers naming one or more paths which make up a logical file hierarchy to be traversed.  The array must be terminated by a null pointer.
fr: La fonction B<fts_open>() reçoit un pointeur vers une table de chaînes de caractères représentant un ou plusieurs chemins décrivant la hiérarchie de fichiers à traverser. Cette table doit se terminer par un pointeur NULL.

note: .Bl -tag -width "FTS_PHYSICAL" type: Plain text
en: There are a number of options, at least one of which (either B<FTS_LOGICAL> or B<FTS_PHYSICAL>)  must be specified.  The options are selected by ORing the following values:
fr: Il existe un certain nombre d'options, dont au moins une est obligatoire (soit B<FTS_LOGICAL> ou soit B<FTS_PHYSICAL>). Les options sont sélectionnées par un I<ou logique> entre les valeurs suivantes\ :

note: type: Plain text
en: This option causes any symbolic link specified as a root path to be followed immediately whether or not B<FTS_LOGICAL> is also specified.
fr: Tout lien symbolique indiqué comme racine du parcours sera immédiatement suivi (déréférencé), que l'option B<FTS_LOGICAL> soit indiquée ou non.

note: type: Plain text
en: This option causes the fts routines to return I<FTSENT> structures for the targets of symbolic links instead of the symbolic links themselves.  If this option is set, the only symbolic links for which I<FTSENT> structures are returned to the application are those referencing nonexistent files.  Either B<FTS_LOGICAL> or B<FTS_PHYSICAL> I<must> be provided to the B<fts_open>()  function.
fr: Cette option indique aux fonctions fts de renvoyer des structures I<FTSENT>  concernant les cibles des liens symboliques plutôt que les liens eux-mêmes. Avec cette option, les seuls liens symboliques pour lesquels une structure I<FTSENT> est renvoyée sont ceux pointant dans le vide. Il I<faut> préciser soit B<FTS_LOGICAL>, soit B<FTS_PHYSICAL> à la fonction B<fts_open>().

note: type: Plain text
en: As a performance optimization, the fts functions change directories as they walk the file hierarchy.  This has the side-effect that an application cannot rely on being in any particular directory during the traversal.  The B<FTS_NOCHDIR> option turns off this optimization, and the fts functions will not change the current directory.  Note that applications should not themselves change their current directory and try to access files unless B<FTS_NOCHDIR> is specified and absolute pathnames were provided as arguments to B<fts_open>().
fr: Pour optimiser les performances, les fonctions fts changent de répertoire au cours de la traversée de la hiérarchie de fichiers. En contrepartie, l'application ne peut pas savoir à l'avance où elle se trouve durant la traversée. L'option B<FTS_NOCHDIR> supprime cette optimisation et les fonctions fts ne changeront pas de répertoire de travail. Remarquez que les applications ne doivent pas modifier elles-même le répertoire de travail et essayer d'accéder aux fichiers sans que l'option B<FTS_NOCHDIR> ne soit indiquée et que des chemins d'accès absolus soient transmis à B<fts_open>().

note: type: Plain text
en: By default, returned I<FTSENT> structures reference file characteristic information (the I<statp> field) for each file visited.  This option relaxes that requirement as a performance optimization, allowing the fts functions to set the I<fts_info> field to B<FTS_NSOK> and leave the contents of the I<statp> field undefined.
fr: Par défaut, les structures I<FTSENT> renvoyées contiennent les caractéristiques (voir le champ I<statp>) de chaque fichier visité. Cette option relâche cette contrainte pour optimiser les performances, en autorisant les fonctions fts à remplir le champ I<fts_info> avec B<FTS_NSOK> et laisser le contenu du membre I<statp> indéfini.

note: type: Plain text
en: This option causes the fts routines to return I<FTSENT> structures for symbolic links themselves instead of the target files they point to.  If this option is set, I<FTSENT> structures for all symbolic links in the hierarchy are returned to the application.  Either B<FTS_LOGICAL> or B<FTS_PHYSICAL> I<must> be provided to the B<fts_open>()  function.
fr: Avec cette option, les routines fts renvoient des structures I<FTSENT> pour les liens symboliques eux-mêmes et non pas les fichiers qu'ils pointent. Si cette option est définie, des structures I<FTSENT> pour tous les liens symboliques de la hiérarchie sont renvoyées à l'application. Soit B<FTS_LOGICAL> ou soit B<FTS_PHYSICAL> I<doit> être fourni à la fonction B<fts_open>().

note: type: Plain text
en: By default, unless they are specified as path arguments to B<fts_open>(), any files named "." or ".." encountered in the file hierarchy are ignored.  This option causes the fts routines to return I<FTSENT> structures for them.
fr: Par défaut, à moins d'être fournis explicitement en argument à B<fts_open>() ,tout fichier nommé « . » ou « .. » rencontré dans la hiérarchie est ignoré. Avec cette option, les routines fts renvoient des structures I<FTSENT> pour ces fichiers.

note: .El type: Plain text
en: This option prevents fts from descending into directories that have a different device number than the file from which the descent began.
fr: Cette option empêche fts de descendre dans les répertoires se trouvant sur un périphérique différent de celui dans lequel le parcours a commencé.

note: type: Plain text
en: The B<fts_read>()  function returns a pointer to an I<FTSENT> structure describing a file in the hierarchy.  Directories (that are readable and do not cause cycles) are visited at least twice, once in preorder and once in postorder.  All other files are visited at least once.  (Hard links between directories that do not cause cycles or symbolic links to symbolic links may cause files to be visited more than once, or directories more than twice.)
fr: La fonction B<fts_read>() renvoie un pointeur sur une structure I<FTSENT> décrivant un fichier de la hiérarchie. Les répertoires lisibles et ne causant pas de boucles sont parcourus au moins deux fois, une fois en phase «\ preorder\ », et une en phase «\ postorder\ ». Les autres fichiers ne sont examinés qu'une seule fois. Les liens physiques entre répertoires qui ne causent pas de boucles, ou les liens symboliques vers des liens symboliques peuvent entraîner des fichiers visités plus d'une fois, ou des répertoires plus de deux fois.

note: type: Plain text
en: If all the members of the hierarchy have been returned, B<fts_read>()  returns NULL and sets the external variable I<errno> to 0.  If an error unrelated to a file in the hierarchy occurs, B<fts_read>()  returns NULL and sets I<errno> appropriately.  If an error related to a returned file occurs, a pointer to an I<FTSENT> structure is returned, and I<errno> may or may not have been set (see I<fts_info>).
fr: Si tous les membres de la hiérarchie ont été examinés, B<fts_read>() renvoie NULL et définit la variable externe I<errno> avec un 0. Si une erreur sans rapport avec un fichier particulier se produit, B<fts_read>() renvoie NULL et définit I<errno> en conséquence. Si une erreur concernant le fichier en cours se produit, un pointeur sur une structure I<FTSENT> est renvoyé, et I<errno> peut ou non être défini (consultez I<fts_info>).

note: type: Plain text
en: The I<FTSENT> structures returned by B<fts_read>()  may be overwritten after a call to B<fts_close>()  on the same file hierarchy stream, or, after a call to B<fts_read>()  on the same file hierarchy stream unless they represent a file of type directory, in which case they will not be overwritten until after a call to B<fts_read>()  after the I<FTSENT> structure has been returned by the function B<fts_read>()  in postorder.
fr: Les structures I<FTSENT> renvoyées par B<fts_read>() peuvent être écrasées après un appel à B<fts_close>() sur le même descripteur de hiérarchie ou après un appel à B<fts_read>() sur la même hiérarchie, sauf si elles représentent un répertoire, auquel cas elles ne seront pas écrasées avant l'appel B<fts_read>() renvoyant la structure I<FTSENT> du répertoire en phase «\ postorder\ ».

note: type: Plain text
en: The B<fts_children>()  function returns a pointer to an I<FTSENT> structure describing the first entry in a NULL-terminated linked list of the files in the directory represented by the I<FTSENT> structure most recently returned by B<fts_read>().  The list is linked through the I<fts_link> field of the I<FTSENT> structure, and is ordered by the user-specified comparison function, if any.  Repeated calls to B<fts_children>()  will re-create this linked list.
fr: La fonction B<fts_children>() renvoie un pointeur sur une structure I<FTSENT> décrivant la première entrée d'une liste chaînée terminée par un NULL et représentant les fichiers se trouvant dans le répertoire indiqué par la dernière structure I<FTSENT> renvoyée par un appel B<fts_read>(). La liste est chaînée par le biais du membre I<fts_link> de la structure I<FTSENT>, et est ordonnée suivant la routine de comparaison fournie par l'utilisateur, si elle existe. Des appels répétés à B<fts_children>() recréeront la liste chaînée.

note: type: Plain text
en: As a special case, if B<fts_read>()  has not yet been called for a hierarchy, B<fts_children>()  will return a pointer to the files in the logical directory specified to B<fts_open>(), that is, the arguments specified to B<fts_open>().  Otherwise, if the I<FTSENT> structure most recently returned by B<fts_read>()  is not a directory being visited in preorder, or the directory does not contain any files, B<fts_children>()  returns NULL and sets I<errno> to zero.  If an error occurs, B<fts_children>()  returns NULL and sets I<errno> appropriately.
fr: Un cas particulier se présente si B<fts_read>() n'a pas encore été appelée pour une hiérarchie. Alors, B<fts_children>() renverra un pointeur sur les fichiers du répertoire logique indiqué dans B<fts_open>(), c'est-à-dire les arguments fournis à B<fts_open>(). Sinon, si la structure I<FTSENT> la plus récemment renvoyée par B<fts_read>() n'est pas un répertoire visité en phase «\ preorder\ », ou si le répertoire ne contient aucun fichier, B<fts_children>() renvoie NULL et met la variable externe I<errno> à zéro. Si une erreur se produit, B<fts_children>() renvoie NULL et définit I<errno> en conséquence.

note: .El type: Plain text
en: Only the names of the files are needed.  The contents of all the fields in the returned linked list of structures are undefined with the exception of the I<fts_name> and I<fts_namelen> fields.
fr: Seuls les noms des fichiers sont nécessaires. Le contenu des membres des structures de la liste chaînée est indéfini sauf pour I<fts_name> et I<fts_namelen>.

note: type: Plain text
en: Revisit the file; any file type may be revisited.  The next call to B<fts_read>()  will return the referenced file.  The I<fts_stat> and I<fts_info> fields of the structure will be reinitialized at that time, but no other fields will have been changed.  This option is meaningful only for the most recently returned file from B<fts_read>().  Normal use is for postorder directory visits, where it causes the directory to be revisited (in both preorder and postorder) as well as all of its descendants.
fr: Revisiter à nouveau le fichier. N'importe quel type de fichier peut être revisité. L'appel suivant de B<fts_read>() renverra le fichier indiqué. Les membres I<fts_stat> et I<fts_info> de la structure seront réinitialisés à ce moment, mais aucun autre champ ne sera modifié. Cette option n'a de sens que pour le dernier fichier renvoyé par B<fts_read>(). L'utilisation habituelle de cette possibilité concerne les répertoires en phase «\ postorder\ », qui sont alors réexaminés (aussi bien en phase «\ preorder\ » que «\ postorder\ »), ainsi que leurs descendants.

note: type: Plain text
en: The referenced file must be a symbolic link.  If the referenced file is the one most recently returned by B<fts_read>(), the next call to B<fts_read>()  returns the file with the I<fts_info> and I<fts_statp> fields reinitialized to reflect the target of the symbolic link instead of the symbolic link itself.  If the file is one of those most recently returned by B<fts_children>(), the I<fts_info> and I<fts_statp> fields of the structure, when returned by B<fts_read>(), will reflect the target of the symbolic link instead of the symbolic link itself.  In either case, if the target of the symbolic link does not exist, the fields of the returned structure will be unchanged and the I<fts_info> field will be set to B<FTS_SLNONE>.
fr: Le fichier référencé doit être un lien symbolique. Si ce fichier est le dernier renvoyé par B<fts_read>(), alors l'appel suivant de B<fts_read>() renverra le fichier, avec les champs I<fts_info> et I<fts_statp> réinitialisés pour représenter la cible du lien symbolique plutôt que le lien lui-même. Si le fichier est le dernier renvoyé par B<fts_children>(), alors les membres I<fts_info> et I<fts_statp> de la structure, lorsqu'elle sera renvoyée par B<fts_read>(), représenteront la cible du lien symbolique plutôt que le lien lui-même. Dans tous les cas, si la cible du lien symbolique n'existe pas, les membres de la structure ne seront pas modifiés, et le champ I<fts_info> contiendra B<FTS_SLNONE>.

note: type: Plain text
en: If the target of the link is a directory, the preorder return, followed by the return of all of its descendants, followed by a postorder return, is done.
fr: Si la cible du lien est un répertoire, il y aura un retour «\ preorder\ », suivi d'un retour pour chaque descendant, suivi d'un retour «\ postorder\ ».

note: .El type: Plain text
en: No descendants of this file are visited.  The file may be one of those most recently returned by either B<fts_children>()  or B<fts_read>().
fr: Aucun descendant de ce fichier ne sera visité. Le fichier doit être le dernier renvoyé par B<fts_children>() ou B<fts_read>().

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The function B<fts_open>()  may fail and set I<errno> for any of the errors specified for B<open>(2)  and B<malloc>(3).
fr: La fonction B<fts_open>() peut échouer, et mettre dans I<errno> l'une des erreurs indiquées pour les fonctions B<open>(2) et B<malloc>(3).

note: type: Plain text
en: The function B<fts_close>()  may fail and set I<errno> for any of the errors specified for B<chdir>(2)  and B<close>(2).
fr: La fonction B<fts_close>() peut échouer, et mettre dans I<errno> l'une des erreurs indiquées pour les fonctions B<chdir>(2) et B<close>(2).

note: type: Plain text
en: These functions are available in Linux since glibc2.
fr: Ces fonctions sont disponibles sous Linux depuis la glibc2.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: tbl table
en: Value
fr: Valeur

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

note: type: SH
en: BUGS
fr: BOGUES

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/.
