perkamon - en to fr translation catalogue (87 entries)

note: type: TH
en: 2023-07-20
fr: 20 juillet 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: 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: 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: The fts functions are provided for traversing file hierarchies.  A simple overview is that the B<fts_open>()  function returns a "handle" (of type I<FTS\ *>)  that refers to a file hierarchy "stream".  This handle is then supplied to the other fts functions.  The function B<fts_read>()  returns a pointer to a structure describing one of the files in the file hierarchy.  The function B<fts_children>()  returns a pointer to a linked list of structures, each of which describes one of the files contained in a directory in the hierarchy.
fr: Les fonctions de la famille fts servent à traverser des hiérarchies de fichiers. Disons rapidement que la fonction B<fts_open>() renvoie un descripteur («\ handler\ » —\ de type I<FTS\ *>) qui fait référence à un «\ flux\ » de hiérarchie de fichiers. Ce descripteur est ensuite fourni aux autres fonctions de la famille fts. La fonction B<fts_read>() renvoie un pointeur sur une structure décrivant l'un des fichiers de l'arborescence. La fonction B<fts_children>() renvoie un pointeur sur une liste chaînée de structures, chacune décrivant l'un des fichiers contenu dans un répertoire de la hiérarchie.

note: type: Plain text
en: In general, directories are visited two distinguishable times; in preorder (before any of their descendants are visited) and in postorder (after all of their descendants have been visited).  Files are visited once.  It is possible to walk the hierarchy "logically" (visiting the files that symbolic links point to)  or physically (visiting the symbolic links themselves), order the walk of the hierarchy or prune and/or revisit portions of the hierarchy.
fr: En général, les répertoires sont visités à deux reprises distinctes. Un passage en ordre «\ preorder\ » (avant d'avoir parcouru leurs descendants) et un passage en ordre «\ postorder\ » (après avoir visité tous les sous-répertoires). Les fichiers ne sont examinés qu'une seule fois. Il est possible de parcourir la hiérarchie «\ logiquement\ » (en visitant les fichiers pointés par les liens symboliques) ou «\ physiquement\ » (en visitant les liens symboliques eux-mêmes). On peut ordonner le parcours de la hiérarchie, ignorer ou visiter plusieurs fois certaines parties.

note: type: Plain text
en: Two structures (and associated types) are defined in the include file I<E<lt>fts.hE<gt>>.  The first type is I<FTS>, the structure that represents the file hierarchy itself.  The second type is I<FTSENT>, the structure that represents a file in the file hierarchy.  Normally, an I<FTSENT> structure is returned for every file in the file hierarchy.  In this manual page, "file" and "FTSENT structure" are generally interchangeable.
fr: Deux structures (et les types associés) sont définies dans le fichier include I<E<lt>fts.hE<gt>>. Le premier type est I<FTS>, une structure représentant l'arborescence des fichiers elle-même. Le second est I<FTSENT>, la structure représentant un fichier dans la hiérarchie. Normalement, une structure I<FTSENT> est renvoyée pour chaque fichier rencontré dans la hiérarchie. Dans cette page de manuel, les termes «\ fichier\ » et «\ structure FTSENT\ » sont généralement interchangeables.

note: type: Plain text
en: The I<FTSENT> structure contains fields describing a file.  The structure contains at least the following fields (there are additional fields that should be considered private to the implementation):
fr: La structure I<FTSENT> contient les champs décrivant un ficher. La structure contient au moins les champs suivants (il y a des champs supplémentaires qui doivent être considérés comme réservés à l'implémentation).

note: Also: ino_t fts_ino;                  /* inode (only for directories)*/ dev_t fts_dev;                  /* device (only for directories)*/ nlink_t fts_nlink;              /* link count (only for directories)*/ u_short fts_flags;              /* private flags for FTSENT structure */ u_short fts_instr
en: typedef struct _ftsent {
        unsigned short  fts_info;     /* flags for FTSENT structure */
        char           *fts_accpath;  /* access path */
        char           *fts_path;     /* root path */
        short           fts_pathlen;  /* strlen(fts_path) +
                                         strlen(fts_name) */
        char           *fts_name;     /* filename */
        short           fts_namelen;  /* strlen(fts_name) */
        short           fts_level;    /* depth (-1 to N) */
        int             fts_errno;    /* file errno */
        long            fts_number;   /* local numeric value */
        void           *fts_pointer;  /* local address value */
        struct _ftsent *fts_parent;   /* parent directory */
        struct _ftsent *fts_link;     /* next file structure */
        struct _ftsent *fts_cycle;    /* cycle structure */
        struct stat    *fts_statp;    /* [l]stat(2) information */
    } FTSENT;
fr: typedef struct _ftsent {
        unsigned short fts_info;     /* attribut de la structure FTSENT */
        char          *fts_accpath;  /* chemin d'accès */
        char          *fts_path;     /* chemin de la racine */
        short           fts_pathlen;  /* strlen(fts_path) +
                                         strlen(fts_name) */
        char          *fts_name;     /* nom du fichier */
        short          fts_namelen;  /* strlen(fts_name) */
        short          fts_level;    /* profondeur (-1 à N) */
        int            fts_errno;    /* fichier errno */
        long           fts_number;   /* valeur numérique locale */
        void          *fts_pointer;  /* valeur de l'adresse locale */
        struct ftsent *fts_parent;   /* répertoire parent */
        struct ftsent *fts_link;     /* fichier de structure suivant */
        struct ftsent *fts_cycle;    /* structure de boucle */
        struct stat   *fts_statp;    /* information [l]stat(2) */
    } FTSENT;

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

note: .Bl  -tag -width FTS_DEFAULT type: Plain text
en: One of the following values describing the returned I<FTSENT> structure and the file it represents.  With the exception of directories without errors (B<FTS_D>), all of these entries are terminal, that is, they will not be revisited, nor will any of their descendants be visited.
fr: L'un des attributs suivants, décrivant la structure I<FTSENT> renvoyée et le fichier qu'elle représente. À l'exception des répertoires B<FTS_D> ne présentant pas d'erreur, toutes ces entrées sont terminales, ce qui signifie qu'elles ne seront visitées qu'une seule fois et que leur éventuels descendants (des répertoires en erreur) ne seront pas visités.

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

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 pour indiquer la cause de l'erreur.

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<l>]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<l>]B<stat>(2) n'est disponible. Le contenu du champ I<fts_statp> est indéfini. Il s'agit d'un cas d'erreur et le champ I<fts_errno> sera défini pour indiquer la cause de l'erreur.

note: type: Plain text
en: A file for which no [B<l>]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<l>]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 informations caractéristiques de fichier 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 sum of the lengths of the strings referenced by I<fts_path> and I<fts_name>.
fr: La somme des longueurs des chaînes pointées par I<fts_path> et I<fts_name>.

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 (ou racine) 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: If B<fts_children>()  or B<fts_read>()  returns an I<FTSENT> structure whose I<fts_info> field is set to B<FTS_DNR>, B<FTS_ERR>, or B<FTS_NS>, the I<fts_errno> field contains the error number (i.e., the I<errno> value)  specifying the cause of the error.  Otherwise, the contents of the I<fts_errno> field are undefined.
fr: Dans une structure I<FTSENT> renvoyée par un appel B<fts_children>() ou B<fts_read>(), dont le champ I<fts_info> contient B<FTS_DNR>, B<FTS_ERR> ou B<FTS_NS>, le champ I<fts_errno> est le numéro d'erreur (c'est-à-dire, la valeur de I<errno>) indiquant la cause de l'erreur. Dans les autres cas, le contenu du champ I<fts_errno> est indéfini.

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 initialisé à B<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 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: A pointer to the I<FTSENT> structure referencing the file in the hierarchy immediately above the current file, that is, the directory of which this file is a member.  A parent structure for the initial entry point is provided as well, however, only the I<fts_level>, I<fts_number>, and I<fts_pointer> fields are guaranteed to be initialized.
fr: Un pointeur sur la structure I<FTSENT> référençant le fichier dans la hiérarchie immédiatement au dessus du fichier en cours, c'est-à-dire le répertoire auquel il appartient. Une structure parente pour le point d'entrée initial est également fournie, mais seuls ses membres I<fts_level>, I<fts_number> et I<fts_pointer> sont garantis d'être initialisés.

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épertoire, 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<l>]B<stat>(2)  information for the file.
fr: Un pointeur vers les informations fournies par [B<l>]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 NULL 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 tampon du chemin soit modifié avec l'information contenue 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 NULL.

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>, 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 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: the I<fts_statp> field is obtained via B<stat>(2)  with a fallback to B<lstat>(2).
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 des fichiers qui n'existent pas : le champ I<fts_statp> est obtenu au moyen de B<stat>(2) avec un repli vers B<lstat>(2).

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: the I<fts_statp> field is obtained via B<lstat>(2).
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 : le champ I<fts_statp> est obtenu au moyen de B<lstat>(2).

note: type: Plain text
en: This option causes any symbolic link specified as a root path to be followed immediately, as if via B<FTS_LOGICAL>, regardless of the primary mode.
fr: Tout lien symbolique indiqué comme racine du parcours sera immédiatement suivi, comme au moyen de B<FTS_LOGICAL>, indépendamment du mode primaire.

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.  This 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. Cette option 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êmes 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<fts_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<fts_statp> field undefined.
fr: Par défaut, les structures I<FTSENT> renvoyées contiennent les caractéristiques (voir le champ I<fts_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<fts_statp> indéfini.

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 fourni 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 argument B<compar>()  specifies a user-defined function which may be used to order the traversal of the hierarchy.  It takes two pointers to pointers to I<FTSENT> structures as arguments and should return a negative value, zero, or a positive value to indicate if the file referenced by its first argument comes before, in any order with respect to, or after, the file referenced by its second argument.  The I<fts_accpath>, I<fts_path>, and I<fts_pathlen> fields of the I<FTSENT> structures may I<never> be used in this comparison.  If the I<fts_info> field is set to B<FTS_NS> or B<FTS_NSOK>, the I<fts_statp> field may not either.  If the B<compar>()  argument is NULL, the directory traversal order is in the order listed in I<path_argv> for the root paths, and in the order listed in the directory for everything else.
fr: L'argument B<compar>() indique une fonction définie par l'utilisateur pour ordonner la traversée de la hiérarchie. Elle prend en argument deux pointeurs sur des pointeurs sur des structures I<FTSENT>, et doit renvoyer une valeur négative, zéro ou positive pour indiquer que le fichier représenté par le premier argument doit venir avant, à n'importe quel moment ou après le fichier référencé par le second argument. Les champs I<fts_accpath>, I<fts_path> et I<fts_pathlen> des structures I<FTSENT> ne doivent I<jamais> être utilisés dans cette comparaison. Si le champ I<fts_info> contient B<FTS_NS> ou B<FTS_NSOK>, le membre I<fts_statp> ne doit pas être utilisé non plus. Si l'argument B<compar>() est NULL, l'ordre de traversée des répertoires est celui de l'argument I<path_argv> pour les racines, et l'ordre interne des répertoires pour le reste.

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 fois 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 I<errno> to 0.  If an error unrelated to a file in the hierarchy occurs, B<fts_read>()  returns NULL and sets I<errno> to indicate the error.  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 B<0>. Si une erreur sans rapport avec un fichier particulier se produit, B<fts_read>() renvoie NULL et définit I<errno> pour indiquer l'erreur. 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 flux de hiérarchie de fichiers ou après un appel à B<fts_read>() sur la même flux de 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> to indicate the error.
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é à 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> pour indiquer l'erreur.

note: type: Plain text
en: The I<FTSENT> structures returned by B<fts_children>()  may be overwritten after a call to B<fts_children>(), B<fts_close>(), or B<fts_read>()  on the same file hierarchy stream.
fr: Les structures I<FTSENT> renvoyées par B<fts_children>() peuvent être écrasées après un appel à B<fts_children>(), B<fts_close>() ou B<fts_read>() sur le même flux de hiérarchie de fichiers.

note: .Bl -tag -width FTS_NAMEONLY type: Plain text
en: The I<instr> argument is either zero or the following value:
fr: L'argument I<flags> est soit zéro, soit la valeur suivante\ :

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: The function B<fts_set>()  allows the user application to determine further processing for the file I<f> of the stream I<ftsp>.  The B<fts_set>()  function returns 0 on success, and -1 if an error occurs.
fr: La fonction B<fts_set>() permet à l'application de l'utilisateur de paramétrer le traitement à venir du fichier I<f> du flux I<ftsp>. La fonction B<fts_set>() renvoie B<0> si elle réussit, et B<-1> si une erreur se produit.

note: .Bl -tag -width FTS_PHYSICAL type: Plain text
en: The I<instr> argument is either 0 (meaning "do nothing") or one of the following values:
fr: L'argument I<instr> est un B<0> (signifiant «\ ne rien faire\ ») ou une des valeurs suivantes\ :

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 des derniers renvoyés 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 peut être un de ceux renvoyés le plus récemment par B<fts_children>() ou B<fts_read>().

note: type: Plain text
en: The B<fts_close>()  function closes the file hierarchy stream referred to by I<ftsp> and restores the current directory to the directory from which B<fts_open>()  was called to open I<ftsp>.  The B<fts_close>()  function returns 0 on success, and -1 if an error occurs.
fr: La fonction B<fts_close>() ferme le flux de hiérarchie de fichiers auquel I<ftsp> fait référence et restitue le répertoire de travail qui était en vigueur lors de l'appel B<fts_open>() qui avait permit d'ouvrir I<ftsp>. La fonction B<fts_close>() renvoie B<0> si elle réussit, et B<-1> en cas d'erreur.

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: The functions B<fts_read>()  and B<fts_children>()  may fail and set I<errno> for any of the errors specified for B<chdir>(2), B<malloc>(3), B<opendir>(3), B<readdir>(3), and [B<l>]B<stat>(2).
fr: Les fonctions B<fts_read>() et B<fts_children>() peuvent échouer et mettre dans I<errno> l'une des erreurs indiquées pour les fonctions B<chdir>(2), B<malloc>(3), B<opendir>(3), B<readdir>(3) et [B<l>]B<stat>(2).

note: type: Plain text
en: In addition, B<fts_children>(), B<fts_open>(), and B<fts_set>()  may fail and set I<errno> as follows:
fr: De plus B<fts_children>(), B<fts_open>() et B<fts_set>() peuvent échouer et mettre dans I<errno> l'une des erreurs suivantes\ :

note: type: Plain text
en: I<options> or I<instr> was invalid.
fr: Les I<options> ou les I<instr> ne sont pas valables.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: Plain text
en: For an explanation of the terms used in this section, see B<attributes>(7).
fr: Pour une explication des termes utilisés dans cette section, consulter B<attributes>(7).

note: type: tbl table
en: Attribute
fr: Attribut

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

note: type: tbl table
en: Thread safety
fr: Sécurité des threads

note: type: Plain text
en: None.
fr: Aucune.

note: type: SH
en: HISTORY
fr: HISTORIQUE

note: type: Plain text
en: glibc 2.  4.4BSD.
fr: glibc 2. 4.4BSD.

note: type: SH
en: BUGS
fr: BOGUES

note: Fixed by commit 8b7b7f75d91f7bac323dd6a370aeb3e9c5c4a7d5 https://sourceware.org/bugzilla/show_bug.cgi?id=15838 https://sourceware.org/bugzilla/show_bug.cgi?id=11460 The following statement is years old, and seems no closer to being true -- mtk The .I fts utility is expected to be included in a futur
en: Before glibc 2.23, all of the APIs described in this man page are not safe when compiling a program using the LFS APIs (e.g., when compiling with I<-D_FILE_OFFSET_BITS=64>).
fr: Avant la glibc 2.23, aucune des interfaces de programmation décrites dans cette page de manuel n’est sûre lors de la compilation d’un programme utilisant les interfaces de programmation LFS (par exemple, lors de la compilation avec I<-D_FILE_OFFSET_BITS=64>).

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

note: type: TH
en: 2022-12-15
fr: 15 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: These functions are available in Linux since glibc2.
fr: Ces fonctions sont disponibles sous Linux depuis la glibc2.

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

note: type: TH
en: 2023-03-30
fr: 30 mars 2023

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