Informations générales sur le programme¶

--help

Afficher un message d'utilisation et quitter.

-V, --version

Afficher le numéro de version de grep et quitter.

Sélection des correspondances¶

-E, --extended-regexp

Interpréter le MOTIF comme une expression rationnelle étendue (ERE, voir ci-dessous).

-F, --fixed-strings

Interpréter le MOTIF comme étant une chaîne figée, pas une expression rationnelle.

-G, --basic-regexp

Interpréter le MOTIF comme une expression rationnelle simple (BRE, voir ci-dessous). C'est le comportement par défaut.

-P, --perl-regexp

Interpréter le MOTIF comme une expression rationnelle Perl (PCRE, voir ci-dessous). Cette option est expérimentale quand on la combine à -z (--null-data) et grep -P pourrait signaler des fonctionnalités non implémentées.

Contrôle de correspondance¶

-e MOTIF, --regexp=MOTIF

Utiliser MOTIF comme motif. Si cette option est utilisée plusieurs fois ou en combinaison avec l'option -f (-\^-file), rechercher les motifs donnés. Cette option peut être utilisée pour protéger un motif commençant par « - ».

-f FICHIER, --file=FICHIER

Utiliser les motifs depuis FICHIER, un par ligne. Si cette option est utilisée plusieurs fois ou combinée avec l'option -e (--regexp), rechercher tous les motifs donnés. Un fichier vide ne contient pas de motif et ne donne donc aucun résultat.

-i, --ignore-case

Ignorer les distinctions de casse pour que les caractères qui ne diffèrent que par la casse correspondent entre eux.

-v, --invert-match

Inverser la mise en correspondance, pour sélectionner les lignes ne correspondant pas au motif.

-w, --word-regexp

Ne sélectionner que les lignes contenant des correspondances formant des mots complets. La sous-chaîne correspondante doit donc soit se trouver au début de la ligne, soit être précédée d'un caractère ne pouvant entrer dans la constitution d'un mot. De même, elle doit soit se trouver à la fin de la ligne, soit être suivie par un caractère ne pouvant entrer dans la constitution d'un mot. Les caractères composant les mots sont les lettres, les chiffres et le souligné « _ ». Cette option est sans effet si -x est également spécifié.

-x, --line-regexp

Ne sélectionner que les correspondances exactes de ligne entière. Pour un motif d'expression rationnelle, c'est comme si on met le motif entre parenthèses et qu'on l'ancre entre ^ et $.

-y

Synonyme obsolète de -i.

Contrôle général de l'affichage¶

-c, --count

Ne pas afficher les résultats normaux. À la place, afficher un décompte des lignes correspondant au motif pour chaque fichier. Avec l'option -v, --invert-match (voir ci-dessous), afficher le nombre de lignes ne contenant pas le motif.

--color[=QUAND], --colour[=QUAND]

Encadrer les chaînes (non vides) des correspondances, les lignes qui correspondent, les lignes de contexte, les noms de fichiers, les numéros de lignes, les positions relatives en octets et les séparateurs (pour les champs et groupes de lignes de contexte) avec des séquences d'échappement pour les afficher en couleur sur le terminal. Les couleurs sont définies par la variable d'environnement GREP_COLORS. L'ancienne variable d'environnement GREP_COLOR est toujours gérée, mais elle a une priorité inférieure pour décider de la configuration. QUAND vaut never (jamais), always (toujours) ou auto.

-L, --files-without-match

Ne pas afficher les résultats normaux. À la place, indiquer le nom des fichiers pour lesquels aucun résultat n'aurait été affiché. La recherche dans chaque fichier cesse dès la première correspondance.

-l, --files-with-matches

Ne pas afficher les résultats normaux. À la place, indiquer le nom des fichiers pour lesquels un résultat aurait été affiché. La recherche dans chaque fichier cesse dès la première correspondance.

-m N, --max-count=N

Arrêter de lire un fichier après avoir trouvé N lignes sélectionnées. Si l'entrée est l'entrée standard prise depuis un fichier normal, et si N lignes qui correspondent sont affichées, grep s'assure avant de s'arrêter que l'entrée standard est positionnée juste après la dernière ligne qui concorde, même s'il y a des lignes de contexte supplémentaires. Cela permet au processus d'appel de redémarrer une recherche. Quand grep s'arrête après N lignes de concordance, il affiche toutes les lignes de contexte suivantes. Quand l'option -c ou --count est utilisée, grep n'affiche pas plus de N lignes. Quand l'option -v ou --invert-match est aussi utilisée, grep s'arrête après avoir affiché N lignes qui ne contiennent pas le motif.

-o, --only-matching

N'afficher que les parties (non vides) correspondantes des lignes sélectionnées, chaque partie étant affichée sur une ligne séparée.

-q, --quiet, --silent

Silencieux ; ne rien écrire sur la sortie standard. Quitter immédiatement avec un code zéro si une correspondance a été trouvée même si une erreur a été détectée. Voir aussi l'option -s ou --no-messages.

-s, --no-messages

Supprimer les messages d'erreur sur la non existence ou l'illisibilité des fichiers.

Contrôle du préfixe à l'affichage¶

-b, --byte-offset

Afficher l'emplacement dans le fichier (qui commence à l'octet 0) devant chaque ligne de sortie. Si -o (--only-matching) est spécifiée, afficher l'emplacement de la partie qui correspond.

-H, --with-filename

Afficher le nom du fichier pour chaque correspondance. C'est le comportement par défaut quand la recherche est effectuée sur plusieurs fichiers.

-h, --no-filename

Ne pas afficher le nom des fichiers au début des lignes qui correspondent. C'est le comportement par défaut quand il n'y a qu'un fichier (ou que l'entrée standard) dans lequel effectuer la recherche.

--label=ÉTIQUETTE

Afficher les données provenant de l'entrée standard comme si elles provenaient du fichier ÉTIQUETTE. C'est particulièrement utile pour l'implémentation des outils comme zgrep, par exemple : gzip -cd truc.gz |grep --label=truc -H quelquechose. Consultez également l'option -H.

-n, --line-number

Préfixer chaque ligne de sortie par le numéro, débutant à un, de la ligne débutant dans le fichier.

-T, --initial-tab

S'assurer que le premier caractère correspondant au contenu réel de la ligne est placé à un emplacement d'arrêt d'une tabulation, pour que l'alignement des tabulations paraisse normal. Cela est utile avec les options qui utilisent un préfixe avant le contenu réel de la ligne : -H, -n et -b. Pour augmenter la probabilité que toutes les lignes d'un fichier commencent à la même colonne, cela force aussi le numéro de ligne et l'emplacement (s'ils sont présents) à être affichés dans un champ de taille minimale.

-u, --unix-byte-offsets

Afficher la position relative en octets dans le style UNIX. Avec cette option, grep affiche la position relative en octets comme si le fichier était un fichier de texte de type UNIX, c'est-à-dire avec les caractères CR supprimés. Cela permet d'avoir un résultat identique à celui retourné par grep sur une machine UNIX. Cette option n'a d'effet que si elle est utilisée conjointement avec l'option -b, et sur une machine MS-DOS ou MS-Windows.

-Z, --null

Afficher un octet NULL (le caractère ASCII NULL) à la place du caractère qui suit d'ordinaire le nom du fichier. Par exemple, grep -lZ affiche un octet NULL après chaque nom de fichier, à la place du changement de ligne. Cette option permet de rendre la sortie non ambiguë, même quand les noms de fichiers contiennent des caractères inhabituels, comme des changements de ligne. Cette option peut être utilisée avec des commandes telles que find -print0, perl -0, sort -z, et xargs -0 pour traiter des fichiers avec des noms quelconques, même ceux contenant des changements de ligne.

Contrôle des lignes de contexte¶

-A N, --after-context=N

Afficher les N lignes qui suivent celles contenant le motif. Une ligne contenant -- est insérée entre les groupes contigus de correspondances. Avec l'option -o ou --only-matching, ça n'a aucun effet et un avertissement est affiché.

-B N, --before-context=N

Afficher les N lignes qui précèdent celles contenant le motif. Une ligne contenant -- est insérée entre les groupes contigus de correspondances. Avec l'option -o ou --only-matching, ça n'a aucun effet et un avertissement est affiché.

-C N, -N, --context=N

Afficher N lignes de contexte. Une ligne contenant -- est insérée entre les groupes contigus de correspondances. Avec l'option -o ou --only-matching, ça n'a aucun effet et un avertissement est affiché.

Sélection de fichiers ou répertoires¶

-a, --text

Traiter un fichier binaire comme s'il s'agissait de texte ; c'est l'équivalent de l'option --binary-files=text.

--binary-files=TYPE

Si les données ou les métadonnées d'un fichier indiquent qu'il contient des données binaires, supposer que le fichier est de type TYPE. Les données non textuelles indiquent que le fichier est binaire ; ce sont soit des octets affichés mal encodés pour la locale, soit des octets NULL quand l'option -z n'est pas donnée.

Par défaut, TYPE est binary et quand grep trouve un fichier binaire, il supprime tout affichage supplémentaire et affiche soit un message d'une ligne indiquant qu'un fichier binaire correspond, soit rien s'il n'y a pas de correspondance.

Si TYPE vaut without-match, quand grep trouve un fichier binaire, il suppose que le reste du fichier ne correspond pas ; cela est équivalent à l'option -I.

Si TYPE vaut text, grep traite un fichier binaire comme un fichier texte ; c'est un équivalent de l'option -a.

Quand type est binary, grep peut traiter des données non textuelles comme des marqueurs de fin de ligne même sans l'option -z. Cela signifie que le choix binary versus text peut influer sur la correspondance d'un motif à un fichier. Par exemple, quand type est binary, le motif q$ might correspond à un q suivi immédiatement d'un octet NULL, alors que cela ne correspond à rien quand type est text. À l'inverse, quand type est binary, . (point) pourrait ne pas trouver d'octet NULL.

Attention : l'option -a pourrait afficher des déchets de binaire et avoir des effets indésirables si la sortie est le terminal et que le pilote du terminal les interprète comme des commandes. D'un autre côté, quand on lit des fichiers à l'encodage inconnu, il peut être utile d'utiliser -a ou de définir LC_ALL='C' dans l'environnement pour trouver plus de correspondances même si certaines ne sont pas sécurisées pour un affichage direct.

-D ACTION, --devices=ACTION

Si le fichier est un périphérique, une FIFO ou une socket, utiliser ACTION dessus. Par défaut, ACTION est read (lecture), ce qui signifie que les périphériques sont lus comme des fichiers normaux. Si ACTION est skip, les périphériques sont ignorés en silence.

-d ACTION, --directories=ACTION

Si le fichier est un répertoire, utiliser ACTION. Par défaut, ACTION est read, ce qui signifie que les répertoires sont lus comme des fichiers normaux. Si ACTION est skip, les répertoires sont ignorés et aucun message n'est affiché. Si ACTION est recurse, grep lit tous les fichiers présents dans chaque répertoire, récursivement, en ne suivant que les liens symboliques indiqués sur la ligne de commande. C'est équivalent à l'option -r.

--exclude=GLOB

Sauter tous les fichiers de la ligne de commande dont le suffixe de nom correspond au motif GLOB, en utilisant la correspondance de jokers ; le suffixe d'un nom est soit tout le nom, soit un suffixe commençant après une / jusqu'à un non /. Lors d'une recherche récursive, sauter tous les sous-fichiers dont le nom de base correspond à GLOB ; le nom de base est la partie après la dernière /. Un motif peut utiliser *, ? et [...] en tant que jokers, et \ pour interpréter littéralement les caractères joker ou barre oblique inversée.

--exclude-from=FICHIER

Sauter les fichiers dont le nom de fichier correspond à un des motifs contenus dans le FICHIER (en utilisant les jokers comme décrit pour --exclude).

--exclude-dir=GLOB

Sauter tout répertoire sur la ligne de commande dont le suffixe de nom correspond au motif GLOB. Lors d'une recherche récursive, sauter tout sous-répertoire dont le nom de base correspond à GLOB. Ignorer les barres obliques redondantes finales dans GLOB.

-I

Traiter un fichier binaire comme s'il ne contenait aucune correspondance ; c'est équivalent à l'option --binary-files=without-match.

--include=GLOB

Ne chercher que dans les fichiers dont le nom de fichier correspond à GLOB (en utilisant les jokers, comme décrit pour --exclude).

-r, --recursive

Lire récursivement tous les fichiers à l'intérieur de chaque répertoire, en ne suivant les liens symboliques que s'ils sont indiqués sur la ligne de commande. Remarquez que si vous ne donnez aucun opérande de fichier, grep recherche dans le répertoire courant. C'est l'équivalent de l'option -d recurse.

-R, --dereference-recursive

Lire récursivement tous les fichiers à l'intérieur de chaque répertoire. Suivre tous les liens symboliques, contrairement à -r.

Autres options¶

--line-buffered

Utiliser un tampon de ligne sur le flux de sortie. Cela peut réduire les performances.

-U, --binary

Traiter les fichiers comme s'ils étaient des fichiers binaires. Par défaut, sous MS-DOS et MS-Windows, grep détermine le type de fichier comme cela est décrit pour l'option --binary-files. Si grep décide que le fichier est un fichier de texte, il enlève les retours chariot (CR) du contenu du fichier original (afin que les expressions avec ^ et $ fonctionnent correctement). L'option -U modifie ce comportement, tous les fichiers sont alors lus et traités tels quels. Si le fichier est un fichier de texte avec des paires CR-LF en fin de ligne, certaines expressions rationnelles peuvent échouer. Cette option n'a aucun effet sur des plates-formes autres que MS-DOS et MS-Windows.

-z, --null-data

Traiter les données d’entrée et de sortie sous forme d’ensembles de lignes, chacune terminée par un octet NULL (le caractère ASCII NULL) au lieu d'un changement de ligne. Comme l'option -Z ou --null, cette option peut être combinée avec des commandes comme sort -z pour traiter des fichiers ayant un nom quelconque.

Classes de caractères et expressions entre crochets¶

Entre ces crochets, un intervalle de caractères consiste en deux caractères séparés par un tiret. Il correspond avec n'importe quel caractère compris entre les deux caractères caractère (ceux-ci inclus), l'ordre des caractères dépendant des paramètres régionaux (locale, en anglais) actuels. Ainsi, avec les paramètres par défaut (« C »), [a-d] est équivalent à [abcd]. Avec beaucoup de paramètres régionaux, les caractères sont triés en suivant l'ordre des dictionnaires, et [a-d] n'est alors en général pas équivalent à [abcd], mais peut l'être à [aBbCcDd], par exemple. Pour que ces listes aient le comportement habituel de « C », vous pouvez positionner la variable d'environnement LC_ALL à la valeur C.

Enfin, il existe certaines classes de caractères prédéfinies. Leurs noms sont assez explicites : [:alnum:], [:alpha:], [:cntrl:], [:digit:] (chiffres), [:graph:], [:lower:] (minuscules), [:print:] (affichables), [:punct:] (ponctuation), [:space:] (espace), [:upper:] (majuscules), et [:xdigit:] (chiffres hexadécimaux). Par exemple, [[:alnum:]] correspond aux chiffres et lettres pour les paramètres régionaux actuels. Dans les paramètres régionaux C et avec le codage de caractères ASCII, c'est équivalent à [0-9A-Za-z]. Remarquez que les crochets dans les noms de classes font partie intégrante du nom symbolique, et qu'ils doivent donc être inclus en plus des crochets encadrant ces expressions entre crochets. La plupart des métacaractères perdent leur signification particulière à l'intérieur d'une expression entre crochets. Pour inclure un caractère ], mettez-le en premier dans la liste. De même, pour inclure un caractère ^, placez-le n'importe où sauf au début de la liste. Enfin, pour inclure un -, placez-le en dernier.

Ancrage¶

Caractère contre-oblique et expressions spéciales¶

Répétitions¶

?

L'élément précédent est facultatif et peut être rencontré au plus une fois.

*

L'élément précédent peut être rencontré zéro ou plusieurs fois.

+

L'élément précédent peut être rencontré une ou plusieurs fois.

{n}

L'élément précédent doit correspondre exactement n fois.

{n,}

L'élément précédent doit correspondre n fois ou plus.

{,m}

L'élément précédent doit correspondre au plus m fois. C’est une extension GNU.

{n,m}

L'élément précédent doit correspondre au moins n fois, mais au plus m fois.

Concaténations¶

Alternatives¶

Priorités¶

Références arrières et sous-expressions¶

Expressions rationnelles basiques et étendues¶

Remonter des bogues¶

Bogues connus¶

Les références arrières sont très lentes et peuvent demander un temps très important (exponentiel).

Pages de manuel¶

POSIX Page de manuel du programmeur¶

Documentation complète¶

info grep

devrait vous donner accès au manuel complet.