perkamon - en to fr translation catalogue (48 entries)

note: type: TH
en: 2019-03-06
fr: 6 mars 2019

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: glob, globfree - find pathnames matching a pattern, free memory from glob()
fr: glob, globfree - Rechercher un chemin d'accès correspondant à un motif

note: type: Plain text
en: The B<glob>()  function searches for all the pathnames matching I<pattern> according to the rules used by the shell (see B<glob>(7)).  No tilde expansion or parameter substitution is done; if you want these, use B<wordexp>(3).
fr: La fonction B<glob>() recherche tous les chemins d'accès correspondant au motif I<pattern> en utilisant les règles du shell (consultez B<glob>(7)). Aucun remplacement de tilde ou substitution de paramètre n'est effectué. Si vous avez besoin de ces fonctionnalités, utilisez B<wordexp>(3).

note: type: Plain text
en: The B<globfree>()  function frees the dynamically allocated storage from an earlier call to B<glob>().
fr: La fonction B<globfree>() libère la mémoire allouée dynamiquement lors d'un appel précédent à B<glob>().

note: type: Plain text
en: The results of a B<glob>()  call are stored in the structure pointed to by I<pglob>.  This structure is of type I<glob_t> (declared in I<E<lt>glob.hE<gt>>)  and includes the following elements defined by POSIX.2 (more may be present as an extension):
fr: Les résultats d'un appel à B<glob>() sont stockés dans une structure pointée par I<pglob>. Cette structure est de type I<glob_t> (défini dans I<E<lt>glob.hE<gt>>) et inclut les éléments définis par POSIX.2 (il peut y en avoir plus sous forme d'extension GNU)\ :

note: type: Plain text
en: typedef struct {
        size_t   gl_pathc;    /* Count of paths matched so far  */
        char   **gl_pathv;    /* List of matched pathnames.  */
        size_t   gl_offs;     /* Slots to reserve in I<gl_pathv>.  */
    } glob_t;
fr: typedef struct {
        size_t   gl_pathc;    /* Nombre de chemins correspondant  */
        char   **gl_pathv;    /* Liste des chemins correspondant  */
        size_t   gl_offs;     /* Entrées à réserver dans I<gl_pathv>.  */
    } glob_t;

note: type: Plain text
en: Results are stored in dynamically allocated storage.
fr: Les résultats sont sauvés dans une zone allouée dynamiquement.

note: type: Plain text
en: The argument I<flags> is made up of the bitwise OR of zero or more the following symbolic constants, which modify the behavior of B<glob>():
fr: Le paramètre I<flags> est constitué d'un OU binaire «\ |\ » entre zéro ou plus des constantes symboliques suivantes, modifiant le comportement de B<glob>()\ :

note: type: Plain text
en: Return upon a read error (because a directory does not have read permission, for example).  By default, B<glob>()  attempts carry on despite errors, reading all of the directories that it can.
fr: Terminer dès qu'une erreur se produit (par exemple, un répertoire non lisible). Par défaut, B<glob>() tente, malgré les erreurs, de lire tous les répertoires qu'il peut.

note: type: Plain text
en: Append a slash to each path which corresponds to a directory.
fr: Ajoute une barre oblique finale à chaque nom correspondant à un répertoire.

note: type: Plain text
en: Don't sort the returned pathnames.  The only reason to do this is to save processing time.  By default, the returned pathnames are sorted.
fr: Ne pas trier les chemins d'accès renvoyés. La seule raison pour faire cela est d'économiser du temps de traitement. Par défaut, les chemins d'accès renvoyés sont triés.

note: type: Plain text
en: Reserve I<pglob-E<gt>gl_offs> slots at the beginning of the list of strings in I<pglob-E<gt>pathv>.  The reserved slots contain null pointers.
fr: Réserve I<pglob-E<gt>gl_offs> points d'entrée au début de la liste de chaînes dans I<pglob-E<gt>pathv>. Les points d'entrée réservés contiennent des pointeurs NULL.

note: type: Plain text
en: If no pattern matches, return the original pattern.  By default, B<glob>()  returns B<GLOB_NOMATCH> if there are no matches.
fr: Si aucun motif ne correspond, renvoyer le motif original. Par défaut, B<glob>() renvoie B<GLOB_NOMATCH> s'il n'y a pas de correspondance.

note: type: Plain text
en: Append the results of this call to the vector of results returned by a previous call to B<glob>().  Do not set this flag on the first invocation of B<glob>().
fr: Ajoute les résultats de cet appel au tableau de résultats renvoyé par un appel précédent à B<glob>(). Ne pas indiquer cet attribut lors du premier appel de B<glob>().

note: type: Plain text
en: Don't allow backslash (\(aq\e\(aq) to be used as an escape character.  Normally, a backslash can be used to quote the following character, providing a mechanism to turn off the special meaning metacharacters.
fr: Ne pas permettre l'utilisation de barre oblique inverse (« \e ») pour désactiver les caractères d'échappement. Normalement, une barre oblique inverse peut être utilisée pour échapper le caractère qui le suit, fournissant un mécanisme de désactivation du sens particulier des méta-caractères.

note: type: Plain text
en: I<flags> may also include any of the following, which are GNU extensions and not defined by POSIX.2:
fr: I<flags> peut également utiliser les constantes suivantes, qui sont des extensions GNU, non définies dans POSIX.2\ :

note: type: Plain text
en: Allow a leading period to be matched by metacharacters.  By default, metacharacters can't match a leading period.
fr: Permettre à un point en tête de chemin de correspondre à un méta-caractère. Par défaut, les méta-caractères ne peuvent pas correspondre à un point en tête de chemin.

note: type: Plain text
en: Use alternative functions I<pglob-E<gt>gl_closedir>, I<pglob-E<gt>gl_readdir>, I<pglob-E<gt>gl_opendir>, I<pglob-E<gt>gl_lstat>, and I<pglob-E<gt>gl_stat> for filesystem access instead of the normal library functions.
fr: Utiliser les fonctions alternatives I<pglob-E<gt>gl_closedir>, I<pglob-E<gt>gl_readdir>, I<pglob-E<gt>gl_opendir>, I<pglob-E<gt>gl_lstat> et I<pglob-E<gt>gl_stat> pour l'accès au système de fichiers au lieu des fonctions normales de bibliothèque.

note: type: Plain text
en: Expand B<csh>(1)  style brace expressions of the form B<{a,b}>.  Brace expressions can be nested.  Thus, for example, specifying the pattern "{foo/{,cat,dog},bar}" would return the same results as four separate B<glob>()  calls using the strings: "foo/", "foo/cat", "foo/dog", and "bar".
fr: Développer dans le style B<csh>(1) les expressions de type B<{a,b}>. Les expressions entre accolades peuvent être imbriquées. Ainsi, par exemple, spécifier le motif « {foo/{,cat,dog},bar} » retournera le même résultat que quatre appels à B<glob>() séparés utilisant les chaînes : « foo/ », « foo/cat », « foo/dog », et « bar ».

note: type: Plain text
en: If the pattern contains no metacharacters, then it should be returned as the sole matching word, even if there is no file with that name.
fr: Si le motif renvoyé ne contient pas de méta-caractères, il sera retourné comme seul mot correspondant, même s'il n'existe pas de fichier avec ce nom.

note: type: Plain text
en: Carry out tilde expansion.  If a tilde (\(aq~\(aq) is the only character in the pattern, or an initial tilde is followed immediately by a slash (\(aq/\(aq), then the home directory of the caller is substituted for the tilde.  If an initial tilde is followed by a username (e.g., "~andrea/bin"), then the tilde and username are substituted by the home directory of that user.  If the username is invalid, or the home directory cannot be determined, then no substitution is performed.
fr: Prendre en charge l'expansion du tilde. Si un tilde (« ~ ») est le seul caractère du motif, ou si un tilde en tête est suivi par une barre oblique (« / »), le répertoire personnel de l'appelant sera substitué au tilde. Si un tilde en tête est suivi par un nom d'utilisateur (par exemple, « ~alain/bin », le tilde et le nom d'utilisateur sont substitués par le répertoire personnel de cet utilisateur. Si le nom d'utilisateur n'est pas valide ou si le répertoire personnel ne peut pas être déterminé, la substitution n'est pas effectuée.

note: type: Plain text
en: This provides behavior similar to that of B<GLOB_TILDE>.  The difference is that if the username is invalid, or the home directory cannot be determined, then instead of using the pattern itself as the name, B<glob>()  returns B<GLOB_NOMATCH> to indicate an error.
fr: Fournit un comportement similaire à celui de B<GLOB_TILDE>. La différence est que si le nom d'utilisateur n'est pas valable ou si le répertoire personnel ne peut pas être déterminé, plutôt que d'utiliser le motif lui-même comme nom, B<glob>() renvoie B<GLOB_NOMATCH> pour indiquer l'erreur.

note: type: Plain text
en: This is a I<hint> to B<glob>()  that the caller is interested only in directories that match the pattern.  If the implementation can easily determine file-type information, then nondirectory files are not returned to the caller.  However, the caller must still check that returned files are directories.  (The purpose of this flag is merely to optimize performance when the caller is interested only in directories.)
fr: C'est une I<indication> pour B<glob>() indiquant que l'appelant ne s'intéresse qu'aux répertoires correspondant au motif. Si l'implémentation peut facilement déterminer le type de fichier, les fichiers qui ne sont pas des répertoires ne sont pas renvoyés à l'appelant. Toutefois, l'appelant doit toujours vérifier que les fichiers renvoyés sont des répertoires (le but de cet attribut est simplement d'optimiser les performances lorsque l'appelant ne s'intéresse qu'aux répertoires).

note: type: Plain text
en: If I<errfunc> is not NULL, it will be called in case of an error with the arguments I<epath>, a pointer to the path which failed, and I<eerrno>, the value of I<errno> as returned from one of the calls to B<opendir>(3), B<readdir>(3), or B<stat>(2).  If I<errfunc> returns nonzero, or if B<GLOB_ERR> is set, B<glob>()  will terminate after the call to I<errfunc>.
fr: Si I<errfunc> n'est pas NULL, elle sera appelée en cas d'erreur, avec les arguments I<epath> un pointeur sur le chemin qui a échoué, et I<eerrno> la valeur de I<errno> telle qu'elle a été renvoyée par un appel à B<opendir>(3), B<readdir>(3) ou B<stat>(2). Si I<errfunc> renvoie une valeur non nulle, ou si B<GLOB_ERR> est positionné, B<glob>() se terminera après l'appel de I<errfunc>.

note: type: Plain text
en: Upon successful return, I<pglob-E<gt>gl_pathc> contains the number of matched pathnames and I<pglob-E<gt>gl_pathv> contains a pointer to the list of pointers to matched pathnames.  The list of pointers is terminated by a null pointer.
fr: Si B<glob>() réussit complètement, I<pglob-E<gt>gl_pathc> contient le nombre de chemins d'accès correspondants et I<pglob-E<gt>gl_pathv> contient un pointeur sur une liste des chemins. Le premier pointeur après le dernier chemin vaut NULL.

note: type: Plain text
en: It is possible to call B<glob>()  several times.  In that case, the B<GLOB_APPEND> flag has to be set in I<flags> on the second and later invocations.
fr: Il est possible d'appeler B<glob>() plusieurs fois. Dans ce cas, l'attribut B<GLOB_APPEND> doit être indiqué dans I<flags> durant le second appel et les suivants.

note: type: Plain text
en: As a GNU extension, I<pglob-E<gt>gl_flags> is set to the flags specified, B<or>ed with B<GLOB_MAGCHAR> if any metacharacters were found.
fr: En tant qu'extension GNU, le champ I<pglob-E<gt>gl_flags> contient les attributs indiqués liés par un B<OU> avec B<GLOB_MAGCHAR> si un méta-caractère a été trouvé.

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

note: type: Plain text
en: On successful completion, B<glob>()  returns zero.  Other possible returns are:
fr: S'il réussit complètement B<glob>() renvoie zéro. Les autres valeurs renvoyées peuvent être\ :

note: type: Plain text
en: for running out of memory,
fr: pas assez de mémoire,

note: type: Plain text
en: for a read error, and
fr: erreur de lecture,

note: type: Plain text
en: for no found matches.
fr: aucune correspondance trouvée.

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: Plain text
en: The structure elements I<gl_pathc> and I<gl_offs> are declared as I<size_t> in glibc 2.1, as they should be according to POSIX.2, but are declared as I<int> in glibc 2.0.
fr: Les éléments de la structure I<gl_pathc> et I<gl_offs> sont déclarés comme des  I<size_t> dans glibc 2.1, comme préconisé dans POSIX.2, mais sont déclarés sous forme de I<int> dans glibc 2.0.

note: type: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: The B<glob>()  function may fail due to failure of underlying function calls, such as B<malloc>(3)  or B<opendir>(3).  These will store their error code in I<errno>.
fr: La fonction B<glob>() peut échouer en cas d'erreur dans un appel de fonction sous-jacent, comme B<malloc>(3) ou B<opendir>(3). Le code d'erreur sera alors stocké dans I<errno>.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: One example of use is the following code, which simulates typing
fr: L'exemple d'utilisation suivant simule la frappe de

note: type: Plain text
en: in the shell:
fr: dans un shell\ :

note: type: Plain text
en: globbuf.gl_offs = 2;
    glob("*.c", GLOB_DOOFFS, NULL, &globbuf);
    glob("../*.c", GLOB_DOOFFS | GLOB_APPEND, NULL, &globbuf);
    globbuf.gl_pathv[0] = "ls";
    globbuf.gl_pathv[1] = "-l";
    execvp("ls", &globbuf.gl_pathv[0]);
fr: globbuf.gl_offs = 2;
    glob("*.c", GLOB_DOOFS, NULL, &globbuf);
    glob("../*.c", GLOB_DOOFS | GLOB_APPEND, NULL, &globbuf);
    globbuf.gl_pathv[0] = "ls";
    globbuf.gl_pathv[1] = "-l";
    execvp("ls", &globbuf.gl_pathv[0]);

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