Commandes simples¶

Une commande simple est une séquence d'affectations de variables facultative, suivie de mots séparés par des blancs et des redirections, et terminée par un opérateur de contrôle. Le premier mot indique la commande à exécuter et est passée comme étant l'argument zéro. Les mots suivants sont transmis en argument à cette commande.

La valeur de retour d'une commande simple est son code de sortie, ou 128+n si la commande a été interrompue par le signal n.

Pipelines¶

Un pipeline est une séquence d'une ou plusieurs commandes séparées par le caractère |. Le format d'un pipeline est :

La sortie standard de la commande_1 est connectée, via un tuyau (Ndt : pipe) à l'entrée standard de la commande_2. Cette connexion est établie avant toute redirection indiquée dans une commande elle-même (voir le paragraphe REDIRECTION plus bas).

Le code de retour d'un pipeline est le code de sortie de la dernière commande, à moins que l'option pipefail ne soit active. Si cette option est active, le code de retour du pipeline est la valeur de la dernière commande (la plus à droite) à sortir avec un code non nul, ou zéro si toutes les commandes s'achèvent avec succès. Si le mot réservé ! précède un pipeline, le code de sortie de celui-ci sera la négation logique du code de retour tel qu'on l'a décrit précédemment. L'interpréteur attend la fin de toutes les commandes du pipeline avant de renvoyer une valeur.

Si le mot réservé time précède le pipeline, les temps passés par le programme en mode utilisateur et système sont indiqués quand le pipeline se termine. L'option -p modifie le format de sortie pour celui spécifié par POSIX. La variable TIMEFORMAT peut être affectée avec une chaîne de format indiquant comment les informations horaires doivent être affichées ; consultez la description de TIMEFORMAT dans Variables du Shell plus bas.

Chaque commande du pipeline est exécutée comme un processus indépendant (c'est-à-dire dans un sous-shell).

Listes¶

Une liste est une séquence d'un ou plusieurs pipelines séparés par l'un des opérateurs ;, &, && ou ⎪⎪, et terminée éventuellement par ;, & ou <retour-chariot>.

Dans cette liste d'opérateurs, && et ⎪⎪ ont une précédence identique, suivis par ; et &, qui ont également une précédence identique.

Une séquence d'un ou plusieurs sauts de ligne peut apparaître dans une liste à la place d'un point-virgule pour délimiter les commandes.

Si une commande se termine par l'opérateur de contrôle &, l'interpréteur l'exécute en arrière-plan, dans un sous-shell. L'interpréteur n'attend pas que la commande se termine et retourne un code 0. Les commandes séparées par un ; sont exécutées successivement, l'interpréteur attend que chaque commande se termine avant de lancer la suivante. Le code de retour est celui de la dernière commande exécutée.

Les opérateurs de contrôle && et ⎪⎪ indiquent respectivement une liste liée par un ET, et une liste liée par un OU. Une liste ET a la forme

Une liste OU a la forme

commande_2 est exécutée si, et seulement si commande_1 renvoie un code de retour non-nul. La valeur de retour des listes ET et OU est celle de la dernière commande exécutée dans la liste.

Commandes composées¶

Une commande composée est l'une des constructions suivantes :

(liste)

liste est exécutée dans un sous-shell (voir ENVIRONNEMENT D'EXÉCUTION DES COMMANDES plus loin). Les affectations de variables, et les commandes internes qui affectent l'environnement de l'interpréteur n'ont pas d'effet une fois que la commande se termine. Le code de retour est celui de la liste.

{ liste; }

liste est simplement exécutée avec l'environnement du shell en cours. liste doit se terminer par un caractère fin-de-ligne ou un point-virgule. Cette construction est connue sous le nom de commandes groupées. Le code de retour est celui de la liste. Veuillez noter que contrairement aux méta-caractères ( et ), { et } sont des mots réservés qui ne doivent apparaître que là où un mot réservé peut être reconnu. Puisqu'ils ne provoqueront pas un coupage de mot, ils doivent être séparés de la liste par une espace.

((expression))

L'expression est évaluée selon les règles décrites plus bas au paragraphe ÉVALUATION ARITHMÉTIQUE. Si la valeur arithmétique de l'expression est non-nulle, le code renvoyé est zéro ; sinon 1 est renvoyé. Cela est strictement identique à let "expression".

[[ expression ]]

Renvoie 1 ou 0 selon la valeur de la condition expression. Les expressions sont composées d'éléments primaires décrits dans EXPRESSIONS CONDITIONNELLES. Le coupage des mots et l'expansion des chemins ne sont pas réalisés sur les portions entre [[ et ]]; l'expansion des tildes, des paramètres, des variable, des expressions arithmétiques, la substitution des commandes et des processus, ainsi que la disparition des apostrophes sont réalisés. Les opérateurs conditionnels tels que -f ne doivent pas être cotés afin d'être reconnus comme primaires. Conditional operators such as -f must be unquoted to be recognized

Quand les opérateurs == et != sont utilisés, la chaîne placée à droite de l'opérateur est considérée comme étant un motif et est recherchée selon les règles décrites dans Motifs génériques. Si l'option shell nocasematch est active, la mise en correspondance s'effectue sans tenir compte de la casse (différence majuscule/minuscule). La valeur renvoyée est 0 si les chaînes correspondent (==) (ou respectivement ne correspondent pas (!=)), et 1 sinon. Toute partie du motif peut être protégée avec des apostrophes pour forcer sa comparaison en tant que chaîne (sans développement).

Un opérateur binaire supplémentaire, =~, est disponible, avec la même priorité que == et !=. Lorsqu'il est utilisé, la chaîne à droite de l'opérateur est considérée comme une expression régulière étendue et est mise en correspondance en conséquence (comme avec regex(3)). La valeur renvoyée est 0 si la chaîne correspond au motif, et 1 si elle ne correspond pas. Si l'expression régulière n'est pas syntaxiquement correcte, la valeur de retour de l'expression conditionnelle est 2. Si l'option shell nocasematch est active, la mise en correspondance s'effectue sans tenir compte de la casse. Les sous-chaînes mise en correspondance avec des sous-expressions entre parenthèses dans l'expression rationnelle sont enregistrées dans la variable tableau BASH_REMATCH. L'élément d'index 0 de BASH_REMATCH est la partie de la chaîne correspondant à la l'expression rationnelle complète. L'élément d'index n de BASH_REMATCH est la partie de la chaîne correspondant à la nème sous-expression entre paranthèses.

Les expressions peuvent être combinées en utilisant les opérateurs suivants, par ordre décroissant de priorité :

for nom [ in mot ] ; do liste ; done

La liste de mots à la suite de in est développée, créant une liste d'éléments. La variable nom prend successivement la valeur de chacun des éléments, et liste est exécutée à chaque fois. Si in mot est omis, la commande for exécute la liste une fois pour chacun des paramètres positionnels ayant une valeur (voir le paragraphe PARAMÈTRES plus bas). Le code de retour est celui de la dernière commande exécutée. Si le développement de ce qui suit in est une liste vide, aucune commande n'est exécutée et 0 est renvoyé.

select nom [ in mot ] ; do liste ; done

La liste de mots à la suite de in est développée, créant une liste d'éléments. L'ensemble des mots développés est imprimé sur la sortie d'erreur standard, chacun précédé par un nombre. Si in mot est omis, les paramètres positionnels sont imprimés (voir le paragraphe PARAMÈTRES plus bas). Le symbole d'accueil PS3 est affiché, et une ligne est lue depuis l'entrée standard. Si la ligne est constituée d'un nombre correspondant à l'un des mots affichés, la variable nom est remplie avec ce mot. Si la ligne est vide, les mots et le symbole d'accueil sont affichés à nouveau. Si une fin de fichier (EOF) est lue, la commande se termine. Pour toutes les autres valeurs, la variable nom est vidée. La ligne lue est stockée dans la variable REPLY. La liste est exécutée après chaque sélection, jusqu'à ce qu'une commande break soit atteinte. Le code de retour de select est celui de la dernière commande exécutée dans la liste, ou zéro si aucune commande n'est exécutée.

case mot in [ motif [ | motif ] ... ) liste ;; ] ... esac

Une commande case commence d'abord par développer le mot, puis essaye de le mettre en correspondance successivement avec chacun des motifs en utilisant les mêmes règles que pour les noms de fichiers (voir le paragraphe Développement des noms de fichiers plus bas). Le mot est développé en utilisant le développement du tilde, le développement des paramètres et des variables, la substitution arithmétique, la substitution de commande, la substitution de processus et la suppression d'apostrophes. Chaque motif examiné est développé en utilisant le développement du tilde, le développement des paramètres et des variables, la substitution arithmétique, la substitution de commande et la substitution de processus. Si l'option shell nocasematch est active, la mise en correspondance s'effectue sans tenir compte de la casse. Quand une correspondance est trouvée, la liste associée est exécutée. Dès qu'un motif correct a été trouvé, il n'y a plus d'autre essais. Le code retour est zéro si aucun motif ne correspond, sinon il s'agit du code de la dernière commande exécutée dans la liste.

if liste ; then liste ; [ elif liste ; then liste ; ] ... [ else liste ; ] fi

La liste du if est exécutée. Si son code de retour est nul, la liste du then est exécutée. Sinon, chacune des listes des elif est exécutée successivement, et si un code de retour est nul, la liste du then associé est exécutée, et la commande se termine. En dernier ressort, la liste du else est exécutée. Le code de retour est celui de la dernière commande exécutée, ou zéro si aucune condition n'a été vérifiée.

while liste ; do liste ; done

until liste ; do liste ; done

La commande while répète la liste du do tant que la dernière commande de la liste du while renvoie un code de retour nul. La commande until agit de même manière, sauf que le test est négatif, et la liste du do est exécutée tant que la liste du until renvoie un code non-nul. Le code de retour des commandes while et until est celui de la dernière commande exécutée dans la liste do, ou zéro si aucune commande n'a été exécutée.

Définitions des fonctions shell¶

Une fonction shell est un objet qui est appelé comme une commande normale et qui exécute une commande composée avec un nouveau jeu de paramètres positionnels. Les fonctions shell sont déclarées de la manière suivante :

[ function ] nom () commande-composée [redirection]

Ceci définit une fonction possédant le nom mentionné. Le mot réservé function est optionnel. S'il est fourni, les paranthèses sont optionnelles. Le corps de la fonction est la commande-composée entre { et }, mais peut être toute commande décrite dans le paragraphe Commandes composées plus haut. La commande-composée est exécutée chaque fois que nom est spécifié comme le nom d'une commande normale. Toutes les redirections (voir REDIRECTION plus bas) spécifiées lorsqu'une fonction est définie sont effectuées lorsque la fonction est exécutée. Le code de retour d'une définition de fonction est zéro à moins qu'il y ait une erreur de syntaxe ou qu'une fonction en lecture seule, de même nom, existe déjà. Lorsque la fonction est exécutée, Le code de retour est celui de la dernière commande exécutée dans le corps de la fonction. (voir le paragraphe FONCTIONS plus bas)

Paramètres Positionnels¶

Un paramètre positionnel est un paramètre indiqué par un ou plusieurs chiffres (à l'exception du chiffre 0 seul). Les paramètres positionnels sont remplis avec les arguments du shell lors de son invocation. Ils peuvent être modifiés avec la commande interne set. On ne peut pas utiliser d'affectation pour modifier le contenu d'un paramètre positionnel. Les paramètres positionnels sont temporairement modifiés lors de l'exécution d'une fonction du shell (voir le paragraphe FONCTIONS plus bas).

Un paramètre positionnel constitué de plusieurs chiffres doit être encadré par des accolades lors de son développement (voir EXPANSION plus bas).

Paramètres Spéciaux¶

Il existe plusieurs paramètres ayant un comportement particulier. Ces paramètres peuvent uniquement être consultés, on ne peut pas les modifier.

*

Se développe en l'ensemble des paramètres positionnels, commençant à 1. Quand le développement se produit entre des guillemets, * se transforme en un seul mot constitué de la valeur de tous les paramètres positionnels séparés par le premier caractère de la variable spéciale IFS. Ceci signifie que « $* » est équivalent à « $1c$2c... », dans laquelle c est le premier caractère de la valeur de la variable IFS. Si IFS est inexistante, les paramètres sont séparés par des espaces. Si IFS est nulle, les paramètres sont juxtaposés sans séparation.

@

Se développe en l'ensemble des paramètres positionnels, commençant à 1. Quand le développement a lieu entre guillemets, chaque paramètre se transforme en un mot distinct. Ceci signifie que « $@ » est équivalent à « $1 » « $2 » ... Quand le développement entre guillemets survient dans un mot, le développement du premier paramètre est joint à la première partie du mot d'origine et le développement du dernier paramètre est joint à la dernière partie du mot d'origine. Quand il n'y a pas de paramètres positionnels, « $@ » et $@ sont simplement éliminés.

#

Correspond au nombre de paramètres positionnels, en base décimale.

?

Fournit le code de retour du dernier pipeline exécuté à l'avant-plan.

-

Est remplacé par la liste des options du shell indiquées durant l'invocation, configurées avec la commande interne set ou positionnées par le shell lui-même (comme avec l'option -i ).

$

Se transforme en PID du shell. Dans un sous-shell (), il se transforme en PID du shell, et non pas du sous-shell.

!

Se transforme en PID de la commande (asynchrone) exécutée en arrière-plan le plus récemment.

0

Se développe pour donner le nom du shell ou du script. Ce paramètre est rempli lors de l'initialisation de l'interpréteur. Si bash est invoqué avec un fichier de commandes, $0 correspond au nom de ce fichier. Si bash est lancé avec l'option -c, alors $0 contient le premier argument, s'il y en a un, après la chaîne de commandes à exécuter. Sinon, ce paramètre contient le chemin d'accès utilisé pour invoquer bash, comme il l'a reçu en argument zéro.

_

Au lancement du shell, contient le chemin d'accès absolu utilisé pour invoquer le shell ou du script en cours d'exécution tel qu'il est passé dans l'environnement ou dans la liste d'arguments. Devient le dernier argument de la commande précédente, après développement. Correspond aussi au chemin d'accès complet de chaque commande exécutée, et se retrouve dans l'environnement exporté à cette commande. Lors de la vérification de l'arrivée de courrier, contient le nom du fichier de courrier en cours de vérification [Ndt : généralement /var/mail/nom_de_l_utilisateur].

Variables du Shell¶

Les variables suivantes sont remplies par l'interpréteur de commandes :

BASH

Se développe en chemin d'accès complet à l'instance courante de bash.

BASH_ARGC

Une variable de type tableau dont les valeurs sont le nombre de paramètres de chaque trame de la pile d'appel d'exécution du shell courant. Le nombre de paramètres de la sous-routine courante (fonction shell ou script exécuté avec . ou source) est en haut de la pile. Lorsqu'une sous-routine est exécutée, le nombre de paramètres passés est poussé (Ndt : push) dans BASH_ARGC. Le shell positionne BASH_ARGC seulement dans le mode de débogage étendu (voir la description de l'option extdebug de la commande interne shopt plus loin).

BASH_ARGV

Une variable de type tableau contenant tous les paramètres de la pile d'appel d'exécution du shell courant. Le dernier paramètre de la dernière sous-routine se situe en haut de la pile ; le premier paramètre du premier appel en bas. Lorsqu'une sous-routine est exécutée, les paramètres fournis sont poussés dans BASH_ARGV. Le shell positionne BASH_ARGV seulement dans le mode de débogage étendu (voir la description de l'option extdebug de la commande interne shopt plus loin).

BASH_COMMAND

Contient la commande en cours d'exécution ou sur le point d'être exécutée, à moins que le shell n'exécute une commande résultant d'un « trap », auquel cas il s'agit de la commande s'exécutant au moment du « trap ».

BASH_EXECUTION_STRING

L'argument commande de l'option d'invocation -c.

BASH_LINENO

Une variable de type tableau dont les membres sont les numéros de ligne des fichiers sources correspondant à chacun des membres de FUNCNAME. ${BASH_LINENO[$i]} est le numéro de la ligne dans le fichier source où ${FUNCNAME[$i]} a été appelé. Le nom du fichier source correspondant est ${BASH_SOURCE[$i]}. Utilisez LINENO pour obtenir le numéro de ligne courant.

BASH_REMATCH

Une variable de type tableau dont les membres sont affectés avec l'opérateur binaire =~ dans la commande conditionnelle [[ L'élément d'index 0 est la partie de la chaîne correspondant à la l'expression rationnelle complète. L'élément d'index n est la partie de la chaîne correspondant à la nème sous-expression entre paranthèses. Cette variable est en lecture seule.

BASH_SOURCE

Une variable de type tableau dont les membres sont les noms des fichiers source correspondants aux éléments de la variable tableau FUNCNAME.

BASH_SUBSHELL

Incrémenté chaque fois qu'un sous-shell ou un environnement sous-shell est engendré. La valeur initiale est 0.

BASH_VERSINFO

Une variable de type tableau protégée en écriture dont les membres représentent la version de cette instance de bash. Cette valeur est renseignée de la manière suivante :

BASH_VERSION

Correspond au numéro de version de cette instance de bash.

COMP_CWORD

Un index vers ${COMP_WORDS} du mot contenant la position courant du curseur. Cette variable n'est disponible que dans les fonctions shell invoquées par les fonctionnalites de complétion programmable (voir Complétion programmable plus loin).

COMP_LINE

la ligne de commande courante. Cette variable n'est disponible que dans les fonctions shell invoquées par les fonctionnalites de complétion programmable (voir Complétion programmable plus loin).

COMP_POINT

L'index de la position courante du curseur relatif au début de la commande courante. Si la position courante du curseur est à la fin de la commande courante, la valeur de cette variable est égale à ${#COMP_LINE}. Cette variable n'est disponible que dans les fonctions shell et les commandes externes invoquées par les fonctionnalites de complétion programmable (voir Complétion programmable plus loin).

COMP_WORDBREAKS

le jeu de caractères que la bibliothèque Readline considèrent comme séparateurs de mots lors de la complétion de mots. Si COMP_WORDBREAKS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

COMP_WORDS

Une variable de type tableau (voir Tableaux plus loin) consistant en des mots individuels de la ligne de commande courante. Les mots sont fractionnés sur les caractères de remplacement du shell comme l'analyseur du shell les séparerait. Cette variable n'est disponible que dans les fonctions shell invoquées par les fonctionnalites de complétion programmable (voir Complétion programmable plus loin).

DIRSTACK

Une variable de type tableau (voir Tableaux plus bas) représentant le contenu courant de la pile de répertoires. Les répertoires apparaissent dans la pile dans l'ordre dans lequel la commande interne dirs les affiche. Il est possible de modifier directement cette variable mais les commandes internes pushd et popd doivent être utilisées pour ajouter et enlever des répertoires. Modifier cette variable ne modifiera pas le répertoire courant. Si DIRSTACK est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

EUID

Contient l'UID effectif de l'utilisateur, initialisé au démarrage du shell. Cette variable est en lecture seule.

FUNCNAME

Une variable de type tableau contenant le nom de toutes les fonctions shell actuellemnt dans la pile d'appel d'exécution. L'élément d'index 0 est le nom de n'importe laquelle des fonctions shell en cours d'exécution. L'élément le plus bas est « main ». Cette variable n'existe que si une fonction shell est en cours d'exécution. Les affectations de FUNCNAME n'ont aucun effet et renvoient un code d'erreur (Ndt : cette variable est protégée en écriture). Si FUNCNAME est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

GROUPS

Une variable de type tableau contenant la liste des groupes dont l'utilisateur est membre. Les affectations de GROUPS n'ont aucun effet et renvoient un code d'erreur (Ndt : cette variable est protégée en écriture). Si GROUPS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

HISTCMD

Le numéro d'historique, ou le rang dans la liste d'historique, de la commande en cours. Si HISTCMD est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

HOSTNAME

Automatiquement affectée avec le nom de l'ordinateur.

HOSTTYPE

Automatiquement remplie avec une chaîne qui décrit de manière unique le type de machine sur laquelle bash s'exécute. La valeur par défaut dépend du système.

LINENO

Chaque fois que ce paramètre est référencé, le shell le remplace par un nombre décimal représentant le numéro de la ligne actuelle (commençant à 1), au sein du script ou de la fonction. Hors d'un script ou d'une fonction, la valeur n'a pas nécessairement de sens. Si LINENO est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

MACHTYPE

Automatiquement affectée avec une chaîne décrivant le type du système sur lequel bash s'exécute, dans le format standard de GNU processeur-compagnie-système. La valeur par défaut dépend du système.

OLDPWD

Le répertoire de travail précédent, configuré par la commande cd.

OPTARG

La valeur du dernier argument d'option traité par la commande interne getopts (voir le paragraphe COMMANDES INTERNES DU SHELL plus loin).

OPTIND

Le rang du prochain argument à traiter avec la commande getopts (voir le paragraphe COMMANDES INTERNES DU SHELL plus bas).

OSTYPE

Automatiquement remplie avec une chaîne qui décrit le système d'exploitation sur lequel bash s'exécute. La valeur par défaut dépend du système.

PIPESTATUS

Une variable de type tableau (voir Tableaux plus loin) contenant une liste des codes de retour des derniers processus exécutés en avant-plan (éventuellement une seule commande).

PPID

L'ID du processus parent du shell. Cette variable est en lecture seule.

PWD

Le répertoire de travail en cours, configuré par la commande cd.

RANDOM

À chaque fois que ce paramètre est référencé, un entier aléatoire entre 0 et 32767 est engendré. Cette séquence de nombres aléatoires peut être initialisée en affectant une valeur à RANDOM. Si RANDOM est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

REPLY

Contient la ligne d'entrée lue par la commande interne read lorsqu'elle n'a pas d'argument.

SECONDS

À chaque fois que cette variable est lue, le nombre de secondes écoulées depuis le lancement de l'interpréteur est renvoyé. Si une valeur est affectée à SECONDS, elle renverra lors des lectures ultérieures le nombre de secondes écoulées depuis l'affectation, augmenté de la valeur fournie. Si SECONDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

SHELLOPTS

Liste des options activées du shell, séparées par des virgules. Chaque mot de la liste est un argument valide pour l'option -o de la commande interne set (voir COMMANDES INTERNES DU SHELL). Les options apparaissant dans SHELLOPTS sont celle indiquées comme actives par -o. Si cette variable est dans l'environnement au lancement de bash, chaque option de la liste est activée avant de lire les fichiers d'initialisation. Cette variable est en lecture seule.

SHLVL

(Ndt : Lire SH LVL - Shell Level - Niveau d'interpréteur) Incrémenté de 1 à chaque invocation d'une instance de bash.

UID

Contient l'ID de l'utilisateur, initialisé au démarrage du shell. Cette variable est en lecture seule.

Les variables suivantes sont utilisées par l'interpréteur. Dans certains cas, bash affecte des valeurs par défaut aux variables, ces cas sont décrits plus bas.

BASH_ENV

Si ce paramètre est configuré lorsque bash exécute un script, sa valeur est considérée comme un nom de fichier, contenant les commandes d'initialisation de l'interpréteur, comme .bashrc. La valeur de BASH_ENV est soumise au remplacement des paramètres, substitution de commandes, et évaluation arithmétique avant d'être considérée comme nom de fichier. PATH n'est pas utilisée pour rechercher le fichier obtenu.

CDPATH

Le chemin de recherche de la commande interne cd. Il s'agit d'une liste de répertoires, séparés par des deux-points « : » que l'interpréteur consulte lorsqu'il cherche un sous-répertoire destination de la commande cd. Une configuration possible serait « .:~:/usr ».

COLUMNS

Utilisée par la commande interne select pour déterminer la taille du terminal lors de l'affichage des listes de sélection. Automatiquement positionnée à la réception d'un signal SIGWINCH.

COMPREPLY

Une variable de type tableau dans lequel bash lit les complétions possibles générées par une fonction shell invoquée par la complétion programmable (voir Complétion programmable plus loin).

EMACS

Si bash trouve cette variable dans l'environnement lorsque le shell démarre avec la valeur « t », il considère que le shell est lancé dans un tampon shell emacs et désactive l'édition de lignes.

FCEDIT

L'éditeur par défaut utilisé par la commande interne fc.

FIGNORE

Une liste de suffixes, séparés par des deux-points « : », que bash ignorera lors de la complétion des noms de fichiers (voir le paragraphe READLINE plus bas). Un nom de fichier dont le suffixe correspond à l'un de ceux mentionnés dans FIGNORE est exclu de la liste des fichiers. Par exemple, cette variable peut prendre la valeur « .o:~ ».

GLOBIGNORE

Une liste de motifs séparés par des deux-points, définissant la liste des noms de fichiers à ignorer lors du développement des chemins. Si un nom de fichier correspondant à un motif d'expansion, correspond également à un motif dans GLOBIGNORE, il est supprimé de la liste des correspondances.

HISTCONTROL

Une liste de valeurs, séparées par des virgules, controlant la manière dont les commandes sont enregistrées dans l'historique. Si la liste des valeurs contient la valeur ignorespace, les lignes commençant par un caractère d'espacement ne seront par mémorisées dans l'historique. Si elle contient la valeur ignoredups, une ligne correspondant exactement à la ligne de commande précédente ne sera pas dupliquée dans l'historique. La valeur ignoreboth permet de combiner ces deux comportements. Si elle contient la valeur erasedups, toutes les lignes précédant la ligne courante et lui correspondant seront retirées de l'historique avant que cette ligne n'y soit enregistrée. Toute valeur qui ne fait pas partie de la liste ci-dessus est ignorée. Si HISTCONTROL est détruite, ou si elle contient une valeur différente des trois mentionnées ci-dessus, tous les lignes lues par l'interpréteur seront mémorisées dans la liste d'historique, sous contrôle de HISTIGNORE. La seconde ligne et les suivantes d'une commande multiligne ne sont pas testées, et sont ajoutées dans l'historique quelque soit la valeur de HISTCONTROL.

HISTFILE

Le nom du fichier d'historique pour la mémorisation des commandes (voir HISTORIQUE plus bas). Par défaut, il s'agit de ~/.bash_history.Sicettevariableest détruite, l'historique n'est pas enregistré en fin de shell.

HISTFILESIZE

Le nombre maximal de lignes contenues dans le fichier historique. Quand cette variable contient une valeur, le fichier historique est tronqué, si besoin est, en suprimant les entrées les plus anciennes, pour ne contenir que ce nombre de lignes. La valeur par défaut est 500. Ce fichier est tronqué à cette taille après écriture quand un shell interactif se termine.

HISTIGNORE

Une liste de motifs, séparés par des deux-points, déterminant quelles lignes de commandes seront ajoutées à l'historique. Chaque motif est accroché au début de la ligne et doit lui correspondre en entier (il n'y a pas d'ajout de « * » implicite). Chaque motif est comparé à chaque ligne après que les vérifications de HISTCONTROL aient été appliquées. En plus des motifs génériques normaux du shell, « & » correspond à la ligne précédente de l'historique. « & » peut être protégé par un barre oblique inverse. Cette dernière est éliminée avant de tenter une comparaison. La seconde ligne et les suivantes d'une commande multiligne ne sont pas testées, et sont ajoutées dans l'historique quelque soit la valeur de HISTIGNORE.

HISTSIZE

Le nombre de commandes à mémoriser dans l'historique (voir le paragraphe HISTORIQUE plus bas). La valeur par défaut est 500.

HISTTIMEFORMAT

Si cette varaible existe et qu'elle n'est pas vide, sa valeur est utilisée comme une chaîne de caractères par strftime(3) afin d'imprimer l'horodatage associé à chaque entrée de l'historique affichée par la commande interne history. Si cette variable existe, les horodatages sont écrits dans le fichier historique afin d'être conservés au fur et à mesure des sessions shell.

HOME

Le répertoire personnel de l'utilisateur. C'est l'argument par défaut de la commande interne cd. Cette variable sert également lors du développement du tilde.

HOSTFILE

Contient le nom d'un fichier ayant le même format que /etc/hosts qui sera consulté lorsque le shell devra compléter un nom d'hôte. Ce fichier peut être changé de manière interactive. Lors de la prochaine tentative pour compléter un nom d'hôte, bash ajoutera le nouveau fichier à sa base de données déjà existante. Si HOSTFILE existe mais est vide, bash essayera de lire /etc/hosts pour obtenir la liste des complétions de noms d'hôte possible. Lorsque HOSTFILE est détruite, la liste des noms d'hôte est effacée.

IFS

Le Séparateur de Champs Interne Internal Field Separator qui est utilisé pour séparer les mots après les développements, et pour découper les lignes en mots avec la commande interne read. La valeur par défaut est « <espace><tabulation><retour-chariot> ».

IGNOREEOF

Cette variable contrôle le comportement du shell lorsqu'il reçoit un caractère EOF (fin de fichier) comme unique entrée. Si elle configurée, la valeur de cette variable correspond au nombre de caractères EOF consécutifs apparaissant en début de ligne que bash ignorera avant de se terminer. Si cette variable existe mais que sa valeur n'est pas numérique, ou si elle n'a pas de valeur, la valeur par défaut est 10. Si elle n'existe pas, EOF est considérée comme un terminateur de saisie pour le shell.

INPUTRC

Le nom du fichier de configuration de readline prioritaire sur le fichier par défaut ~/.inputrc (voir READLINE plus bas).

LANG

Détermine la localisation pour toutes les catégories non spécifiquement précisées par une variable commençant par LC_.

LC_ALL

Cette variable surcharge LANG et toute autre variable LC_ indiquant la localisation.

LC_CTYPE

Cette variable détermine l'interprétation des caractères et le comportement des classes de caractères (Ndt : p. ex. [:alpha:]) lors du développement des chemins et de la recherche de motifs.

LC_MESSAGES

Cette variable détermine le langage des messages et celui utilisé pour traduire les chaînes entre guillemets précédés par un $.

LC_NUMERIC

Cette variable détermine la catégorie locale utilisée pour formater les nombres.

LINES

Utilisée par la commande interne select pour déterminer la longueur de colonne lors de l'affichage des listes de sélection. Elle est automatiquement raffraichie à la réception d'un signal SIGWINCH.

MAIL

Si ce paramètre correspond à un nom de fichier, et si la variable MAILPATH n'est pas configurée, ou positionnée à une valeur qui n'est pas un nombre supérieur ou égal à zéro, bash désactivera la vérification de courrier.

MAILCHECK

Indique une période (en secondes), par défaut 60, avec laquelle bash vérifiera si un nouveau courrier est arrivé. Lorsque le délai est écoulé, le shell vérifiera la présence d'un courrier avant d'afficher son symbole d'accueil. Si cette variable est détruite, le shell cessera la vérification.

MAILPATH

Il s'agit d'une liste de fichiers séparés par des deux-points « : », dans lesquels on vérifiera l'arrivée de courrier. Le nom d'un fichier peut être suivi d'un point d'interrogation, puis d'une chaîne de caractères indiquant le message à afficher en cas de courrier. Dans cette chaîne, le paramètre $_ correspond au nom du fichier. Exemple :

OPTERR

Si cette variable contient la valeur 1, bash affiche les messages d'erreurs déclenchés par la commande interne getopts (voir le paragraphe COMMANDES INTERNES DU SHELL plus bas). OPTERR est initialisée avec la valeur 1 à chaque invocation du shell, ou au lancement d'un script.

PATH

Le chemin de recherche des commandes à exécuter. Il s'agit d'une liste de répertoires, séparés par des deux-points « : » que l'interpréteur consulte lorsqu'il recherche une commande (voir le paragraphe EXÉCUTION DES COMMANDES plus bas). Le chemin par défaut dépend du système, et de la configuration choisie par la personne installant bash. Une configuration fréquente est « /bin:/usr/bin:/usr/local/bin:. ».

POSIXLY_CORRECT

Si cette variable existe dans l'environnement lorsque bash démarre, le shell entre dans le mode posix avant de lire les fichiers de configuration comme si l'option --posix avait été fournie. Si elle est crée pendant que le shell est en cours d'exécution, bash active le mode posix comme si la commande « set -o posix » était exécutée.

PROMPT_COMMAND

Lorsque cette variable contient une valeur, celle-ci est exécutée en tant que commande, avant l'affichage du symbole d'accueil principal.

PS1

La valeur de ce paramètre est développée puis utilisée comme symbole d'accueil principal (voir le paragraphe SYMBOLE D'ACCUEIL ci-dessous). La valeur par défaut est « \s-\v\$  ».

PS2

La valeur de ce paramètre est développée comme PS1 puis utilisée comme symbole d'accueil secondaire. Par défaut, il s'agit de « >  ».

PS3

La valeur de ce paramètre est utilisée comme symbole pour la commande select (voir GRAMMAIRE DU SHELL plus haut).

PS4

La valeur de ce paramètre est développée comme PS1 puis affichée entre chaque commande lors d'un suivi d'exécution. Le premier caractère de PS4 est répété autant de fois que nécessaire pour indiquer le niveau d'imbrication. La valeur par défaut est « +  ».

SHELL

Le chemin complet vers le shell est conservé dans cette variable d'environnement. Si elle n'existe pas ou si elle est vide lorsque le shell démarre, bash lui affectera le chemin complet du shell de connexion courant de l'utilisateur.

TIMEFORMAT

La valeur de ce paramètre est utilisée en tant que chaîne de format pour afficher le temps consommé dans les pipelines préfixés avec le mot réservé time. Le caractère % introduit une séquence d'échappement qui est développée avec une valeur de temps ou une autre information. Les séquences d'échappement et leurs significations sont les suivantes; les accolades entourent les parties facultatives.

La séquence facultative p est un chiffre indiquant la précision, le nombre de chiffres après la virgule. Une valeur de 0 provoque l'affichage de nombre entiers. Trois chiffres au plus peuvent être affichés après la virgule; tout chiffre supérieur à 3 sera changé en 3. Si p n'est pas indiqué, 3 est utilisé.

La séquence optionnelle l spécifie un format étendu, incluant les minutes, de la forme MMmSS.FFs. La valeur de p détermine si la partie décimale est affichée ou non.

Si cette variable n'est pas assignée, bash réagit comme si la valeur $'\nreal\t%3lR\nuser\t%3lU\nsys%3lS' avait été affectée. Si la variable est vide, aucune information n'est affichée. Un caractère fin-de-ligne est ajouté à la fin de l'affichage.

TMOUT

Si cette variable contient une valeur supérieure à zéro, celle-ci est considérée comme un délai, en secondes, pour la commande interne read. La commande select se termine au bout de TMOUT s'il n'y a rien sur l'entrée et que celle-ci est un terminal. Dans un shell interactif, la valeur est interprétée comme le nombre de secondes à attendre pour une entrée après avoir émis l'invite de commande primaire. Lorsque ce délai sera écoulé, bash se terminera si aucune saisie n'a eu lieu.

TMPDIR

Si cette variable existe, bash utilise sa valeur comme le nom d'un répertoire dans lequel il créera les fichiers temporaires nécessaire au shell.

auto_resume

Cette variable configure le comportement du shell interactif vis-à-vis de l'utilisateur et du contrôle de tâches. Si cette variable existe, les commandes simples constituées d'un seul mot, sans redirection, sont considérées comme de possibles relances de travaux arrêtés. Aucune ambiguïté n'est possible, si plusieurs travaux arrêtés commencent par la chaîne saisie, bash sélectionne celui qui a été manipulé le plus récemment. Le nom de la tâche arrêtée correspond, dans ce contexte, à la ligne de commande utilisée pour le lancer. Si cette variable contient la valeur exact, la chaîne fournie doit correspondre exactement au nom d'une tâche arrêtée. Si elle contient la valeur substring, la chaîne fournie doit correspondre à une sous-chaîne du nom du job arrêté. La valeur substring fournit un comportement analogue à l'identificateur de tâche %? (voir CONTRÔLE DES TÂCHES
plus bas). Si la variable contient n'importe quelle autre valeur, la chaîne fournie doit correspondre à un préfixe du nom d'un job arrêté. C'est analogue au fonctionnement du job id %.

histchars

Cette variable contient deux ou trois caractères contrôlant le développement de l'historique, et le découpage en jetons (voir DÉVELOPPEMENT DE L'HISTORIQUE plus bas). Le premier caractère est le caractère de développement de l'historique, c'est-à-dire celui qui indique le début d'un développement d'historique (normalement « ! »). Le second caractère est celui de substitution rapide, utilisé comme raccourci pour relancer la commande précédente, en modifiant une partie de la chaîne. Par défaut il s'agit de « ^ ». L'éventuel troisième caractère est celui qui indique, lorsqu'on le trouve en début de mot que le reste de la ligne est un commentaire. Normalement on utilise le caractère « # ». Ce caractère de commentaire empêche l'expansion de l'historique pour tous les mots restants sur la ligne. En revanche, il ne s'agit pas obligatoirement du caractère de commentaire pour l'interpréteur.

Tableaux¶

Bash propose des variables tableaux à une dimension. N'importe quelle variable peut être utilisée comme tableau ; la commande interne declare peut servir à déclarer explicitement un tableau. Il n'y a pas de limite maximale à la taille d'un tableau, ni d'obligation que les membres soient indexés ou assignés de manière contigûe. Les tableaux sont indexés par des entiers en commençant à zéro.

Un tableau est créé automatiquement si une variable est remplie en utilisant la syntaxe nom[index]=valeur. l'index est traîté comme une expression arithmétique, et s'évaluer en un nombre positif ou nul. Pour déclarer explicitement un tableau, on utilise declare -a nom (voir COMMANDES INTERNES DU SHELL plus bas). declare -a nom[index] est aussi accepté bien que l'index soit ignoré. Des attributs peuvent être spécifiés pour une variable tableau en utilisant les commandes internes declare et readonly. Les attributs s'appliquent à tous les membres du tableau.

Les tableaux sont remplis en utilisant l'affectation composée de la forme nom=(valeur_1 ... valeur_n), où chaque valeur est de la forme [index]=chaîne. Seule la chaîne est obligatoire. Si les crochets et les index optionnels sont fournis, les affectations ont lieu en conséquence ; sinon le rang de l'elément rempli est le dernier rang rempli plus un. Les index commencent à zéro. Cette syntaxed est aussi acceptée par la commande interne declare. Les éléments individuels du tableaux sont remplis en utilisant la syntaxe nom[index]=valeur présentée plus haut.

Chaque élément d'un tableau peut référencé en utilisant la notation ${nom[index]}. Les accolades sont indispensables pour éviter les conflits avec le développement des noms de fichiers. Si index est @ ou *, le développement donne tous les membres de nom. Ces deux index diffèrent lorsqu'ils sont employés entre guillemets. Dans ce cas, ${nom[*]} correspond à un seul mot contenant les valeurs de tous les membres séparés par le premier caractère de la variable spéciale IFS, et ${nom[@]} développe chaque membre de nom en un mot distinct. Quant il n'y a pas de membre dans le tableau, ${nom[@]} n'a pas de valeur. Si le développement entre guillemets survient dans un mot, le développement du premier paramètre est joint à la première partie du mot d'origine et le développement du dernier paramètre est joint à la dernière partie du mot d'origine. Le comportement est analogue à celui des paramètres spéciaux * et @ (voir Paramètres spéciaux plus haut). ${#nom[index]} donne la longueur du membre ${nom[index]}. Si l'index est * ou @, le développement donne le nombre d'éléments dans le tableau. Référencer une variable sans index est équivalent à en référencer l'élément zéro.

La commande interne unset sert à détruire les tableaux. unset nom[index] détruit l'élément de rang index. Un soin particulier doit être pris afin d'éviter des effets de bords non désirés provoqués par la génération des noms de fichiers. unset nom, où nom est un tableau, ou unset nom[index], avec index valant * ou @ supprimer le tableau entier.

Les commandes internes declare, local, et readonly acceptent toutes une option -a pour spécifier un tableau. La commande interne read accepte une option -a pour remplir un tableau avec une liste de mots lus depuis l'entrée standard. Les commandes internes set et declare affiche les valeurs des tableaux d'une manière permettant de les réutiliser pour les affectations.

Expansion des accolades¶

L'expansion des accolades est un mécanisme permettant la création de chaînes quelconques. Il est similaire au développement des noms de fichiers, mais les noms de fichiers créés n'existent pas nécessairement. Les motifs qui seront développes prennent la forme d'un préambule facultatif, suivi par soit une série de chaînes séparées par des virgules, soit une expression de type séquence encadrée par des accolades. Un postambule peut éventuellement suivre la série de chaînes. Le préambule est inséré devant chacune des chaînes contenues entre les accolades, et le postambule est ajouté à la fin de chacune des chaînes résultantes, le développement se faisant de gauche à droite.

Plusieurs développements d'accolades peuvent être imbriqués. Les résultats de chaque développement ne sont pas triés, l'ordre gauche à droite est conservé. Par exemple a{d,c,b}e se développe en « ade ace abe ».

Une expression de type séquence prend la forme {x..y}, où x et y sont soit des entiers, soit des caractères seuls. Lorsqu'il s'agit d'entiers, l'expression est remplacée par la liste des nombres entre x et y, x et y compris. S'il s'agit de caractères, l'expression est remplacée par l'ensemble des caractères situés entre x et y d'un point de vue lexicographique. Notez que x et y doivent être du même type.

L'expansion des accolades est effectuée en premier, et tous les caractères ayant une signification spéciale pour les autres développement sont conservés dans le résultat. Il s'agit d'une modification purement littérale. Bash n'effectue aucune interprétation syntaxique du texte entre les accolades.

Une formule correcte pour le développement doit contenir des accolades ouvrantes et fermantes non protégées, et au moins une virgule non protégée ou une expression sequence valide. Toute formule incorrecte n'est pas développée et reste inchangée. Un { ou un , peuvent être protégés par une barre oblique inverse pour éviter d'être considérés comme partie d'une expression entre accolades.

Cette construction est généralement utilisée comme raccourci lorsque le préfixe commun aux différentes chaînes est relativement long :

Le développement des accolades induit une légère incompatibilité avec les versions traditionnelles de l'interpréteur Bourne sh. sh n'effectue aucun traitement sur les accolades ouvrantes et fermantes lorsqu'elles apparaissent dans un mot, et les laisse inchangées. Bash supprime les accolades dans les mots, après développement. Par exemple, si l'on fournit à sh le mot file{1,2}, il reste inchangé en sortie. Par contre, il est transformé en file1 file2 par bash. Si une compatibilité stricte avec sh est nécessaire, lancez bash avec l'option +B ou désactivez le développement des accolades avec l'option +B de la commande set (voir le paragraphe COMMANDES INTERNES DU SHELL plus bas).

Développement du Tilde¶

Si un mot commence avec le caractère tilde (« ~ »), tous les caractères précédant le premier slash non protégé (voire tous les caractères s'il n'y a pas de slash), sont considérés comme un préfixe tilde. Si aucun caractère du préfixe tilde n'est protégé, les caractères suivant le tilde sont traités comme un nom de login possible. Si ce nom de login est une chaîne nulle, le tilde est remplacé par la valeur du paramètre HOME. Si HOME n'existe pas, le tilde est remplacé par le répertoire de connexion de l'utilisateur exécutant le shell. Si le préfixe tilde est remplacé par le répertoire personnel associé au nom de login en question.

Si le préfixe tilde est « + », la valeur du paramètre shell PWD le remplace. Si le préfixe tilde est « - », la valeur du paramètre shell OLDPWD lui est substitué. Si les caractères à la suite du tilde dans le préfixe tilde représentent un nombre N préfixé éventuellement d'un « + » ou d'un « - » le préfixe tilde est remplacé par l'élément correspondant de la pile de répertoires telle qu'il serait affiché par la commande interne dirs invoquée avec le préfixe tilde en argument. Si les caractères à la suite du tilde dans le préfixe tilde représentent un nombre sans signe, on suppose qu'il s'agit de « + ».

Si le nom est invalide, ou si le développement du tilde échoue, le mot est inchangé.

Chaque affectation de variable est soumis au développement du tilde s'il suit immédiatement un : ou le premier =. On peut donc utiliser des chemins d'accès avec un tilde pour remplir les variables PATH, MAILPATH, et CDPATH, et le shell fournira la valeur correcte.

Remplacement des paramètres¶

Le caractère « $ » permet d'introduire le remplacement des paramètres, la substitution de commandes, ou l'expansion arithmétique. Le nom du paramètre ou du symbole à développer peut être encadré par des accolades, afin d'éviter que les caractères suivants ne soient considérés comme appartenant au nom de la variable.

Lorsque les accolades sont utilisées, l'accolade finale est le premier caractère « } » non protégé par une barre oblique inverse ni inclus dans une chaîne protégée, ni dans une expresssion arithmétique, une substitution de commande ou un développement de paramètre.

${paramètre}

est remplacé par la valeur du paramètre. Les accolades sont nécessaire quand le paramètre est un paramètre positionnel ayant plusieurs chiffres, ou si le paramètre est suivi de caractères n'appartenant pas à son nom.

Si le premier caractère du paramètre est un point d'exclamation, un niveau d'indirection de variable est introduit. Bash utilise la valeur de la variable formée par le reste du paramètre comme un nom de variable. Cette variable est alors développée et la valeur utilisée pour le reste de la substitution plutôt que la valeur du paramètre lui-même. On appelle ce mécanisme le développement indirect. Les exceptions à celui-ci sont les développements de ${!prefix*} et de ${!nom[@]} décrits plus loin. Le point d'exclamation doit immétiatement suivre l'accolade ouvrante afin d'introduire l'indirection.

Dans chacun des exemples suivants, le mot est soumis au développement du tilde, au remplacement des paramètres, à la substitution de commandes, et à l'évaluation arithmétique. Bash vérifie si un paramètre existe, et s'il n'est pas nul. L'omission du double point ne fournit qu'un test d'existence.

${paramètre:-mot}

Utilisation d'une valeur par défaut. Si le paramètre est inexistant ou nul, on substitue le développement du mot. Sinon, c'est la valeur du paramètre qui est fournie.

${paramètre:=mot}

Attribution d'une valeur par défaut. Si le paramètre est inexistant ou nul, le développement du mot lui est affecté. La valeur du paramètre est alors renvoyée. Les paramètres positionnels, et spéciaux ne peuvent pas être affectés de cette façon.

${paramètre:?mot}

Affichage d'une erreur si inexistant ou nul. Si le paramètre est inexistant, ou nul, le développement du mot (ou un message approprié si aucun mot n'est fourni) est affiché sur la sortie d'erreur standard, et l'interpréteur se termine, s'il n'est pas interactif. Autrement, la valeur du paramètre est utilisée.

${paramètre:+mot}

Utilisation d'une valeur différente. Si le paramètre est nul, ou inexistant, rien n'est substitué. Sinon le développement du mot est renvoyé.

${paramètre:début}

${paramètre:début:longueur}

Extraction de sous-chaîne Se développe pour fournir la sous-chaîne de la longueur indiquée (en caractères) commençant au début.D offset. Si la longueur est omise, fournit la sous-chaîne commençant au caractère de début et s'étendant jusqu'à la fin du paramètre. La longueur et le début sont des expressions arithmétiques (voir ÉVALUATION ARITHMÉTIQUE plus bas). La longueur doit être positive ou nulle. Si le début est négatif, sa valeur est considérée à partir de la fin du contenu du paramètre. Si le paramètre est @, le résultat correspond aux longueur paramètres positionnels commençant au début. Si le paramètre est un nom de tableau indexé par @ ou *, le résultat est les longueur membres du tableau commençant à ${paramètre[début]}. Une valeur négative de début est prise relativement à la valeur maximum de l'index du tableau considéré, augmentée de un. Notez qu'une valeur négative de début doit être séparée du deux-points par au moins une espace pour éviter toute confusion avec le dévéloppement de « :- ». L'indexation des sous-chaînes débute à zéro, sauf pour les paramètres positionnels qui débute en 1.

${#paramètre}

${!paramètre@}

Se développe en les noms des variables dont les noms commencent par paramètre, séparés par le premier caractère de la variable spéciale IFS.

${!nom[@]}

${!nom[*]}

Si nom est une variable de type tableau, elle se développe en la liste des indices (clés) du tableau affecté à nom. Si nom n'est pas un tableau, se développe en 0 si existe et en rien autrement. Si @ est utilisé et que le développement apparaît entre guillemets, chaque clé se développe en un mot séparé.

Est remplacé par la longueur, en caractères, de la valeur du paramètre.

Si le paramètre est * ou @, la valeur est le nombre de paramètres positionnels. Si le paramètre est un nom de tableau indexé par * ou @, la valeur est le nombre d'éléments dans le tableau.

${paramètre#mot}

${paramètre##mot}

Le mot est développé pour fournir un motif, comme dans l'expansion des noms de fichiers. Si le motif correspond au début de la valeur du paramètre, alors le développement prend la valeur du paramètre après suppression du plus petit motif commun (cas « # »), ou du plus long motif (cas « ## »). Si le paramètre est @ ou *, l'opération de suppression de motif est appliquée à chaque paramètre positionnel successivement, et le développement donne la liste finale. Si le paramètre est une variable tableau indexée par @ ou *, l'opération de suppression de motif est appliquée à chaque membre du tableau successivement, et le développement donne la liste finale.

${paramètre%mot}

${paramètre%%mot}

est développé pour fournir un motif, comme dans l'expansion des noms de fichiers. Si le motif correspond à une portion finale de la valeur du paramètre, alors le développement prend la valeur du paramètre après suppression du plus petit motif commun (cas « % »), ou du plus long motif (cas « %% »). Si le paramètre est @ ou *, l'opération de suppression de motif est appliquée à chaque paramètre positionnel successivement, et le développement donne la liste finale. Si le paramètre est une variable tableau indexée par @ ou *, l'opération de suppression de motif est appliquée à chaque membre du tableau successivement, et le développement donne la liste finale.

${paramètre/motif/chaîne}

Le motif est développé comme dans le traitement des noms de fichiers. Le paramètre est développé et la plus longue portion correspondant au motif est remplacée par la chaîneg. Si le motif commence par /, toutes les correspondances de motif sont remplacés par chaîne. Normalement, seule la première correspondance est remplacée. Si le motif commence par #, il doit correspondre au début de la valeur développée du paramètre. Si le motif commence par %, il doit correspondre à la fin du développement du paramètre. Si la chaîne est nulle, les portions correspondant au motif sont supprimées et le / après le motif peut être omis. Si le paramètre est @ ou *, l'opération de substitution est appliquée à chacun des paramètres positionnels successivement, et le résultat est la liste finale. Si le paramètre est une variable tableau indexée par @ ou *, l'opération de substitution s'applique à chaque membre du tableau successivement, et le résultat est la liste finale.

Substitution de commandes¶

La substitution de commandes permet de remplacer le nom d'une commande par son résultat. Il en existe deux formes :

Bash effectue la substitution en exécutant la commande et en la remplaçant par sa sortie standard, dont les derniers sauts de lignes sont supprimés. Les sauts de lignes internes ne sont pas supprimés mais peuvent disparaître lors du découpage en mots. La substitution de commande $(cat fichier) peut être remplacée par l'équivalent plus rapide $(< fichier).

Quand l'ancienne forme de substitution avec les backquotes « ` » est utilisée, le caractère antislash garde sa signification littérale, sauf s'il est suivi de $, `, ou \. La première backquote non protégée par un antislash termine la substitution de commande. Quand on utilise la forme $(commande), tous les caractères entre parenthèses gardent leurs valeurs littérales. Aucun n'est traité spécialement.

Les substitutions de commandes peuvent être imbriquées. Avec l'ancienne forme, il faut protéger les backquotes internes avec une barre oblique inverse.

Si la substitution apparaît entre guillemets, le découpage des mots, et l'expansion des noms de fichiers ne sont pas effectués.

Évaluation Arithmétique¶

L'évaluation arithmétique permet de remplacer une expression par le résultat de son évaluation. Le format d'évaluation arithmétique est :

L'expression est manipulée de la même manière que si elle se trouvait entre guillemets, mais un guillemet se trouvant entre les parenthèses n'est pas traité spécifiquement. Tous les mots de l'expression subissent le développement des paramètres, la substitution des commandes et la suppression des apostrophes et guillemets. Les développement arithmétiques peuvent être imbriquées.

L'évaluation est effectuée en suivant les règles mentionnées dans le paragraphe CALCUL ARITHMÉTIQUE. Si l'expression est invalide, bash affiche un message indiquant l'erreur, et aucune substitution n'a lieu.

Substitution de Processus¶

La substitution de processus n'est disponible que sur les systèmes acceptant le mécanisme des tubes nommés (FIFOs) ou la méthode /dev/fd de noms de fichiers. Elle prend la forme <(liste) ou >(liste). La liste de processus est exécutée avec ses entrées et sorties connectée à une FIFO ou à un fichier dans /dev/fd. Le nom de ce fichier est passé en argument à la commande qui sera exécutée comme résultat de cette substitution. Si on utilise la forme >(liste), l'écriture dans le fichier fournira des entrées pour la liste. Si la forme <(liste) est utilisée, le fichier passe en argument devra être lu pour obtenir la sortie de la liste.

Sur les systèmes qui le permettent, la substitution de processus est effectuée simultanément au remplacement des paramètres et variables, a la substitution de commande, et à l'évaluation arithmétique.

Séparation des mots¶

Les résultats du remplacement des paramètres, de la substitution de commandes, et de l'évaluation arithmétique, qui ne se trouvent pas entre guillemets sont analysés par le shell afin d'appliquer le découpage des mots.

L'interpréteur considère chaque caractère du paramètre IFS comme un délimiteur, et redécoupe le résultat des transformations précédentes en fonction de ceux-ci. Si la valeur du paramètre IFS est exactement <espace><tabulation><retour-chariot>, (la valeur par défaut), alors toute séquence de caractères IFS sert à délimiter les mots. Si IFS a une valeur autre que celle par défaut, alors les séquences de caractères blancs espace et tabulation sont ignorées en début et fin de mot, à condition que ces caractères blancs se trouvent dans la valeur de IFS (un caractère de IFS blanc). Tout autre caractère de IFS se trouvant à côté d'un caractère blanc de IFS, sert à délimiter un champ. Une séquence de caractères blancs de IFS est également traitée comme un séparateur. Si la valeur de IFS est nulle, aucun découpage de mot n'a lieu.

Les arguments nuls explicites ("" ou '') sont conservés. Les arguments nuls implicites, résultant du développement des paramètres n'ayant pas de valeurs, sont éliminés. Si un paramètre sans valeur est développé entre guillemets, le résultat est un argument nul qui est conservé.

Notez que si aucun développement n'a lieu, le découpage des mots n'est pas effectué.

Développement des noms de fichiers¶

Après le découpage des mots, et si l'option -f n'est pas indiquée, bash recherche dans chaque mot les caractères *, ?, (, et [. Si l'un d'eux apparaît, le mot est considéré comme un motif, et remplacé par une liste, classée par ordre alphabétique, des noms de fichiers correspondant à ce motif. Si aucun nom de fichiers ne correspond, et si l'option shell nullglob n'est pas active, le mot reste inchangé. Si l'option nullglob est active, et si aucune correspondance n'est trouvée, le mot est supprimé. Si l'option shell failglob est active, et si aucune correspondance n'est trouvée, un message d'erreur est affiché et la commande n'est pas exécutée Si l'option shell nocaseglob est activée, la correspondance a lieu sans tenir compte des différences majuscules/minuscules. Quand un motif est utilisé pour créer des chemins d'accès, le caractère « . » au début d'un nom, ou immédiatement à la suite d'un slash doit être explicitement mis en correspondance, à moins que l'option shell dotglob ne soit active. Le caractère slash doit toujours être mis en correspondance explicitement. Dans tous les autres cas, le caractère « . » n'est pas traité spécifiquement. Voyez la description de la commande shopt dans COMMANDES INTERNES DU SHELL pour une description des options shell nocaseglob, nullglob, failglob, et dotglob.

la variable shell GLOBIGNORE peut servir à restreindre l'ensemble des noms de fichiers correspondant à un motif. Si GLOBIGNORE est remplie, chaque nom de fichier qui correspond aussi à un motif de GLOBIGNORE est supprimé de la liste des correspondances. Les noms de fichiers « . » et « .. » sont toujours ignorés quand GLOBIGNORE existe et n'est pas vide. Toutefois, configurer GLOBIGNORE avec une valeur non nulle a pour effet d'activer l'option shell dotglob, ainsi tous les autres noms de fichiers commençant par « . » correspondront. Pour obtenir l'ancien comportement ignorant les noms commençant par « . », placez « .* » dans l'un des motifs de GLOBIGNORE. L'option dotglob est désactivée si la variable GLOBIGNORE n'existe pas.

Motifs génériques

Tout caractère apparaissant dans un motif, hormis les caractères spéciaux décrits ci-après correspond à lui-même. Le caractère NUL ne peut pas se trouver dans un motif. Une barre oblique inverse protège le caractère suivant ; la barre oblique de protection est abandonné si elle correspond. Les caractères spéciaux doivent être protégés si ils doivent se correspondre littéralement.

Les caractères spéciaux ont les significations suivantes :

*

Correspond à n'importe quelle chaîne, y compris la chaîne vide.

?

Correspond à n'importe quel caractère.

[...]

Correspond à l'un des caractères entre crochets. Une paire de caractères séparés par un trait d'union indique une expression intervalle; tout caractère qui correspond à n'importe quel caractère situé entre les deux bornes incluses, en utilisant les paramètres régionaux courant et le jeu de caractères. Si le premier caractère suivant le [ est un ! ou un ^ alors la correspondance se fait sur les caractères non-inclus. L'ordre de tri des caractères dans les expressions intervalle est déterminé par les paramètres régionaux courants et par la valeur de la variable shell LC_COLLATE si elle existe. Un - peut être mis en correspondance en l'incluant en premier ou dernier caractère de l'ensemble. Un ] peut être mis en correspondance en l'incluant en premier caractère de l'ensemble.

Entre [ et ], on peut indiquer une classe de caractère en utilisant la syntaxe [:classe:], où classe est l'une des classes suivantes, définies dans la norme POSIX :

Si l'option extglob du shell option est activée par la commande shopt plusieurs opérateurs de correspondance étendue sont reconnus. Dans la description suivante, une liste-motif est une liste d'un ou plusieurs motifs séparés par des |. Les motifs composés sont formés en utilisant un ou plusieurs sous-motifs comme suit :

Suppression des protections¶

Après les développements précédents, toutes les occurrences non-protégées des caractères \, ', et " qui ne résultent pas d'un développement sont supprimées.

Redirection d'entrée¶

Lorsque l'on applique une redirection d'entrée, le fichier dont le nom résulte du développement du mot sera ouvert en lecture avec le descripteur de fichier numéro n, ou en tant qu'entrée standard (descripteur de fichier 0) si n n'est pas mentionné.

Le format général des redirections d'entrée est le suivant :

Redirection de sortie¶

Lors d'une redirection de sortie, le fichier dont le nom résulte du développement du mot est ouvert en écriture, avec le descripteur de fichier n, ou en tant que sortie standard (descripteur de fichier 1) si n n'est pas mentionné. Si le fichier n'existe pas, il est créé. S'il existait déjà, sa taille est ramenée à 0.

Le format général des redirections de sortie est le suivant :

Si l'opérateur de redirection est >, et si l'option noclobber de la commande interne set est activée, la redirection échouera si le fichier dont le nom résulte du développement du mot existe et est un fichier régulier. Si l'opérateur de redirection est >|, ou l'opérateur > avec l'option noclobber de la commande interne set n'est pas activée, la redirection sera tentée même si le fichier dont le nom résulte du développement du mot existe.

Redirection pour ajout en sortie¶

Lorsqu'on redirige ainsi la sortie, le fichier dont le nom résulte du développement du mot est ouvert pour ajout en fin de fichier, avec le descripteur n, ou en tant que sortie standard (descripteur 1) si n n'est pas mentionné. Si le fichier n'existe pas, il est créé.

Le format général pour la redirection de sortie avec ajout est :

Redirection de la sortie standard et de la sortie d'erreur¶

Bash permet la redirection simultanée de la sortie standard (descripteur 1) et de la sortie d'erreur (descripteur 2), dans un fichier dont le nom est le résultat du développement du mot avec cette construction.

Il y a deux formes pour effectuer cette double redirection :

On préfère généralement la première. Elle est sémantiquement équivalente à

Document en ligne¶

Avec ce type de redirection, le shell va lire son entrée standard jusqu'à ce qu'il atteigne une ligne contenant uniquement le mot prévu (sans espaces à la suite), nommée étiquette. Une fois cette étiquette atteinte, il exécutera la commande demandée en lui fournissant en entrée le texte lu avant l'étiquette, que l'on appelle document en ligne.

Le format des documents en ligne est le suivant :

<<[-]mot


        document en ligne
étiquette

Il n'y a ni remplacement de paramètre, ni substitution de commande, ni développement de chemin d'accès, ni évaluation arithmétique sur le mot. Si l'un des caractères du mot est protégé, l' étiquette est obtenue après suppression des protections dans le mot, et les lignes du document ne sont pas développées. Sinon, toutes les lignes du document sont soumises au remplacement des paramètres, à la substitution de commandes, et à l'évaluation arithmétique. Dans ce dernier cas, les couples \<retour-chariot> sont ignorés, et \ doit être utilisé pour protéger les caractères \, $, et `.

Si l'opérateur de redirection est <<-, alors les tabulations en tête de chaque ligne sont supprimées, y compris dans la ligne contenant étiquette. Ceci permet d'indenter de manière naturelle les documents en ligne au sein des scripts.

Chaînes en ligne¶

Une variante aux documents en ligne, le format est :

<<<mot

Le mot est développé et fourni à la commande sur son entrée standard.

Dédoublement de descripteur de fichier¶

L'opérateur de redirection

permet de dupliquer les descripteurs de fichiers en entrée. Si le mot se transforme en un ou plusieurs chiffres, le descripteur de fichier n devient une copie de ce descripteur. Si les chiffres du mot ne correspondent pas à un descripteur en lecture, une erreur se produit. Si le mot prend la forme -, le descripteur n est fermé. Si n n'est pas mentionné, on utilise l'entrée standard (descripteur 0).

L'opérateur

est utilisé de manière similaire pour dupliquer les descripteurs de sortie. Si n n'est pas précisé, on considère la sortie standard (descripteur 1). Si les chiffres du mot ne correspondent pas à un descripteur en écriture, une erreur se produit. Un cas particulier se produit si n est omis, et si mot ne se développe pas sous forme de chiffres. Alors, les sorties standard et d'erreurs sont toutes deux redirigées comme précédemment.

Déplacement de descripteurs de fichiers¶

L'opérateur de redirection

déplace le descripteur de fichier chiffre vers le descripteur de fichier n, ou sur l'entrée standard (descripteur de fichier 0) si n n'est pas spécifié. chiffre est fermé après avoir été dédoublé en IR n .

De la même manière, l'opérateur de redirection

déplace le descripteur de fichier chiffre vers le descripteur de fichier n sour sur la sortie standard (descripteur de fichier 1) si n n'est pas spécifié.

Ouverture en Lecture/Écriture d'un descripteur de fichier¶

L'opérateur de redirection

ouvre le fichier dont le nom résulte du développement du mot, à la fois en lecture et en écriture et lui affecte le descripteur de fichier n, ou bien le descripteur 0 si n n'est pas mentionné. Si le fichier n'existe pas, il est créé.

Notation Readline¶

Dans ce paragraphe on utilisera la notation « à la emacs » pour indiquer les séquences de touches. Les touches Contrôle sont notées C-touche, par exemple C-n signifie Contrôle-N. De même, les touches Méta sont notées par M-touche, ainsi M-x signifie Méta-X. (Sur les claviers sans touches Méta, M-x signifie ESC x (sur les claviers français, ESC est noté Échappement), autrement dit presser la touche Échappement puis la touche x. On dit alors qu'ESC est le préfixe méta. La séquence M-C-x signifie ESC-Contrôle-x, ou encore Presser la touche Échappement puis maintenez la touche Contrôle enfoncée tout en pressant la touche x.

Les commandes readline peuvent recevoir des arguments numériques, qui fonctionnent en règle générale comme compteurs de répétitions. Parfois, néanmoins le signe de l'argument est significatif. L'utilisation d'un argument négatif pour une commande agissant dans un sens donné (par ex. kill-line) fait agir la commande en sens inverse. Les commandes ayant un comportement différent sont indiqués plus bas.

Lorsqu'une commande est indiquée comme détruisant du texte, le texte effacé est en fait disponible pour une récupération ultérieure. Il est sauvé dans un tampon circulaire. Les suppressions successives accumulent les textes en un seul bloc qui peut être récupéré en une fois. Les commandes non destructrices séparent les blocs de textes dans le tampon circulaire.

Initialisation de Readline¶

L'affectation par défaut des touches peut être modifiée dans un fichier d'initialisation (inputrc). Le nom de ce fichier est lu dans la variable shell INPUTRC. Si la variable n'existe pas, le nom par défaut est ~/.inputrc. Quand un programme utilisant la bibliothèque readline démarre, les fichiers d'initialisation sont lus, et les affectations de touches et de variables sont mises en place. Il n'y a que peu d' constructions possibles dans les fichiers d'initialisation de Readline. Les lignes blanches sont ignorées. Les lignes commençant par # sont des commentaires. Les lignes commençant par $ indiquent des constructions conditionnelles. Les autres lignes sont des affectations de touches ou de variables.

Les affectations par défaut des touches peuvent être modifiés par un fichier inputrc d'initialisation. D'autres programmes qui utilisent cette bibliothèque peuvent ajouter leurs propres affectations de touches.

Par exemple, en plaçant

Les caractères symboliques suivants sont acceptés : RUBOUT, DEL, ESC, LFD, NEWLINE, RET, RETURN, SPC, SPACE, et TAB. En plus des noms de commandes, readline permet d'affecter à une touche une chaîne de caractères qui sera insérée lors de la pression (macro).

Affectation des touches de Readline¶

La syntaxe des affectations de touches dans le fichier ~/.inputrc est simple. Les seules choses nécessaires sont le nom d'une commande, ou le texte d'une macro, et la séquence de touches à laquelle il faut l'affecter. Les touches peuvent être indiquées de deux manières : sous forme de nom symbolique, éventuellement précédé de Meta- ou Control-, ou sous forme de séquence de touches.

Avec la forme touche:nom_de_fonction ou macro, touche est le nom de la séquence de touches épelée en Anglais. Par exemple :

Dans ces exemples, C-u est assigné à la fonction universal-argument, M-DEL à la fonction backward-kill-word, et C-o est affecté à la macro exprimée dans la partie gauche (c'est-à-dire insérera « > sortie » sur la ligne).

Avec la seconde forme, "touches":nom_de_fonction ou macro, touches n'est plus un nom symbolique, mais décrit une séquence complète de touches entre guillemets. Certaines séquences d'échappement dans le style GNU Emacs peuvent être utilisées, comme dans l'exemple suivant, mais les noms de caractères symboliques ne sont pas reconnus :

Dans cet exemple, C-u est à nouveau affecté à la fonction universal-argument, C-x C-r à la fonction re-read-init-file, et ESC [ 1 1 ~ insérera le texte « Touche Fonction 1 ». L'ensemble complet des séquences d'échappement est le suivant :

En plus des séquences dans le style GNU Emacs, un second jeu de séquences d'échappement est disponible

Lorsque l'on saisit le texte d'une macro, il faut utiliser des apostrophes ou des guillemets pour indiquer la définition de la macro. Les textes non protégés sont considérés comme des noms de fonctions. La barre oblique inverse protégera n'importe quel caractère dans la définition d'une macro, y compris " et '.

Bash permet d'afficher ou de modifier les affectations des touches avec la commande interne bind. On peut changer de mode d'édition durant une session interactive en utilisant l'option -o de la commande interne set (voir le paragraphe COMMANDES INTERNES DU SHELL plus bas).

Variables de Readline¶

Readline dispose de variables permettant de personnaliser encore plus son comportement. Une variable peut être configurée dans le fichier inputrc avec une déclaration de la forme

Sauf contre-indication, les variables de readline prennent les valeurs On ou Off (la casse étant sans importance) Les noms de variables non reconnues sont ignorés. Lorsqu'une valeur de variable est lue, les variables vides ou de valeur nulle, « on » (insensible à la casse) et « 1 » sont équivalent à On. Toutes les autres valeurs sont équivalentes à Off. Les variables, et leurs valeurs par défaut, sont :

bell-style (audible)

Cette variable commande readline lorsqu'il faut déclencher le signal sonore du terminal. Si cette variable contient la valeur none, readline n'utilise pas de signal, si elle contient visible, on utilise un avertisseur visuel, si elle contient audible, readline essaie le signal sonore du terminal.

bind-tty-special-chars (On)

Si elle est positionnée à On, readline tente de relier les caractères de contrôle traités de manière particulière par le pilote de terminal du noyau pour leurs équilavents readline.

comment-begin (« # »)

Cette chaîne est insérée quand la commande readline insert-comment est exécutée. Elle est affectée à M-en mode emacs, et # en mode vi.

completion-ignore-case (Off)

Sur On, Readline effectue les comparaisons et complétions de noms de fichiers en différenciant les majuscules et minuscules.

completion-query-items (100)

Lors de la complétion de commandes, si le nombre de possibilités est supérieur à cette valeur, on demandera confirmation à l'utilisateur avant d'afficher la liste des possibilités. Le nombre de complétions possibles est déterminé par la commande possible-completions. Il peut s'agir de n'importe quelle valeur entière supérieure ou égale à zéro

convert-meta (On)

Si cette variable contient la valeur On, readline transformera en séquences ASCII les caractères ayant leur huitième bit à 1. Il supprimera ce huitième bit, et insérera comme préfixe le caractère d'échappement (en utilisant ce caractère d'échappement comme préfixe méta).

disable-completion (Off)

Si cette variable contient On, Readline désactivera la complétion des mots. Les caractères de complétion seront insérés sur la ligne comme s'ils avaient été associé à self-insert.

editing-mode (emacs)

Cette variable indique si readline doit démarrer avec des affectations de touches similaires à emacs ou à vi. editing-mode peut prendre les valeurs emacs ou vi.

enable-keypad (Off)

Sur On, Readline essayera d'activer le clavier de l'application lorsqu'elle sera invoquée. Sur certains systèmes, cela est nécessaire pour utiliser les touches flèchées.

expand-tilde (Off)

Si cette variable contient la valeur on, le développement du tilde est effectué lorsque readline tente une complétion de commandes.

history-preserve-point (Off)

Si cette variable contient la valeur On, le code de l'historique tente de placer un point au même endroit sur chaque ligne de l'historique avec previous-history ou next-history.

horizontal-scroll-mode (Off)

Si cette variable contient la valeur On, readline utilisera une seule ligne d'affichage, et la fera défiler horizontalement si elle devient plus longue que la largeur de l'écran, plutôt que de basculer sur une nouvelle ligne.

input-meta (Off)

Si cette variable contient la valeur On, readline acceptera des saisies sur huit bits (autrement dit il ne supprimera pas le huitième bit), quelque soit le terminal utilisé. Le nom meta-flag est un synonyme pour cette variable.

isearch-terminators (« C-[C-J »)

La chaîne de caractères qui doivent terminer une recherche incrémentale sans que le caractère ne soit exécuté comme une commande. Si cette variable n'a pas de valeur, les caractères ESC et C-J termineront une recherche incrémentale.

keymap (emacs)

Configure l'affectation des touches. Les jeux d'affectations disponibles sont emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command, et vi-insert. vi est équivalent à vi-command; emacs est équivalent à emacs-standard. La valeur par défaut est emacs; notez que la configuration de la variable editing-mode modifie aussi l'affectation par défaut.

mark-directories (On)

Sur On, les noms de répertoires sont complétés par un slash.

mark-modified-lines (Off)

Sur On, les lignes d'historique qui ont été modifiées seront précédées à l'affichage d'un astérisque (*).

mark-symlinked-directories (Off)

Si cette variable contient la valeur On, complète les noms qui sont des liens vers des répertoires qui ont une barre oblique (sujet à la valeur de mark-directories).

match-hidden-files (On)

Si cette variable contient la valeur On, readline fait correspondre les fichiers dont le nom commence par un point « . » (fichiers cachés) lors de la réalisation de l'auto-complétion, à moins que le « . » de tête ne soit fourni par l'utilisateur dans le nom de fichier à compléter.

output-meta (Off)

Si cette variable contient la valeur On, readline affichera directement les caractères ayant leur huitième bit à 1, plutôt que d'utiliser une séquence d'échappement avec le préfixe méta.

page-completions (On)

Si cette variable contient la valeur On, readline utilise un visualisateur interne de style more pour afficher un plein écran des possibles complétions.

print-completions-horizontally (Off)

Sur On, Readline affichera les possibilités de complétions triés horizontalement dans l'ordre alphabétique plutôt que verticalement.

show-all-if-ambiguous (Off)

Cette variable agit sur la complétion des commandes. Lorsqu'elle contient la valeur on, toutes les complétions possibles sont affichées immédiatement plutôt que de déclencher l'avertisseur sonore.

show-all-if-unmodified (Off)

Ceci modifie le comportement par défaut des fonctions de complétion de manière similaire à show-all-if-ambiguous. Si cette variable contient on, les mots qui ont plus d'une complétion possible sans complétion partielle possible (les complétions possibles ne partagent pas de prefix commun) font que les correspondances seront immédiatement affichées au lieu de faire bipper.

visible-stats (Off)

Sur On, un caractère indiquant le type de fichier, comme fourni par l'appel-système stat(2) sera ajouté aux noms de fichiers lors de l'affichage des complétions possibles.

Constructions conditionnelles de Readine¶

Readline propose un mécanisme inspiré des possibilités de compilation conditionnelle en C, qui permet d'effectuer certaines assignations de variables, ou affectations de touches en fonction du résultat d'un test. Il y a quatre directives utilisables.

$if

La structure $if permet d'affecter les touches en fonction du mode d'édition, du terminal de saisie, ou de l'application qui utilise la bibliothèque readline. Le texte du test se trouve à la suite du $if, jusqu'à la fin de la ligne.

$if Bash
# Protéger le mot actuel ou le précédent
"\C-xq": "\eb\"\ef\""
$endif

$endif

Cette commande, comme on l'a vu dans l'exemple ci-dessus, termine une commande $if.

$else

Permet d'ajouter des commandes qui seront exécutées si un $if échoue.

$include

Cette directive prend un simple nom de fichier en argument et y lit les commandes et les affectations. Par exemple, la directive suivante lit le fichier /etc/inputrc:

$include  /etc/inputrc

Recherche¶

Readline propose des commandes de recherche au sein de l'historique de commandes (voir HISTORIQUE plus bas) des lignes contenant une chaîne donnée. Il y a deux modes de recherche : incrémental et non-incrémental.

Les recherches incrémentales commencent avant même que l'utilisateur ait terminé de saisir la chaîne recherchée. À chaque caractère saisi, Readline affiche l'entrée suivante de l'historique qui corresponde à la chaîne déjà entrée. Une recherche incrémentale nécessite seulement le nombre de caractères indispensable pour retrouver l'entrée d'historique désirée. Les caractères se trouvant dans la variable isearch-terminators servent à terminer une recherche incrémentale. Si cette variable n'a pas de valeur, les caractères Escape et Contrôle-J terminent une recherche incrémentale. Contrôle-G permet d'interrompre une recherche incrémentale de reprendre la ligne originale. Lorsque la recherche est finie, l'entrée d'historique contenant la chaîne désirée devient la ligne en cours. Poue trouver une autre entrée d'historique correspondant aussi, il faut taper Contrôle-S ou Contrôle-R. Cela recherchera en avant ou en arrière l'entrée d'historique suivante qui corresponde à la chaîne saisie jusque là. Toute séquence de touche affectée à une commande Readline terminera la recherche et exécutera la commande. Par exemple, un newline terminera la recherche et validera la ligne, ce qui exécute la commande de la ligne d'historique.

Readline se souvient de la dernière chaîne de recherche incrémentale. Si deux Contrôle-R sont tapés sans caractère pour définir une nouvelle recherche de chaîne, toute chaîne mémorisée sera utilisée.

Les recherches non-incrémentales lisent la chaîne désirée en entier avant de démarrer la recherche de correspondance dans la liste d'historique. La chaîne peut être saisie par l'utilisateur ou se trouver sur la ligne en cours.

Noms des commandes Readline¶

Voici une liste des noms de commandes, ainsi que les séquences de touches auxquelles elles sont attribuées par défaut. Les commandes sans séquence indiquée n'ont pas d'affectation par défaut.

Commandes de déplacement¶

beginning-of-line (C-a)

Saut au début de la ligne en cours.

end-of-line (C-e)

Saut à la fin de la ligne.

forward-char (C-f)

Avancer d'un caractère.

backward-char (C-b)

Reculer d'un caractère.

forward-word (M-f)

Avancer jusqu'à la fin du mot suivant. Les mots sont composés de caractères alphanumériques (lettres et chiffres).

backward-word (M-b)

Reculer jusqu'au début du mot courant, ou du précédent. Les mots sont composés de caractères alphanumériques (lettres et chiffres).

clear-screen (C-l)

Effacer l'écran, en laissant la ligne courante en haut de l'écran. S'il y a un argument, rafraîchir la ligne en cours sans effacer l'écran.

redraw-current-line

Rafraîchir la ligne en cours. Par défaut pas d'affectation de touche.

Commandes de manipulation de l'historique¶

accept-line (Retour-Chariot)

Valider la ligne, sans se soucier de l'emplacement du curseur. Si la ligne n'est pas vide, l'ajouter à la liste d'historique, sous contrôle de la variable HISTCONTROL. Si cette ligne est une modification d'une ligne de l'historique, restaurer cette dernière.

previous-history (C-p)

Récupérer la commande précédente de la liste d'historique.

next-history (C-n)

Récupérer la commande suivante dans la liste d'historique.

beginning-of-history (M-<)

Récupérer la première ligne de l'historique.

end-of-history (M->)

Retourner à la fin de l'historique, c'est-à-dire à la ligne en cours d'édition.

reverse-search-history (C-r)

Rechercher en arrière dans l'historique, en remontant. C'est une recherche incrémentale.

forward-search-history (C-s)

Rechercher en avant dans l'historique, en descendant. C'est une recherche incrémentale.

non-incremental-reverse-search-history (M-p)

Rechercher une chaîne en arrière dans l'historique, en remontant depuis la ligne actuelle, utiliser une recherche non-incrémentale.

non-incremental-forward-search-history (M-n)

Rechercher une chaîne en avant dans l'historique, utiliser une recherche non-incrémentale.

history-search-forward

Rechercher en avant dans l'historique la chaîne comprise entre le début de la ligne actuelle, et la position du curseur. Par défaut cette commande n'est affectée à aucune touche. Cette une recherche non-incrémentale.

history-search-backward

Rechercher en arrière dans l'historique la chaîne comprise entre le début de la ligne actuelle, et la position du curseur. Cette une recherche non-incrémentale.

yank-nth-arg (M-C-y)

Insérer, à l'emplacement du curseur, le premier argument de la commande précédente. Généralement, il s'agit du second mot de la ligne précédente. Avec un argument n, insérer le nième mot de la commande précédente (les mots sont numérotés à partir de 0). Un argument négatif insère le nième mot en partant de la fin de la commande précédente. Une fois que l'argument n est traité, l'argument est extrait comme si le développement d'historique « !n » avait été spécifié.

yank-last-arg (M-., M-_)

Insérer à la position du curseur le dernier argument de la commande précédente (le dernier mot de la ligne précédente). Avec un argument, se comporte exactement comme yank-nth-arg. Les appels successifs à yank-last-arg reviennent en arrière dans l'historique en insérant le dernier argument de chaque ligne à chaque fois. Les fonctionnalités de développement d'historique sont utilisés pour extraire le dernier argument, comme si le développement d'historique « !$ » avait été spécifié.

shell-expand-line (M-C-e)

Développer, comme le fait le shell, la ligne en cours. Ceci inclut le remplacement des alias et des directives d'historique, aussi bien que l'ensemble des expansions effectuées par le shell. Voir EXPANSION DE L'HISTORIQUE plus bas, pour une description détaillée.

history-expand-line (M-^)

Effectuer l'expansion d'historique sur la ligne en cours. Voir le paragraphe EXPANSION DE L'HISTORIQUE plus bas, pour une description détaillée.

magic-space

Effectuer l'expansion de l'historique sur la ligne en cours et insérer une espace. Voir EXPANSION DE L'HISTORIQUE plus bas, pour une description détaillée.

alias-expand-line

Effectuer l'expansion des alias sur la ligne en cours. Voir ALIAS plus bas pour une description des expansions d'alias.

history-and-alias-expand-line

Effectuer l'expansion de l'historique et des alias sur la ligne en cours.

insert-last-argument (M-., M-_)

un synonyme de yank-last-arg.

operate-and-get-next (C-o)

Valider la ligne en cours, et récupérer la ligne suivante de l'historique pour l'édition. Tout argument est ignoré.

edit-and-execute-command (C-xC-e)

Invoque un éditeur sur la ligne de commande courante et exécute le résultat comme une commande shell. Bash tente d'invoquer $FCEDIT, $EDITOR, et emacs comme éditeur, dans cet ordre.

Commande d'édition de texte¶

delete-char (C-d)

Effacer le caractère sous le curseur. Si le curseur est au début de la ligne, si celle-ci est vide, et si le dernier caractère frappé n'était pas delete-char, alors la valeur renvoyée est EOF.

backward-delete-char (Rubout)

Effacer le caractère derrière le curseur. Lorsque un argument est fourni, le texte effacé est sauvegardé dans le tampon circulaire.

forward-backward-delete-char

Effacer le caractère sous le curseur, sauf s'il est en fin de ligne, auquel cas le caractère derrière le curseur est effacé.

quoted-insert (C-q, C-v)

Ajouter littéralement sur la ligne le caractère frappé suivant. Ceci permet d'insérer des caractères comme C-q, par exemple.

tab-insert (C-v TAB)

Insérer un caractère de tabulation.

self-insert (a, b, A, 1, !, ...)

Insérer le caractère mentionné.

transpose-chars (C-t)

Échanger les caractères se trouvant devant et sous le curseur. Le curseur est avancé d'un caractère. À la fin d'une ligne, les caractères échangés sont les deux précédents. Les arguments négatifs ne sont pas acceptés.

transpose-words (M-t)

Échanger le mot où se trouve le curseur et le mot précédent, puis avancer le curseur après ce mot. Si le curseur est à la fin de la ligne, les mots échangés sont les deux derniers de la ligne.

upcase-word (M-u)

Transformer le mot en cours (ou le suivant) en majuscules. Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

downcase-word (M-l)

Transformer le mot en cours (ou le suivant) en minuscules. Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

capitalize-word (M-c)

Passer en majuscule l'initiale du mot en cours (ou du suivant). Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

overwrite-mode

Basculer en mode d'écrasement. Avec un argument numérique positif explicite, bascule en mode d'écrasement. Avec un argument numérique non-positif explicite, bascule en mode d'insertion. Cette commande n'affecte que le mode emacs ; le mode vi écrase de manière différente. Chaque appel à readline(3) démarre en mode d'insertion. En mode d'écrasement, les caractères liés à self-insert remplacent le texte sous le curseur plutôt que de le déplacer vers la droite. Les caractères liés à backward-delete-char remplacent le caractère avant le curseur par une espace. Par défaut, cette commande n'est pas liée.

Effacement et récupération¶

kill-line (C-k)

Effacer le texte depuis l'emplacement du curseur jusqu'à la fin de la ligne.

backward-kill-line (C-x C-Rubout)

Effacer en arrière jusqu'au début de ligne.

unix-line-discard (C-u)

Effacer le texte entre le début de la ligne et l'emplacement du curseur. Le texte est sauvegardé dans le tampon circulaire.

kill-whole-line

Effacer toute la ligne sans tenir compte de la position du curseur.

kill-word (M-d)

Effacer le texte entre l'emplacement du curseur et la fin du mot en cours, ou jusqu'à la fin du mot suivant si le curseur est entre deux mots. Les séparations de mots sont les mêmes que celles de forward-word.

backward-kill-word (M-Rubout)

Effacer le mot sous le curseur. Les séparations de mots sont les mêmes que celles de backward-word.

unix-word-rubout (C-w)

Effacer le mot derrière le curseur, en utilisant l'espace blanc comme limite de mot. Cette limite est différente de celle de backward-kill-word. Le texte est sauvegardé dans le tampon circulaire.

unix-filename-rubout

Effacer le mot derrière le curseur, en utilisant l'espace blanc et la barre oblique comme limite de mot. Le texte est sauvegardé dans le tampon circulaire.

delete-horizontal-space (M-\)

Effacer tous les espaces blancs et les tabulations autour du curseur.

kill-region

Détruire le texte entre le curseur et la marque (position du curseur sauvegardée précédemment). On appelle ceci une région.

copy-region-as-kill

Copier le texte de la région vers le tampon circulaire.

copy-backward-word

Copier le mot précédant le curseur dans le tampon circulaire. Les séparations de mots sont les mêmes que celles de backward-word.

copy-forward-word

Copier le mot suivant le curseur dans le tampon circulaire. Les séparations de mots sont les mêmes que celles de backward-word.

yank (C-y)

Récupérer le texte au sommet du tampon circulaire.

yank-pop (M-y)

Exécuter une rotation du tampon circulaire, et récupérer le nouveau texte situé à son sommet. Ceci ne fonctionne qu'après yank ou yank-pop.

Arguments numériques¶

digit-argument (M-0, M-1, ..., M--)

Ajouter le chiffre aux arguments déjà présents, ou créer un nouvel argument. M-- crée un argument négatif.

universal-argument

Il s'agit d'une autre manière d'indiquer un argument. Si cette commande est suivie d'un ou plusieurs chiffres éventuellement précédés d'un signe moins, ces chiffres consituent un argument. Si la commande est suivie de chiffres, une nouvelle exécution de universal-argument termine l'argument numérique, mais est ignorée dans les autres cas. De plus, si la commande est suivie immédiatement par un caractère autre qu'un chiffre ou le signe moins, le compteur d'argument de la commande suivante est multiplié par 4. Le compteur d'argument est initialement à un, ainsi la première exécution de cette commande l'amène à quatre, la seconde à seize, et ainsi de suite.

Complétion¶

complete (TAB)

Essayer d'effectuer une complétion du texte situé avant le curseur. Bash effectue la complétion en considérant successivement le texte comme une variable (s'il commence par $), un nom d'utilisateur (s'il commence par ~), un nom d'hôte (s'il commence par @), ou une commande (y compris les alias et les fonctions). Si rien ne fonctionne, il essaye la complétion en nom de fichier.

possible-completions (M-?)

Affiche la liste des complétions possibles pour le texte situé avant le curseur.

insert-completions (M-*)

Insérer avant le curseur l'ensemble des complétions qui seraient fournies par possible-completions.

menu-complete

Comme complete, mais en remplaçant le mot à compléter par une seule correspondance de la liste des complétions possibles. Des exécutions répétées de menu-complete parcourrent la liste des complétions possibles, en insérant une correspondance à chaque fois. À la fin de la liste des complétions, l'alarme sonore est déclenchée (en fonction de la configuration de bell-style) et le texte initial est récupéré. Un argument n déplace de n positions dans la liste de correspondances. Un argument négatif peut être utilisé pour revenir en arrière dans la liste. Cette commande est prévue pour être associée à la touche TAB, mais n'est pas affectée par défaut.

delete-char-or-list

Effacer le caractère sous le curseur sauf au début ou en fin de ligne (comme delete-char). En fin de ligne, se comporte comme possible-completions. Cette commande n'est associée à aucune touche par défaut.

complete-filename (M-/)

Essayer la complétion des noms de fichiers sur le texte situé avant le curseur.

possible-filename-completions (C-x /)

Affiche la liste des complétions possibles en noms de fichiers pour le texte situé avant le curseur.

complete-username (M-~)

Essayer la complétion des noms d'utilisateurs sur le texte situé avant le curseur.

possible-username-completions (C-x ~)

Affiche la liste des complétions possibles en noms d'utilisateurs pour le texte situé avant le curseur.

complete-variable (M-$)

Essayer la complétion des noms de variables shell sur le texte situé avant le curseur.

possible-variable-completions (C-x $)

Affiche la liste des complétions possibles en noms de variables shell pour le texte situé avant le curseur.

complete-hostname (M-@)

Essayer la complétion des noms d'hôtes sur le texte situé avant le curseur.

possible-hostname-completions (C-x @)

Affiche la liste des complétions possibles en noms d'hôtes pour le texte situé avant le curseur.

complete-command (M-!)

Essayer la complétion des commandes sur le texte situé avant le curseur. La complétion des commandes inclut les alias, les mots réservés, les fonctions shell, les fonctions internes, et finalement les exécutables, dans cet ordre.

possible-command-completions (C-x !)

Affiche la liste des complétions possibles en noms de commandes pour le texte situé avant le curseur.

dynamic-complete-history (M-TAB)

Essayer la complétion du texte situé avant le curseur, en recherchant dans la liste d'historique.

complete-into-braces (M-{)

Renvoie entre accolades la liste des complétions possibles en noms de fichiers du texte avant le curseur, afin qu'elle soit utilisable par le shell (voir Expansion des Accolades plus haut).

Macros Claviers¶

start-kbd-macro (C-x ()

Démarre la mémorisation dans la macro en cours des caractères tapés.

end-kbd-macro (C-x ))

Arrête la mémorisation dans la macro en cours des caractères tapés, et sauvegarde la définition.

call-last-kbd-macro (C-x e)

Ré-exécute la dernière macro définie, en agissant comme si les caractères contenus dans cette macro étaient tapés au clavier.

Divers¶

re-read-init-file (C-x C-r)

Lire le contenu du fichier d'initialisation personnalisée, en incorporant les assignations de variables, ou les affectations de touches qui s'y trouvent.

abort (C-g)

Abandonner l'édition en cours et déclencher l'avertisseur sonore (soumis à la configuration de la variable bell-style).

do-uppercase-version (M-a, M-b, M-x, ..)

Si le caractère précédé de Méta x est en minuscule, exécuter la commande correspondant aux caractères majuscules indiqués.

prefix-meta (ESC)

Considérer le prochain caractère tapé comme une séquence Meta. ESC f est équivalent à Meta-f.

undo (C-_, C-x C-u)

Fonction d'annulation incrémentale, chaque ligne étant mémorisée séparément.

revert-line (M-r)

Annuler toutes les modifications sur cette ligne. Ceci est équivalent à répéter undo en nombre suffisant pour ramener la ligne à son état initial.

tilde-expand (M-~)

Effectuer le développement du tilde sur le mot en cours.

set-mark (C-@, M-<space>)

Placer une marque à la position actuelle. Si un argument numérique est fourni, la marque est posée à l'emplacement correspondant.

exchange-point-and-mark (C-x C-x)

Échanger le curseur et la marque. Le curseur est placée à la position sauvegardée précédemment, et l'ancien curseur est mémorisé par la marque.

character-search (C-])

Un caractère est lu et le curseur déplacé à l'occurrence suivante de ce caractère. Un argument négatif recherche les occurrences précédentes.

character-search-backward (M-C-])

Un caractère est lu et le curseur déplacé à l'occurrence précédente de ce caractère. Un argument négatif recherche les occurrences suivantes.

insert-comment (M-#)

Sans argument numérique, la valeur de la variable readline comment-begin est insérée au début de la ligne en cours. Si un argument numérique est fourni, cette commande agit comme une « touche à bascule » : si les caractères du début de ligne ne correspondent pas à la valeur de comment-begin, la valeur est insérée. Autrement, les caractères dans comment-begin sont effacés du début de la ligne Dans les autres cas, la ligne est validée comme si on avait tappé Newline. Ceci sert à transformer la ligne en cours en commentaire du shell. Si un argument numérique provoque l'effacement du caractère de commentaire, la ligne sera exécutée par le shell.

glob-complete-word (M-g)

le mot avant le curseur est traité comme un motif pour un développement de chemin, avec un astérique implicitement ajouté. Le motif est utilisé pour générer une liste de noms de fichier correpondants pour de possibles complétions.

glob-expand-word (C-x *)

Le mot précédant le curseur est considéré comme un motif d'expansion de nom de fichier et la liste des possibilités est insérée à sa place. Si un argument numérique est fourni, un astérisque est ajouté avant le développement du nom de chemin.

glob-list-expansions (C-x g)

La liste des développements qui aurait été produite par glob-expand-word est affichée et la ligne est rafraîchie. Si un argument numérique est fourni, un astérisque est ajouté avant le développement du nom de chemin.

dump-functions

Afficher toutes les fonctions et leurs assignations de touches sur le flux de sortie de readline. Si un argument numérique est présent, la sortie est mise en forme pour être compatible avec le format d'un fichier inputrc.

dump-variables

Afficher toutes les variables Readline modifiables et leurs valeurs sur le flux de sortie. Si un argument numérique est fournie, la sortie est formatée pour pouvoir être acceptée comme contenu d'un fichier inputrc.

dump-macros

Afficher toutes les séquences de touches associées à des macros et les chaînes auxquelles elles correspondent. Un argument numérique réclame que la sortie soit mise en forme pour être compatible avec le format d'un fichier inputrc.

display-shell-version (C-x C-v)

Afficher des informations sur la version en cours de bash.

Complétion programmable¶

Lorsqu'une complétion est tentée pour l'argument d'une commande pour laquelle une spécification de complétion a été définie en utilisant la commande interne complete (voir COMMANDES INTERNES DU SHELL pluss loin), les fonctionnalités de complétion programmable sont invoquées.

En premier lieu, le nom de la commande est identifiée. Si une spécification de complétion a été définie pour cette commande, elle est utilisée pour générer la liste des complétions possible pour le mot. Si le mot commande est un chemin complet, on cherche en premier lieu une spécification de complétion pour le chemin complet. Si aucune spécification de complétion n'est trouvée pour le chemin complet, une tentative est effectuée pour trouver une spécification de complétion pour la portion suivant la barre oblique finale.

Une fois que la spécification de complétion a été trouvée, elle est utilisée pour générer la liste des mots correspondants. Si aucune spécification de complétion n'est trouvée, la complétion par défaut de bash, telle qu'elle est décrite plus haut dans le paragraphe Complétion est effectuée.

Tout d'abord, les actions définies par la spécification de complétion sont utilisées. Seules les correspondances qui sont préfixées par le mot à compléter sont renvoyées. Lorsque l'option -f ou -d est utilisée pour la complétion des noms de fichiers ou de répertoire, la variable shell FIGNORE est utilisée pour filtrer les correspondances.

Toutes les complétions spécifiées par le motif de développement de nom de fichier de l'option -G sont à nouveau générées. Il n'est pas nécessaire que les mots générés par le motif correspondent au mot à compléter. La variable shell GLOBIGNORE n'est pas utilisée pour filtrer les correspondances, mais la variable FIGNORE est utilisée.

Ensuite, la chaîne spécifiée comme argument à l'option -W est prise en compte. Cette chaîne est tout d'abord coupée en utilisant les caractères de la variable spéciale IFS comme délimiteurs. La citation (Ndt : quoting) shell est prise en compte. Chaque mot est ensuite développé en utilisant les développements d'accolades, du tilde, des paramètres et des variables, de même que la substitution de commande et le développement arithmétique comme décrit plus haut dans le paragraphe EXPANSION. Les résultats sont séparés en utilisant les règles décrites plus haut dans le paragraphe Séparation des mots. Les résultats du développement sont comparés au mot à compléter en considérant ce dernier comme préfixe et les mots correspondants deviennent les complétions possibles.

Après que ces correspondances aient été générées, toute fonction shell ou commande spécifiées avec les options -F et -C sont invoquées. Lorsque la commande ou la fonction est invoquée, les variables COMP_LINE et COMP_POINT se voient affectées de valeurs comme décrit plus haut dans le paragraphe Variables shell. Si une fonction shell est invoqué, les variables COMP_WORDS et COMP_CWORD sont également remplies. Lorsqu'une fonction ou une commande est invoquée, le premier argument est le nom de la commande dont les arguments doivent être complétés, le second argument est le mot à compléter et le troisième argument est le mot précédent celui devant être complété sur la ligne de commande. Aucun filtrage des complétions générées pour le mot à compléter n'est effectué ; la fonction ou la commande à toute liberté dans la génération des correspondances.

Toute fonction invoquée avec -F est invoquée en premier. La fonction peut utiliser toute fonctionnalité du shell, incluant la commande insterne compgen décrite plus loin, pour générer les correspondances. Elle doit mettre les complétions possibles dans la variable tableau COMPREPLY.

Ensuite, toute commande dpécifiée avec l'option -C est invoquée dans un environnement équivalent pour la substitution de commandes. Elle devrait afficher une liste des complétieons possibles, une par ligne, sur la sortie standard. Si nécessaire, une barre oblique inverse doit être utilisée pour protéger un caractère retour chariot.

Après que toutes les complétions possibles aient été générées, un filtre, spécifié avec l'option -X, est appliqué à la liste. Ce filtre est un motif comme utilisé dans le développement de noms de chemins ; un B& dans le motif est remplacé par une barre oblique inverse ; la barre oblique inverse est retirée avant la tentative de mise en correspondance. Un B& littéral doit être protégé par une barre oblique inverse ; la barre oblique inverse est retirée avant la tentative de mise en correspondance. Toute complétion qui correspond au motif sera retirée de la liste. Un B! en tête du motif correspondant à la négation du motif ; dans ce cas, toute complétion ne correspondant pas au motif sera retirée de la liste.

Finalement, tout prefix et suffixe spécifié avec les options -P et -S sont ajoutés à chacun des membres de la liste de complétion, et le résultat est renvoyée au code de complétion de readline comme étant la liste des complétions possibles.

Si les opérations précédemment appliquées ne génèrent aucune correspondance, et si l'option -o dirnames a été fournie à complete lorsque la spécification de complétion a été définie, la complétion des noms de répertoire est tentée.

Si l'option -o plusdirs a été fournie à complete lors de la définition de la spécification de complétion, la complétion des noms de répertoires est tentée et toute correspondance est ajoutée aux résultats des autres actions.

Par défaut, si une spécification de complétion est trouvée, tout ce qui est généré est renvoyé au code de complétion comme un ensemble complet des complétions possibles. Les complétions par défaut de bash ne sont pas tentées et la complétion par defaut de readline ou la complétion de fichiers est déactivée. Si l'option -o bashdefault a été fournie a complete lors de la définition de la spécification de complétion, les complétions par défaut de bash sont tentées si la spécification de complétion ne génère aucune correspondance. Si l'option -o default a été fournie à complete lors de la définition de la spécification de complétion, la complétion par défaut de readline sera effectuée si la spécification de complétion (et, si tentée, les complétions par défaut de bash) ne génère aucune correspondance.

Lorsqu'une spécification de complétion indique qu'une complétion de nom de répertoire est désirée, les fonctions de complétion programmable forcent readline à ajouter une barre oblique pour compléter les noms qui sont des liens symboliques vers des répertoires, en focntion de la valeur de la variable mark-directories de readline, sans tenir compte de la variable mark-symlinked-directories de readline.

Indicateur d'événement¶

Un indicateur d'événement est une référence à une ligne de commande dans la liste d'historique.

!

Débute une substitution de l'historique, sauf s'il est suivi par un blanc, nouvelle-linge, retour-chariot, = ou ( (lorsque l'option shell extglob est active en utilisant la commande interne shopt).

!n

Se réfère à la ligne de commande n.

!-n

Se réfère à la ligne de commande actuelle moins n.

!!

Est une référence à la commande précédente. C'est un synonyme de « `!-1 ».

!chaîne

Référence la plus récente commande commençant par la chaîne.

!?chaîne[?]

Se réfère à la plus récente commande contenant la chaîne. Le ? final peut être omis si la chaîne est suivie immédiatement d'un retour-chariot.

^chaîne_1^chaîne_2^

Substitution rapide. Répéter la dernière commande en remplaçant la chaîne_1 par la chaîne_2. Équivalent à « !!:s/chaîne_1/chaîne_2/ » (voir Modificateurs plus bas).

!#

La ligne entière tapée jusqu'à présent.

Indicateurs de mots¶

Ces indicateurs servent à sélectionner les mots désirés dans un événement. Un : sépare l'indicateur d'événements de l'indicateur de mot. On peut l'omettre si l'indicateur de mot commence par ^, $, *, -, ou %. Les mots sont numérotés depuis le début de la ligne, le premier étant note 0 (zéro). Les mots sont insérés dans la ligne courante, séparés par des espaces.

0 (zéro)

Le zéro-ième mot. Pour le shell, c'est le nom de la commande.

n

Le n-ième mot.

^

Le premier argument, c'est-à-dire le mot 1.

$

Le dernier argument.

%

Le mot correspondant à la recherche la plus récente « ?chaîne? ».

x-y

Un intervalle de mots, « -y » permet d'abréger « 0-y ».

*

Tous les mots sauf le zéro-ième. C'est un synonyme pour « 1-$ ». Même s'il n'y a qu'un mot, * ne déclenche pas d'erreur, simplement la chaîne vide est renvoyée.

x*

Abréviation de x-$.

x-

Abréviation de x-$ comme x*, mais sans le dernier mot.

Si un indicateur de mot est founi sans indication d'événement, la dernière commande est utilisée.

Modificateurs¶

Après l'éventuel indicateur de mot, vous pouvez ajouter une séquence de modificateurs, chacun précédé par un « : ».

h

Élimine la fin du chemin d'accès, ne laissant que son début.

t

Supprimer tout le début d'un chemin d'accès, en ne laissant que la fin.

r

Supprime un suffixe final de la forme .xxx, en ne laissant que le nom de base.

e

Tout supprimer sauf le suffixe final.

p

Afficher la nouvelle commande sans l'exécuter.

q

Protéger les mots substitués, pour éviter les substitutions futures.

x

Protéger les mots substitués, comme avec q, mais en faisant la séparation des mots sur les blancs et les retour-chariots.

s/ancien/nouveau/

Remplacer par nouveau la première occurrence de ancien sur la ligne d'événement. N'importe quel délimiteur peut être utilisé à la place de /. Le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événement. Le délimiteur peut être protégé dans ancien et nouveau par une simple barre oblique inverse. Si & apparaît dans nouveau, il est remplacé par ancien. Une simple barre oblique inverse protégera le &. Si ancien est nul, il est remplacé par le dernier ancien substitué, ou si aucune substitution n'a eu lieu précédemment, la dernière chaîne dans une recherche !?chaîne[?].

&

Répéter la substitution précédente.

g

Appliquer les changements sur la ligne d'événement entière. On utilise ceci conjointement à « :s » (par exemple « :gs/ancien/nouveau/ ») ou « :& ». S'il est utilisé avec « :s », n'importe quel délimiteur peut être utilisé à la place de « / », et le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événement. Un a peut être utilisé en tant que synonyme de g.

G

Appliquer le modificateur « s » suivant une fois à chacun des mots dans la ligne d'événements.