.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Wed Jul 28 11:12:17 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 13 23:08:50 1996 by Martin Schulze (joey@linux.de) .\" Modified 11 May 1998 by Joseph S. Myers (jsm28@cam.ac.uk) .\" Modified 990912 by aeb .\" 2007-10-10 mtk .\" Added description of GLOB_TILDE_NOMATCH .\" Expanded the description of various flags .\" Various wording fixes. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH glob 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM glob, globfree \- Rechercher un chemin d'accès correspondant à un motif .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint glob(const char *restrict \fP\fIpattern\fP\fB, int \fP\fIflags\fP\fB,\fP \fB int (*\fP\fIerrfunc\fP\fB)(const char *\fP\fIepath\fP\fB, int \fP\fIeerrno\fP\fB),\fP \fB glob_t *restrict \fP\fIpglob\fP\fB);\fP \fBvoid globfree(glob_t *\fP\fIpglob\fP\fB);\fP .fi .SH DESCRIPTION La fonction \fBglob\fP() recherche tous les chemins d'accès correspondant au motif \fIpattern\fP en utilisant les règles du shell (consultez \fBglob\fP(7)). Aucun remplacement de tilde ou substitution de paramètre n'est effectué. Si vous avez besoin de ces fonctionnalités, utilisez \fBwordexp\fP(3). .PP La fonction \fBglobfree\fP() libère la mémoire allouée dynamiquement lors d'un appel précédent à \fBglob\fP(). .PP Les résultats d'un appel à \fBglob\fP() sont stockés dans une structure pointée par \fIpglob\fP. Cette structure est de type \fIglob_t\fP (défini dans \fI\fP) et inclut les éléments définis par POSIX.2 (il peut y en avoir plus sous forme d'extension GNU)\ : .PP .in +4n .EX 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 \fIgl_pathv\fP. */ } glob_t; .EE .in .PP Les résultats sont sauvés dans une zone allouée dynamiquement. .PP Le paramètre \fIflags\fP est constitué d'un OU binaire «\ |\ » entre zéro ou plus des constantes symboliques suivantes, modifiant le comportement de \fBglob\fP()\ : .TP \fBGLOB_ERR\fP Terminer dès qu'une erreur se produit (par exemple, un répertoire non lisible). Par défaut, \fBglob\fP() tente, malgré les erreurs, de lire tous les répertoires qu'il peut. .TP \fBGLOB_MARK\fP Ajoute une barre oblique finale à chaque nom correspondant à un répertoire. .TP \fBGLOB_NOSORT\fP 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. .TP \fBGLOB_DOOFFS\fP Réserve \fIpglob\->gl_offs\fP points d'entrée au début de la liste de chaînes dans \fIpglob\->pathv\fP. Les points d'entrée réservés contiennent des pointeurs NULL. .TP \fBGLOB_NOCHECK\fP Si aucun motif ne correspond, renvoyer le motif original. Par défaut, \fBglob\fP() renvoie \fBGLOB_NOMATCH\fP s'il n'y a pas de correspondance. .TP \fBGLOB_APPEND\fP Ajoute les résultats de cet appel au tableau de résultats renvoyé par un appel précédent à \fBglob\fP(). Ne pas indiquer cet attribut lors du premier appel de \fBglob\fP(). .TP \fBGLOB_NOESCAPE\fP 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. .PP \fIflags\fP peut également utiliser les constantes suivantes, qui sont des extensions GNU, non définies dans POSIX.2\ : .TP \fBGLOB_PERIOD\fP 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. .TP \fBGLOB_ALTDIRFUNC\fP Utiliser les fonctions alternatives \fIpglob\->gl_closedir\fP, \fIpglob\->gl_readdir\fP, \fIpglob\->gl_opendir\fP, \fIpglob\->gl_lstat\fP et \fIpglob\->gl_stat\fP pour l'accès au système de fichiers au lieu des fonctions normales de bibliothèque. .TP \fBGLOB_BRACE\fP Développer dans le style \fBcsh\fP(1) les expressions de type \fB{a,b}\fP. 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 à \fBglob\fP() séparés utilisant les chaînes\ : «\ foo/\ », «\ foo/cat\ », «\ foo/dog\ », et «\ bar\ ». .TP \fBGLOB_NOMAGIC\fP 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. .TP \fBGLOB_TILDE\fP 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. .TP \fBGLOB_TILDE_CHECK\fP Fournit un comportement similaire à celui de \fBGLOB_TILDE\fP. 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, \fBglob\fP() renvoie \fBGLOB_NOMATCH\fP pour indiquer l'erreur. .TP \fBGLOB_ONLYDIR\fP C'est une \fIindication\fP pour \fBglob\fP() 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). .PP Si \fIerrfunc\fP n'est pas NULL, elle sera appelée en cas d'erreur, avec les arguments \fIepath\fP un pointeur sur le chemin qui a échoué, et \fIeerrno\fP la valeur de \fIerrno\fP telle qu'elle a été renvoyée par un appel à \fBopendir\fP(3), \fBreaddir\fP(3) ou \fBstat\fP(2). Si \fIerrfunc\fP renvoie une valeur non nulle, ou si \fBGLOB_ERR\fP est positionné, \fBglob\fP() se terminera après l'appel de \fIerrfunc\fP. .PP Si \fBglob\fP() réussit complètement, \fIpglob\->gl_pathc\fP contient le nombre de chemins d'accès correspondants et \fIpglob\->gl_pathv\fP contient un pointeur sur une liste des chemins. Le premier pointeur après le dernier chemin vaut NULL. .PP Il est possible d'appeler \fBglob\fP() plusieurs fois. Dans ce cas, l'attribut \fBGLOB_APPEND\fP doit être indiqué dans \fIflags\fP durant le second appel et les suivants. .PP En tant qu'extension GNU, le champ \fIpglob\->gl_flags\fP contient les attributs indiqués liés par un \fBOU\fP avec \fBGLOB_MAGCHAR\fP si un méta\-caractère a été trouvé. .SH "VALEUR RENVOYÉE" S'il réussit complètement \fBglob\fP() renvoie zéro. Les autres valeurs renvoyées peuvent être\ : .TP \fBGLOB_NOSPACE\fP pas assez de mémoire, .TP \fBGLOB_ABORTED\fP erreur de lecture, et .TP \fBGLOB_NOMATCH\fP aucune correspondance trouvée. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. Interface Attribut Valeur T{ .na .nh \fBglob\fP() T} Sécurité des threads T{ .na .nh MT\-Unsafe race:utent env sig:ALRM timer locale T} T{ .na .nh \fBglobfree\fP() T} Sécurité des threads MT\-Safe .TE .sp 1 Dans le tableau ci\-dessus, \fIutent\fP dans \fIrace:utent\fP signifie que si des fonctions parmi \fBsetutent\fP(3), \fBgetutent\fP(3) ou \fBendutent\fP(3) sont utilisées en parallèle dans différents threads d'un programme, des situations de compétition entre données pourraient apparaître. \fBglob\fP() appelle ces fonctions, nous utilisons donc race:utent pour le rappeler aux utilisateurs. .SH STANDARDS POSIX.1\-2008. .SH HISTORIQUE POSIX.1\-2001, POSIX.2. .SH NOTES Les éléments de la structure \fIgl_pathc\fP et \fIgl_offs\fP sont déclarés comme des \fIsize_t\fP dans glibc 2.1, comme préconisé dans POSIX.2, mais sont déclarés sous forme de \fIint\fP dans glibc 2.0. .SH BOGUES La fonction \fBglob\fP() peut échouer en cas d'erreur dans un appel de fonction sous\-jacent, comme \fBmalloc\fP(3) ou \fBopendir\fP(3). Le code d'erreur sera alors stocké dans \fIerrno\fP. .SH EXEMPLES L'exemple d'utilisation suivant simule la frappe de .PP .in +4n .EX ls \-l *.c ../*.c .EE .in .PP dans un shell\ : .PP .in +4n .EX glob_t globbuf; \& 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]); .EE .in .SH "VOIR AUSSI" \fBls\fP(1), \fBsh\fP(1), \fBstat\fP(2), \fBexec\fP(3), \fBfnmatch\fP(3), \fBmalloc\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBwordexp\fP(3), \fBglob\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Frédéric Hantrais et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .