bash

Nom

Synopsis

Copyright

Description

Bash est entièrement concu pour être conforme aux spécifications IEEE concernant les shells et les outils Posix (Groupe de travail de l'IEEE 1003.2).

Options

-c chaîne

Si l'argument -c est présent, les commandes sont interprétées depuis la chaîne fournie. S'il existe d'autres arguments après la chaîne, ils sont transmis comme paramètres positionnels, en commencant par $0.

-r

Si l'option -r est présente, l'interpréteur est restreint (voir les "SHELLS RESTREINTS").

-i

Si l'option -i est présente, l'interpréteur est interactif.

-s

Si l'argument -s est présent, ou s'il n'y a que des options sur la ligne de commande, L'interprétation se fera depuis l'entrée standard. Cette option permet de remplir les paramètres positionnels tout en invoquant un shell interactif.

-D

Une liste de toutes les chaînes entre '"' et précédées de $ est affichée sur la sortie standarde. Ce sont les chaînes qui sont sujettes à une traduction quand les locales ne sont ni celles du C ni celles du standard POSIX. Cela implique l'option -n ; aucune commande ne sera executée.

--

Deux caractères -- permettent d'indiquer la fin des options, et empêchent le traitement des arguments restants. Ces derniers sont alors traités comme des noms de fichiers et des paramètres. - est équivalent à --.

Bash reconnait également plusieurs options multi-caractères. Ces options doivent apparaitre sur la ligne de commande avant les options mono-caractère.

--dump-po-strings

équivalent à -D, mais la sortie est dans le format des fichiers po de GNU gettext (objet portable).

--dump-strings

équivalent à -D.

--help

Affiche un message sur l'usage de bash sur la sortie standard et quitte en renvoyant un code de retour de succès.

--login

Se comporter comme un shell de login. (Voir INVOCATION).

--noediting

Ne pas utiliser la bibliothèque GNU readline pour la lecture des lignes de commande, lorsque le shell est interactif.

--noprofile

Ne lire ni le fichier de configuration générale /etc/profile ni les fichiers personnalisés ~/.bash_profile, ~/.bash_login, ou ~/.profile. Par défaut bash lit ces fichiers lorsqu'il est invoqué comme shell de login (voir le paragraphe INVOCATION plus bas).

-norc

Ne pas lire le fichier de configuration personnalisée ~/.bashrc lorsque le shell est interactif. Cette option est activée par défaut lorsque l'interpréteur est invoqué sous le nom sh.

--posix

Aligner le comportement de bash sur le standard Posix 1003.2, en ce qui concerne les options dont le comportement par défaut est différent de ce standard.

--rcfile fichier

Executer les commandes contenues dans le fichier mentionne, plutot que celles du fichier de configuration personnelle ~/.bashrc, si le shell est interactif. (voir le paragraphe INVOCATION plus bas).

--restricted

Le shell devient restreint (voir les SHELLS RESTREINTS).

--verbose

équivalent à -v

--version

Afficher le numéro de version de bash sur la sortie standard et terminer en retournant 0.

Arguments

Invocation

Un shell est interactif si son entrée standard et sa sortie standard sont toutes deux connectées à un terminal (déterminé par la fonction isatty(3) ), ou s'il est invoqué avec l'option -i. Le paramètre PS1 est positionné, et le paramètre $- contient la lettre i si bash est interactif, ce qui permet à un script ou à un fichier de démarrage de vérifier l'état du shell.

Le paragraphe suivant décrit comment bash éxécute ses fichiers de d'initialisation. Si l'un de ces fichiers existe mais n'est pas accessible en lecture, bash signale une erreur. Les tildes sont remplacées par des noms de fichiers comme décrit dans Développement du Tilde dans la section Développement.

Les Shells de Login (interactifs ou non) : Au login :
Si /etc/profile existe, il est exécuté.

Si ~/.bash_profile existe, il est exécuté,
Sinon Si ~/.bash_login existe, il est exécuté,
Sinon Si ~/.profile existe, il est exécuté.
L'option -noprofile permet d'empêcher la lecture de ces fichiers

A la sortie :
Si ~/.bash_logout existe, il est exécuté.

Shells interactifs, mais pas de Login : Au démarrage :
Si ~/.bashrc existe, il est exécuté.
L'option -norc permet d'empêcher cette lecture. L'option -rcfile)
permet d'utiliser un autre fichier.

Shells non-interactifs: Au démarrage:
Si la variable d'environnement BASH_ENV est non-nulle, elle est
développée, et le fichier dont elle contient le nom est exécuté,
comme si l'on appliquait la commande
if [ "$BASH_ENV" ]; then . $BASH_ENV; fi
mais on n'utilise pas PATH pour rechercher le chemin d'accès.

Si Bash est invoqué sous le nom sh, il essaye d'imiter au maximum le comportement de la version "historique" de sh autant que possible, tout en essayant de se conformer au standard POSIX. Pour un shell de login, il n'essaye d'exécuter que /etc/profile et ~/.profile, dans cet ordre. L'option -noprofile peut toujours être utilisée pour désactiver ce comportement. Quand il est invoqué en tant que shell interactif sous le nom sh, bash consulte la variable ENV, développe sa vakeur si elle est définie et utilise son développement en tant que nom de fichier à lire et exécuter. Comme un shell invoqué sous le nom sh n'essaye pas d'exécuter aucun autre fichier de démarrage, l'option --rcfile n'a aucun effet. Un shell non interactif invoqué sous le nom sh ne lit aucun autre fichier d'initialisation. Quand il est invoqué sous le nom sh, bash entre en mode posix après avoir lu les fichiers d'initialisation.

Quand bash est invoqué en mode posix, avec l'option -posix sur la ligne de commande, il suit ce standard en ce qui concerne les fichiers de démarrage. Dans ce cas, la variable ENV est développée, et le fichier qui en résulte est exécuté. On n'exécute pas d'autre fichier d'initialisation.

Bash tente de déterminer s'il est exécuté par le démon éxécutant des shells à distances (généralement appellé rshd). Si bash se rend compte qu'il est exécuté par rshd , il lit et exécute les commandes de ~/.bashrs , si ce fichier existe et est accessible en lecture. Il ne fera pas cela comme le ferait sh . L'option --norc peut être utilisé pour interdire ce comportement, et l'option --rcfile permet de forcer l'utilisation d'un autre fichier, mais rshd n'utilise généralement pas ces options ni n'autorise leur utilisation.

Si le shell est lancé avec un numéro de groupe effectif différend du groupe réel de l'utilisateur (GID), et si l'option -p n'est pas appliquée, aucun fichier d'initialisation n'est lu, les fonctions du shell ne sont pas héritées de l'environnement, la variable SHELLOPTS est ignorée si elle apparaît dans l'environnement, et le numéro effectif de l'utilisateur (EUID) est remplacé par l'UID. Si l'option -p est appliquée lors de cette invocation, le comportement au démarrage est le même maie l'EUID n'est pas réinitialisé.

Note du traducteur: Sous Linux, le paragraphe précédent est inutile car pour des raisons de sécurités, le noyau ignore les bits Set-User-Id et Set-Group-Id. Donc l'EUID sera toujours égal à l'UID, de même pour le GID et l'EGID.

Définitions

blanc

Un espace ou une tabulation.

mot

une séquence de caractères considerée comme une unité élémentaire par le shell. On parle également de token (jeton).

nom

un mot ne contenant que des caractères alpha-numériques, ou le caractère de soulignement (underscore), commençant par une lettre ou un soulignement. On s'y refère également sous le terme identificateur.

méta-caractère

Un caractère qui, lorsqu'il n'est pas protégé, sépare les mots. Un de ceux-ci :

| & ; ( ) < > espace tabulation

opérateur de contrôle

Un token ayant une fonction de contrôle. L'un des symboles suivants :

|| & && ; ;; ( ) | <retour-chariot>

Mots Réservés

! case do done elif else esac fi for function if in select then until while { } time [[ ]]

Grammaire Du Shell

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 controle. Le premier mot indique la commande à exécuter. 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.

Tubes (Pipelines)

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

[ ! ] commande_1 [ | commande_2 ... ]

La sortie standard de la commande_1 est connectée à 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).

Si le mot réservé ! précède un tube, la valeur de sortie de celui-ci sera la NéGATION logique de la valeur de retour de la dernière commande. Sinon, le code de retour d'un tube sera celui de la dernière commande. L'interpréteur attend la fin de toutes les commandes du tube avant de renvoyer une valeur.

Si le mot réservé time précède le tube, les temps écoulés, consommés par le programme et par le système pour le programme sont indiqués quand le tube se termine. L'option -p change 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 doivent être affichées; consultez la descriptions de TIMEFORMAT dans Variables du Shell.

Chaque commande du tube 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 tubes séparés par l'un des opérateurs ;, &, &&, ou ||, et terminée par ;, &, ou <retour-chariot>.

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

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

commande_1 && commande_2

commande_2 est exécutée si, et seulement si, commande_1 renvoie un code de retour nul.

Une liste OU a la forme

commande_1 || commande_2

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. 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. Cette construction est connue sous le nom de commandes groupées. Le code de retour est celui de la liste. liste doit obligatoirement se terminer par un caractère fin-de-ligne ou un point-virgule.

L'expression est évaluaée selon les règles décrites dans

éVALUATION ARITHMéTIQUES. Si la valeur de l'expression n'est pas zéro, la valeur renvoyée est zéro; sinon 1 est renvoyé. Cela est strictement identique à "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 CONDITIONELLES. Le coupage des mots et l'expansion des chemins ne sont pas réalisés sur les mots 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.

Quand les opérateurs == et != sont utilisés, la chaîne placée à la droite de l'opérateur est considéré comme étant un motif et est recherché selon les règles décrites dans Motifs Matching. La valeur renvoyée est 0 si la recherche est fructueuse 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).

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

( expression )

Retourne la value de expression. Cela peut être utilisé pour outrepasser la priorité normale des opérateurs.

! expression

Vraie si expression est vraie.

expression1 && expression2

Vraie si expression1 et expression2 sont toutes les deux vraies.

expression1 || expression2

Vraie si expression1 ou expression2 est vraie.

Les opérateurs && et || n'exécutent pas expression2 si la valeur de expression1 est suffisante pour déterminer le code de retour de l'expression conditionnelle entière.

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 sucessivement 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 est lue (EOF), la commande se termine. Pour toutes les autres valeurs, la variable nom est nulle. 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 ou return 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 ]

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 de correspondance que pour les expansions de noms de fichiers (voir le paragraphe Développement des noms de fichiers plus bas). 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 de correspondance. Le code de retour est zéro si aucun motif ne correspond, sinon il s'agit du code de la liste exécutée.

if liste then liste

[ elif liste then liste ] ... else liste ] fi La liste suivant le if est exécutée. Si son code de retour est nul, la liste suivant le 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 suivant le do tant que la dernière commande de la liste suivant le 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.

[ function ] nom () { liste; }

Ceci définit une fonction possédant le nom mentionné. Le corps de cette fonction est la liste de commandes entre { et }. Cette liste est exécutée dès que le nom de la fonction est invoqué en tant que commande simple. 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)

Commentaires

Protection

Tous les méta-caractères mentionnés dans le paragraphe DéFINITIONS ci-dessus ont des significations spéciales pour le shell, et doivent être protégés pour garder leur propre valeur. Il y a trois mécanismes de protection : Le caractère d'échappement, les apostrophes (quote) et les guillemets (double-quote).

Un caractère backslash (\), quand il n'est pas protégé, représente le caractère d'échapement. Il préserve la valeur littérale du caractère qui le suit, à l'exception du <retour-chariot>. Si une séquence \<retour-chariot> apparaît, et si le backslash n'est pas protégé, l'ensemble \<retour-chariot> est considéré comme une continuation de ligne (autrement dit, il est ignoré).

Encadrer des caractères entre des apostrophes simples préserve la valeur littérale de chacun des caractères. Une apostrophe ne peut pas être placée entre deux apostrophes, même si elle est précédée d'un backslash.

Encadrer des caractères entre des guillemets préserve la valeur littérale de chacun des caractères sauf $, `, et \. Les caractères $ et ` conservent leurs significations spéciales, même entre guillemets. Le backslash ne conserve sa signification que lorsqu'il est suivi par $, `, ", \, ou <fin-de-ligne>. Un guillemet peut être protégé entre deux guillemets, à condition de le faire précéder par un backslash.

Les caractères spéciaux * et @ ont des significations spéciales lorsqu'ils se trouvent entre guillemets (voir le paragraphe PARAMÈTRES ci-dessous).

Les mots de la forme $'chaîne' sont traités différemment. Le mot est développé en chaîne avec les séquences d'échappement remplacées par les séquences standards du C ANSI:

\a

alerte (cloche alias bip)

\b

effacement arrière

\e

un caractère escape

\f

fin de page

\n

fin de ligne

\r

retour chariot

\t

tabulation horizontale

\v

tabulation verticale

\\

anti-slash

\nnn

le caractère dont le code ASCII en octal est nnn (un à trois chiffres)

\xnnn

le caractère dont le code ASCII en hexadécimal est nnn (un à trois chiffres)

Le résultat après traduction est protégé par des apostrophes comme si le symbole dollar n'avait pas été présent.

Une chaîne entre guillemets précédée d'un symbole dollar ($) sera traduite selon les locales en vigueur. Si la locale courante est C [Ndt: valeur par défaut] ou POSIX, le symbole dollar est ignoré. Si la chaîne a subi une traduction ou des remplacements, le résultat est protégé par des guillemets.

ParamÈtres

Un paramètre existe dès qu'on lui attribue une valeur. Une chaîne vide est une valeur valide. Une fois qu'une variable existe, elle ne peut être détruite qu'en utilisant la commande interne unset (voir COMMANDES INTERNES DU SHELL plus bas).

Une variable peut recevoir une valeur par une affectation de la forme

nom=[valeur]

Si aucune valeur n'est indiquée, la variable reçoit une chaîne vide. Toute valeur est soumise aux principes de développement du tilde, des paramètres et des variables, de la substitution de commandes, de l'évaluation arithmétique, et de la suppression des protections. Si une variable a son attribut -i activé (voir declare plus bas, dans le paragraphe COMMANDES INTERNES DU SHELL) alors la valeur est soumise à l'évaluation arithmétique, même si la syntaxe $[...] n'apparaît pas. Les mots ne sont pas tronqués, sauf avec la séquence "$@" comme cela est expliqué dans le paragraphe Paramètres Spéciaux ci-dessous. Le développement des noms de fichiers n'est pas effectué.

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'assignation 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 le paragraphe EXPANSION plus bas).

Paramètres Spéciaux

Il existe plusieurs paramètres de l'interpréteur 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, en commençant par 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ées 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 nulle ou inexistante, les paramètres sont séparés par des espaces.

@

Se développe en l'ensemble des paramètres positionnels, en commençant par 1. Quand le développement se produit entre des guillemets, chaque paramètre se transforme en un mot distinct. Ceci signifie que `` $@'' est équivalent à ``$1'' ``$2'' ... Quand il n'y a pas de paramètres positionnels, ``$@'' et $@ sont simplement éliminés.

#

Se développe pour fournir le nombre de paramètres positionnels, en base décimale.

?

Fournit le code de retour du tube exécuté en arrière-plan le plus récemment.

-

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 le drapeau -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.

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 absolu du shell ou du script en cours d'exécution passé sur la ligne de commande. 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 assignées par l'interpréteur de commandes :

PPID

L'ID du processus parent du shell. Cette variables est protégée en écriture.

PWD

Le répertoire de travail en cours, tel qu'il est configuré par la commande cd.

OLDPWD

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

REPLY

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

UID

Contient l'U-ID de l'utilisateur, initialisé au démarrage du shell.

EUID

Contient l'UID effectif de l'utilisateur, initialisé au démarrage du shell [Ndt: sous Linux, il ne devrait jamais être différent de l'UID car le Set-User-Bit est inactif sur les scripts et inutile voire dangereux sur un shell (i.e: imaginer une redirection sur /etc/passwd) ]

GROUPS

Variable de type tableau contenant la liste des groupes dont l'utilisateur courant est membre. Cette variables est protégée en écriture.

BASH

Se développe en chemin d'accès complet utilisé pour invoquer l'instance de bash en cours d'exécution.

BASH_VERSION

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

BASH_VERSINFO

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

BASH_VERSINFO[0]

Le nombre majeur de la version (release).

BASH_VERSINFO[1]

Le nombre mineur de la version (version).

BASH_VERSINFO[2]

Le niveau de patch.

BASH_VERSINFO[3]

Le numéro de compilation.

BASH_VERSINFO[4]

Le statut de cette version (e.g., beta1).

SHLVL

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

RANDOM

A chaque fois que ce paramètre est référencé, un entier aléatoire est engendré. Cette séquence de nombres aléatoires peut être initialisée en assignant une valeur à RANDOM. Si RANDOM est détruit (commande unset), il perd son comportement spécial, même s'il est recréé plus tard.

SECONDS

A chaque fois que ce paramètre est lu, le nombre de secondes écoulées depuis le lancement de l'interpréteur est renvoyé. Si une valeur est affectée à SECONDS, il renverra lors des lectures ultérieures le nombre de secondes écoulées depuis l'assignation, augmenté de la valeur fournie. Si SECONDS est détruit (commande unset), il perd son comportement spécial, même s'il est recréé plus tard.

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. Quand on n'est ni dans un script, ni dans une fonction, la valeur renvoyée n'a pas nécéssairement de sens. Dans une fonction, la valeur n'est pas le numéro de ligne dans le fichier source (cette valeur a déjà été perdue lorsque la fonction est exécutée), mais une approximation du nombre de commandes simples exécutées dans le corps de cette fonction. Si LINENO est détruit (commande unset), il perd son comportement spécial, même s'il est recréé plus tard.

HISTCMD

Le numéro d'historique, ou le rang dans la liste d'historique, de la commande en cours. Si HISTCMD est détruit (commande unset), il perd son comportement spécial, même s'il est recréé plus tard.

DIRSTACK

Une variable-tableau (voir Arrays) représentant le contenu courant de la pile de répertoire. 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 variables 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 n'est pas assignée, elle perd ses propriétés spéciales, même si elle est recréée.

PIPESTATUS

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

OPTARG

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

OPTIND

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

HOSTNAME

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

HOSTTYPE

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

OSTYPE

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

MACHTYPE

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

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 set -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 protégée en écriture.

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.

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 decouper les lignes en mots avec la commande interne read. La valeur par défaut est ``<espace><tabulation><retour-chariot>''.

PATH

Le chemin de recherche des commandes à exécuter. Il s'agit d'une liste de répertoires, séparés par des doubles-points (`:') que l'interpréteur consulte lorsqu'il recherche une commande (voir le paragraphe éXé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:/usr/gnu/bin:.''.

HOME

Le répertoire personnel de l'utilisateur. C'est l'argument par défaut de la commande interne cd.

CDPATH

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

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, à la substitution de commandes, et à l'évaluation arithmétique avant d'être interprétée comme un nom de fichier. Le chemin d'acccès PATH n'est pas utilisé pour rechercher le fichier obtenu.

MAIL

Si ce paramètre correspond à un nom de fichier, et si la variable MAILPATH n'est pas configurée, bash informera l'utilisateur si un courrier arrive dans le fichier indiqué.

MAILCHECK

Indique une fréquence (en secondes) à laquelle bash vérifiera si un nouveau courrier est arrivé. La valeur par défaut est 60 secondes. Lorsque le délai est ecoulé, le shell vérifiera la présence d'un courrier avant d'afficher son symbole d'accueil. Si cette variable est détruite (unset), le shell cessera de vérifier le courrier.

MAILPATH

Il s'agit d'une liste de fichiers séparés par des doubles-points (`:'), dans lesquels on verifiera 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:

MAILPATH='/usr/spool/mail/bfox?"Tu as du courrier":~/shell-mail?"$_ a du courrier"'

Bash fournit une valeur par defaut pour cette variable, mais l'emplacement du fichier boîte à lettres depend du système (par exemple /usr/spool/mail/$USER).

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 ``bash\$ ''.

PS2

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

PS3

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

PS4

La valeur de ce paramètre est développée 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écéssaire pour indiquer le niveau d'imbrication. La valeur par défaut est ``+ ''.

TIMEFORMAT

La valeur de ce paramètre est utilisée en tant que chaîne de format pour afficher le temps consommé dans les tubes 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.

%%

Un % seul (non interprété).

%[p][l]R

Le temps écoulé en secondes.

%[p][l]U

Le temps processeur écoulé en mode utilisateur en secondes.

%[p][l]S

Le temps processeur écoulé en mode système en secondes.

%P

Le pourcentage de temps processeur utilisé calculé avec (%U + %S) / %R.

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\nsyst%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.

HISTSIZE

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

HISTFILE

Le nom du fichier d'historique pour la mémorisation des commandes(voir le paragraphe HISTORIQUE plus bas). Par défaut, il s'agit de ~/.bash_history. Si cette variable est détruite (commande unset), l'historique n'est pas enregistré lors de la fin d'un shell interactif.

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, pour ne contenir que ce nombre de lignes. La valeur par défaut est 500. Ce fichier est tronqué quand un shell interactif existe.

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é avec la valeur 1 à chaque invocation du shell, ou au lancement d'un script.

LANG

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

LC_ALL

Cette variable surcharge LANG et toute autre variable LC_.

LC_COLLATE

Cette variable détermine l'ordre lors du tri des chemins ainsi que le comportement des expressions des intervalles, des classes d'équivalences, et de la comparaison de chaînes lors de la recherche de motifs et le développement des chemins.

LC_CTYPE

Cette variable détermine l'interprétation des caractères et le comportement des classes de caractères [Ndt: 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 $.

PROMPT_COMMAND

Lorsque cette variable contient une valeur, celle-ci est exécutée en tant que commande, avant l'affichage de chacun des symboles d'accueil principaux.

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 d' EOF consécutifs apparaissant comme caractère initial d'une ligne, que bash ignore 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, bash accepte par defaut 10 EOF consécutifs avant de se terminer. Si elle n'existe pas, EOF est considéré comme un terminateur de saisie pour le shell. Seuls les shells interactifs sont concernés.

TMOUT

Si cette variable contient une valeur supérieure a zéro, celle-ci est considérée comme un delai en secondes, à partir de l'affichage du symbole d'accueil principal. Lorsque ce délai sera écoulé, Bash se terminera si aucune saisie n'a eu lieu.

FCEDIT

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

FIGNORE

Une liste de suffixes, séparés par des doubles-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 exclus de la liste des fichiers. Par exemple, cette variable peut prendre la valeur ``.o:~''.

GLOBIGNORE

Une liste de motifs séparés par des double-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.

INPUTRC

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

notify

Si cette variable existe, bash affichera un rapport dès qu'un travail en arrière-plan se termine. Sinon, il attendra d'avoir à presenter un symbole d'accueil principal pour afficher son rapport (voir également l'option -b de la commande interne set).

history_control

HISTCONTROL

Si cette variable 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 la variable est détruite (commande unset), 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.

command_oriented_history

Lorsque cette variable existe, bash essaye de sauver en une seule entrée d'historique toutes les lignes d'une même commande. Ceci facilite la ré-édition des commandes s'étendant sur plusieurs lignes.

glob_dot_filenames

Lorsque cette variable est positionnée, bash inclut les fichiers dont le nom commence par un `.' lors du développement des paramètres.

allow_null_glob_expansion

Si cette variable existe, bash développe les motifs des noms de fichiers n'ayant aucune correspondance en une chaîne nulle, plutot que de conserver leur propre valeur (voir le paragraphe Développement des noms de fichiers plus bas).

histchars

Cette variable contient deux ou trois caractères contrôlant le développement de l'historique, et le découpage en token (voir le paragraphe EXPANSION 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 subsitution rapide, utilise 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. Par contre, il ne s'agit pas obligatoirement du caractère indiquant un commentaire pour l'interpréteur.

nolinks

Si cette variable existe, le shell ne suit pas les liens symboliques lorsqu'il exécute une commande modifiant le répertoire de travail. Il utilise la structure physique des répertoires à la place. Par défaut, bash suit la chaîne logique des répertoires lorsqu'il exécute des commandes modifiant le répertoire en cours, comme cd. Voir aussi la description de l'option -P de la commande interne set ( COMMANDES INTERNES DU SHELL plus bas).

hostname_completion_file

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 prochaîne tentative pour compléter un nom d'hôte, bash ajoutera le nouveau fichier à sa base de données déjà existantes.

noclobber

Si cette variable existe, bash n'écrasera pas un fichier existant avec les opérateurs de redirection >, >&, et <>. Cette variable peut être contournée lorsqu'on crée un fichier de sortie en utilisant l'opérateur >| à la place de > (voir également l'option -C de la commande interne set).

auto_resume

Cette variable configure le comportement du shell interactif vis à vis de l'utilisateur et du contrôle de jobs. Si cette variable existe, les commandes simples constituées d'un seul mot 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 le job manipulé le plus récemment. Le nom du job arrêté 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'un job arrêté. 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 au job id %? (voir CONTRÔLE DES JOBS 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 %.

no_exit_on_failed_exec

Si cette variable existe, un shell non-interactif ne se terminera pas immédiatement si il ne peut pas exécuter un fichier avec la commande interne exec. Un shell interactif ne se termine pas si un exec échoue.

cdable_vars

Si cette variable existe, un argument de la commande interne cd qui ne soit pas un répertoire, est supposé être un nom de variable dont le contenu indique le répertoire destination désiré.

Expansion

L'ordre est : expansion des accolades, du tilde, des paramètres, des variables, des commandes, évaluation arithmétique (selon la méthode gauche-à-droite), découpage des mots et développement des noms de fichiers.

Sur les systèmes qui le suppportent, un développement supplémentaire a lieu : la substitution de processus.

Seuls l'expansion des accolades, le découpage des mots, et le développement des noms de fichiers peuvent modifier le nombre de mots. Les autres développement transforment un mot unique en un autre mot unique. La seule exception à cette règle est l'expansion de ``$@'' comme on l'a vu plus haut (voir le paragraphe PARAMÈTRES).

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 d'une série de chaînes séparées par des virgules, 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 uns dans les autres. Les chaînes résultant de chaque développement ne sont pas triées, l'ordre gauche à droite est conservé. Par exemple a{d,c,b}e se développe en `ade ace abe'.

L'expansion des accolades est effectuée avant tout autre type de développement, 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. Toute formule incorrecte n'est pas développée et reste inchangée.

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

mkdir /usr/local/src/bash/{old,new,dist,bugs}

chown root /usr/{ucb/{ex,edit},lib/{ex?.?*,how_ex}}

Le développement des accolades induit une légère incompatibilité avec les versions traditionnelles de sh, l'interpréteur Bourne. sh n'effectue aucun traitement sur les accolades ouvrantes et fermantes lorsqu'elles apparaissent dans un mot, et les laisse inchangées. Bash suppprime 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 tranformé en file1 file2 par bash. Si une compatibilité stricte avec sh est nécessaire, lancez bash avec l'attribut -nobraceexpansion (voir OPTIONS plus haut) ou désactivez le développement des accolades avec l'option +o braceexpand 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 (voire tous les caractères s'il n'y a pas de slash), sont considéré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 un `+' suit le tilde, ils seront remplacés par la valeur du paramètre PWD. Si un `-' suit, ils seront remplacés par la valeur de OLDPWD. Si la valeur suivant le tilde est un nom de login valide, le tilde, ainsi que ce nom seront remplacés par le répertoire personnel associé à ce nom. 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 le : ou le =. 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.

${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 chifres, ou si le paramètre est suivi de caractères n'appartenant pas à son nom.

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}

Est remplacé par la longueur, en caractères, de la valeur du paramètre. Si le paramètre est * ou @, la longueur fournie est celle du paramètre * développé entre guillemets.

${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 debut 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 ``##'').

${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 ``%%'').

Substitution de commandes

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

$(commande)

`commande`

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.

Quand l'ancienne forme de substitution -avec les backquotes `- est utilisée, le caractère backslash garde sa signification littérale, sauf s'il est suivi de $, `, ou \. Quand on utilise la forme $(commande), tous les caractères entre parenthèses gardent leurs valeurs littérales. Aucun n'est traité spécifiquement.

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

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. Il existe deux formats d'évaluation arithmétique :

$[expression]

$((expression))

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 crochets ou 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 évaluations arithmétiques peuvent être imbriquées.

L'évaluation est effectuée en suivant les règles mentionnées dans le paragraphe CALCUL ARITHMéTIQUE (plus bas). 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 ouverts. Elle prend la forme <(liste) ou >(liste). La liste de processus est exécutée avec ses entrées et sorties connectées à 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 l'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. 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. IFS ne peut pas être détruit.

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.

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

Développement des noms de fichiers

Apres 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 la variable allow_null_glob_expansion n'existe pas, le mot reste inchangé. Si la variable existe, et si aucune correspondance n'est trouvée, le mot est éliminé. 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 la variable shell glob_dot_filenames n'existe. Dans tous les autres cas, le caractère ``.'' n'est pas traité spécifiquement. Le caractère slash doit toujours être mis en correspondance explicitement.

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 signe "moins" indique un intervalle; qui correspond à n'importe quel caractère situé entre les deux bornes incluses. Si le premier caractère suivant le [ est un ! ou un ^ alors la correspondance se fait sur les caractères non-inclus. Un - ou un ] peuvent être mis en correspondance en les incluant en premier ou dernier caractère de l'ensemble.

Suppression des protections

Après les développements précédents, toutes les occurences non-protégées des caractères \, `, et " sont supprimées.

Redirection

Dans les descriptions suivantes, si le numéro de descripteur de fichier est omis, et si le premier caractère de l'opérateur de redirection est <, celui-ci correspondra à l'entrée standard (descripteur de fichier 0). Si le premier caractère de l'opérateur est >, la redirection s'appliquera à la sortie standard (descripteur de fichier 1).

Le mot qui suit l'operateur de redirection dans les descriptions suivantes est soumis à l'expansion des accolades, du tilde, des paramètres, à la substitution de commandes, à l'évaluation arithmétique, à la suppression des protections, et au développement des noms de fichiers. S'il se modifie pour donner plusieurs mots, bash détectera une erreur.

Remarquez que l'ordre des redirections est important. Par exemple, la commande

ls > liste_répertoires 2>&1

redirige a la fois la sortie standard et la sortie d'erreur vers le fichier liste_répertoires, alors que la commande

ls 2>&1 > liste_répertoires

ne redirige que la sortie standard vers le fichier liste_répertoires, car la sortie d'erreur a été renvoyée vers la sortie standard avant que celle-ci ne soit redirigée vers liste_répertoires.

Redirection d'entrée

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

[n]<mot

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

Redirection de sortie

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

[n]>mot

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.

Si l'opérateur de redirection est >|, alors la valeur de l'option -C de la commande interne set est ignorée, et une tentative de création de fichier a lieu. (Voir la description de noclobber dans le paragraphe Variables du Shell plus haut).

Redirection pour Ajout en Sortie

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

[n]>>mot

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

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.

Il y a deux formes pour effectuer cette double redirection :

&>mot

>&mot

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

>mot 2>&1

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'acces, 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 l'étiquette. Ceci permet d'indenter de manière naturelle les documents en ligne au sein des scripts.

Dédoublement de descripteur de fichier

L'opérateur de redirection

[n]<&mot

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

[n]>&mot

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). 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édement.

Ouverture en Lecture/écriture d'un descripteur de fichier

L'opérateur de redirection

[n]<>mot

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

Fonctions

La variables locales d'une fonction peuvent être déclarées en utilisant la commande interne local. Autrement, les variables et leurs valeurs sont partagées entre la fonction et son appelant.

Si la commande interne return est exécutée dans une fonction, celle-ci se termine et l'exécution reprend avec la commande suivant l'appel de fonction. Quand une fonction se termine, les paramètres positionnels et le paramètre spécial # reprennent les valeurs qu'ils avaient avant l'appel de fonction.

Les noms des fonctions et leurs définitions peuvent être affichés en utilisant l'option -f des commandes internes declare ou typeset. Les fonctions peuvent être exportées avec l'option -f de la commande interne export, afin de rester définies dans les sous-shells.

Les fonctions peuvent être récursives. Aucune limite n'est imposée quant au nombre d'appels récursifs.

Alias

Les alias sont créés et affichés avec la commande alias, et supprimés avec la commande unalias.

Il n'existe pas de mécanisme permettant d'utiliser des arguments dans le texte de remplacement, contrairement à l'interpreteur csh. Si l'on a besoin de traiter des arguments, il faut utiliser une fonction du shell.

Les alias ne sont développés qu'avec les shells interactifs.

Les règles concernant la définition et l'utilisation des alias sont un peu confuses. Bash lit toujours au moins une ligne d'entrée complètement avant d'exécuter une commande de cette ligne. Les alias sont traités lorsque la commande est lue, et non pas lorsqu'elle est exécutée. Ainsi, une définition d'alias apparaissant sur la même ligne qu'une autre commande ne prend pas effet avant la lecture de la prochaine ligne d'entrée. Autrement dit, une commande placée à la suite d'une définition d'alias, sur la même ligne ne sera pas affectée par cet alias. Ce comportement est également important lors de l'exécution des fonctions. Les alias sont traités lorsque la définition de la fonction est lue, et non pas lors de l'exécution de cette fonction. Ainsi des alias définis dans une fonction ne sont pas actifs avant la fin de l'exécution de la fonction. Pour plus de tranquilité, placez toujours les définitions d'alias sur des lignes isolées, et n'utilisez jamais la commande alias dans les commandes composées.

Notez enfin que la plupart du temps les alias sont avantageusement remplacés par des fonctions du shell.

ContrÔle Des Jobs

L'interpréteur associe un job à chaque tube. Il maintient une table des jobs en cours d'exécution, cette table pouvant être affichée avec la commande jobs. Quand bash lance un job de manière asynchrone (en arrière-plan), il affiche une ligne du genre :

[1] 25647

Cette ligne indique que le job est associé au numéro 1, et que le PID du dernier processus dans le tube est 25647. Tous les processus dans un tube simple font partie du même job. Bash utilise la notion de job comme une abstraction pour aider à les contrôler.

Pour faciliter l'implémentation d'une interface utilisateur pour le contrôle de job, le système introduit la notion d'ID de groupe de processus associés à un terminal. Les membre de ce groupe de processus (ceux dont le GID est égal au Process Group ID du terminal) recoivent les signaux déclenchés par le clavier, comme SIGINT. Ces processus sont dits en avant-plan. Les processus en arrière-plan sont ceux dont le Process-GID differe de celui du terminal, ceux qui ne reçoivent pas les signaux déclenchés par le clavier. Seuls les processus en avant-plan peuvent lire depuis le terminal ou écrire dessus. Les processus en arrière-plan qui tentent une lecture sur le terminal (ou une écriture dessus), reçoivent les signaux SIGTTIN (SIGTTOU) émis par le pilote de péripherique du terminal, lesquels signaux suspendent l'exécution du processus (sauf interception du signal).

Si le système d'exploitation sur lequel bash fonctionne permet le contrôle des jobs, bash vous y donne accès. La frappe d'un caractère suspension (généralement ^Z, Contrôle-Z) pendant l'exécution d'un processus arrête celui-ci, et redonne la main à bash. La frappe d'un caractère suspension différée (généralement ^Y, Contrôle-Y) arrêtera le processus au moment où il tentera de lire depuis le terminal, et la main reviendra à bash. Il est possible de manipuler ces jobs en utilisant la commande bg (background = arrière-plan) pour continuer l'exécution en arrière-plan, fg (foreground) pour la reprendre en avant-plan, ou encore la commande kill pour tuer le processus. Un ^Z prend effet immédiatement, et élimine les sorties en attente.

Il y a plusieurs manières de faire référence à un job. Le caractère % introduit un nom de job. Le job numéro n peut être noté %n. On peut également faire référence à un job en utilisant un préfixe du nom utilise pour le lancer, ou une partie de la ligne de commande. Par exemple, %ce se réfère à un job arrêté nomme ce. Si ce préfixe correspond à plusieurs jobs, bash renverra une erreur. D'autre part, %?ce, fait référence à n'importe quel job contenant la chaîne ce dans sa ligne de commande. Si la sous-chaîne correspond à plusieurs jobs, bash renverra une erreur. Les symboles %% et %+ référencent le job courant du shell, c'est à dire le dernier job arrêté alors qu'il se trouvait en avant-plan. Le job précédent peut être mentionné en utilisant %-. Dans les affichages se rapportant aux jobs (par exemple ceux de la commande jobs le job courant est toujours indiqué par un +, et le job précédent avec un -.

Il suffit de nommer un job pour le ramener en avant-plan : %1 est synonyme de ``fg %1'', et ramène le job 1 depuis l'arrière-plan vers l'avant-plan. De même, ``%1 &'' relance le job 1, mais en arrière-plan cette fois, de manière équivalente à ``bg %1''.

Le shell est immédiatement prévenu lorsqu'un job change d'état. Normalement bash attend d'être prêt à afficher son symbole d'accueil avant de fournir un rapport sur les changements dans les statut des jobs, afin de ne pas perturber les autres affichages. Avec l'option -b de la commande interne set, bash affichera les modifications immédiatement (Voir aussi la description de la variable notify dans le paragraphe Variables du Shell plus haut.)

Si vous essayez de quitter bash alors que des jobs sont suspendus, le shell affichera un message d'avertissement. Vous pouvez alors utiliser la commande jobs pour vérifier leurs états. Une fois cette commande invoquée, ou si vous essayez à nouveau de quitter le shell immédiatement, il n'y aura plus d'avertissement, et les jobs suspendus seront définitivement terminés.

Signaux

Les jobs synchrones lancés par bash reçoivent les valeurs des signaux héritées par le shell de leur parent. Quand le contrôle de job n'est pas actif, les jobs en arrière-plan (démarrés avec &) ignorent les signaux SIGINT et SIGQUIT. Les commandes exécutées en tant que résultat de la substitution de commandes ignorent les signaux de contrôle de jobs émis par le clavier SIGTTIN, SIGTTOU, et SIGTSTP.

éxécution Des Commandes

Si le nom de la commande ne contient pas de slash, le shell tente de la trouver. S'il existe une fonction shell de ce nom, elle est appelée comme nous l'avons vu dans le paragraphe FONCTIONS plus-haut. Si le nom n'est pas celui d'une fonction, l'interpréteur le recherche dans la liste des fonctions internes. Si une équivalence est trouvée, la fonction interne est invoquée.

Si le nom n'est ni celui d'une fonction shell, ni celui d'une commande interne, et s'il ne contient pas de slash, bash va chercher dans chacun des membres de PATH un répertoire contenant un fichier exécutable du nom désiré. Si la recherche est infructueuse, l'interpréteur affiche un message d'erreur et renvoie un code de retour non nul.

Si la recherche réussit, ou si le nom de la commande contient au moins un slash, le shell exécute le programme voulu. L'argument 0 est rempli avec le nom fourni, et les autres arguments seront éventuellement remplis avec le reste de la ligne de commande.

Si l'exécution échoue parce que le programme n'est pas un exécutable, et si le fichier n'est pas un répertoire, on le considère alors comme un script shell, un fichier contenant une série de commandes. Un sous-shell est alors créé pour exécuter ce script. Ce sous-shell se réinitialisera lui-même, comme si un nouveau shell avait été invoqué pour exécuter le script, à la difference qu'il continuera à mémoriser l'emplacement des commandes connues de son parent (voir hash dans le paragraphe COMMANDES INTERNES DU SHELL plus bas).

Si le programme est un fichier commençant par #!, le reste de la première ligne indique un interpréteur pour ce programme. Le shell se chargera d'exécuter cet interpréteur, si le système d'exploitation ne gère pas lui-même ce format d'exécutable. Les arguments de l'interpréteur consistent en un premier argument éventuel fourni sur la première ligne du fichier à la suite du nom de l'interpréteur, suivi du nom du programme, suivi des arguments de la commande s'il y en a.

Environnement

Le shell permet de manipuler l'environnement de plusieurs façons. Au démarrage, le shell analyse son propre environnement, et crée un paramètre pour chaque nom trouvé, en le marquant comme exportable vers les processus fils. Les commandes exécutées héritent de cet environnement. Les commandes export et declare -x permettent d'ajouter ou de supprimer des paramètres ou des fonctions de l'environnement. Si la valeur d'un paramètre de l'environnement est modifiée, la nouvelle valeur devient une partie de l'environnement, et elle remplace l'ancienne. L'environnement hérité par les commandes exécutées est l'environnement initial du shell (dont les valeurs peuvent être modifiées), moins les éléments supprimés par la commande unset, plus les éléments ajoutés par les commandes export et declare -x.

L'environnement d'une commande simple ou d'une fonction peut être augmenté temporairement en la faisant précéder d'une affectation de paramètre, comme nous l'avons vu plus haut dans le paragraphe PARAMÈTRES. Ces affectations ne concernent que l'environnement vu par cette commande ou fonction.

Si l'option -k est utilisée (voir la commande interne set plus bas), alors toutes les affectations de paramètres sont placées dans l'environnement d'une commande exécutée, pas seulement celles qui précèdent son nom.

Quand bash invoque une commande externe, la variable _ contient le chemin d'accès complet à cette commande, et elle est transmise dans l'environnement.

Code De Retour

Si une commande n'est pas trouvée, le processus fils créé pour l'exécuter renvoie la valeur 127. Si la commande est trouvée mais pas exécutable, la valeur renvoyée est 126.

Bash lui-même renvoie le code de retour de la dernière commande exécutée, à moins qu'une erreur de syntaxe ne se produise, auquel cas il renvoie une valeur non-nulle. Voir également la commande interne exit plus bas.

Symbole D'accueil (prompt)

\t

l'heure actuelle au format HH:MM:SS

\d

la date au format "Jour_de_la_semaine Mois Quantième" (ex : "Tue May 26")

\n

retour-chariot

\s

le nom du shell, c'est à dire le nom de base de $0 (la portion suivant le dernier slash)

\w

le répertoire de travail en cours

\W

le nom de base du répertoire de travail en cours

\u

le nom de l'utilisateur

\h

le nom d'hôte de la machine

\#

le numéro de la commande

\!

le numéro d'historique de la commande

\$

# si l'UID effectif est 0, $ sinon

\nnn

le caractère de code octal nnn

\\

un backslash

\[

débute une série de caractères non-imprimables, qui permettent d'inclure des séquences de contrôle de terminal dans une chaîne d'accueil

\]

fin d'une série de caractères non-imprimables

Le numéro de commande, et le numéro d'historique sont généralement différents : le numéro d'historique d'une commande correspond à sa position dans la liste d'historique qui peut contenir des commandes relues depuis cette liste (voir le paragraphe HISTORIQUE plus bas), alors que le numéro de commande est simplement une position dans la séquence de commandes exécutées depuis le début de la session shell actuelle. Apres que la chaîne d'invite ait été décodée, elle est soumise à l'expansion des paramètres, substitution de commandes, évaluation arithmétique et découpage des mots.

BibliothÈque 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.

L'affectation par défaut des touches peut être modifiée dans le fichier ~/.inputrc. La valeur de la variable shell INPUTRC, si elle existe, est utilisée à la place du fichier ~/.inputrc. D'autres programmes qui utilisent cette bibliothèque peuvent ajouter leurs propres affectations de touches.

Par exemple, en plaçant

M-Control-u: universal-argument

C-Meta-u: universal-argument

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 aux touches des chaînes de caractères qui seront insérées lorsque la touche sera pressée (une macro).

Readline peut être personnalisé en ajoutant des commandes dans le fichier d'initialisation dont le nom est contenu dans la variable INPUTRC, ou, s'il elle n'existe pas, dans le fichier ~/.inputrc. Quand un programme qui utilise la bibliothèque readline démarre, le fichier d'initialisation est lu, et les affectations de touches et de variables sont effectuées. Il n'y a que peu de constructions autorisées dans le fichier d'initialisation. Les lignes blanches sont ignorées. Les lignes commençant par # sont considérées comme des commentaires, les lignes commençant par un $ indique une construction conditionnelle. Les autres lignes contiennent les affectations de touches et les assignations de variables.

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. Lorsque l'on utilise la forme touche:nom_de_fonction ou macro, touche est le nom de la séquence de touches épelée en Anglais. Par exemple :

Control-u: universal-argument
Meta-Rubout: backward-kill-word
Control-o: ">&sortie"

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ée, comme dans l'exemple suivant :

"\C-u": universal-argument
"\C-x\C-r": re-read-init-file
"\e[11~": "Touche Fonction 1"

Dans cet exemple, C-u est à nouveau assigné à 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 :

\C-

préfixe Contrôle

\M-

préfixe Méta

\e

caractère d'échappement

\\

backslash

\"

un guillemet littéral

\'

un apostrophe littéral

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. Le backslash 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).

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

set nom_de_variable valeur

Sauf contre-indication, les variables de readline prennent les valeurs On ou Off. Les variables, et leurs valeurs par défaut, sont :

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.

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.

mark-modified-lines (Off)

Si cette variable est configurée sur On, les lignes d'historique qui ont été modifiées seront précédées à l'affichage d'un astérisque (*).

bell-style (audible)

Cette variable permet de contrôler le comportement de readline lorsqu'il faut déclencher le signal sonore du terminal. Si cette variable contient la valeur none, readline n'utilise pas le signal sonore ; si elle contient visible, readline utilise un avertisseur visuel si c'est possible ; si elle contient audible, readline essaie d'utiliser le signal sonore du terminal.

comment-begin (``#'')

Cette chaîne est insérée dans le mode vi quand la commande vi-comment est exécutée.

meta-flag (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é.

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 suprimera 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).

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.

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.

keymap (emacs)

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

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.

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.

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

mode

La forme mode= de la structure $if permet de vérifier si readline est en mode emacs ou en mode vi. Ceci peut être utilisé conjointement à la commande set keymap, par exemple pour ne configurer les jeux de touches emacs-standard et emacs-ctlx que si readline démarre en mode emacs.

term

La forme term= peut être utilisée pour ajouter des affectations de touches spécifiques au terminal, par exemple sur des touches de fonction. Le mot à droite du signe = est comparé au nom complet du terminal, et à la portion de ce nom qui précède un éventuel signe -. Ceci permet, par exemple, de faire correspondre le mot sun aussi bien au terminal sun qu'au terminal sun-cmd.

application

La forme application permet d'inclure des configurations spécifiques à l'application. Chaque programme utilisant la bibliothèque readline configure un nom d'application, et un fichier d'initialisation peut dépendre de ce nom. Ceci est utile pour des affectations de touches intéressantes pour un programme spécifique. Par exemple, les commandes suivantes ajoutent une séquence de touches capable de protèger par des guillemets le mot courant ou le mot précédent, sous Bash :

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

$endif

Cette commande, comme vous l'avez deviné dans l'exemple ci-dessus, termine une commande $if.

$else

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

Les commandes de readline peuvent recevoir un argument numérique, généralement un nombre de répétitions. Parfois il arrive que le signe de cet argument soit significatif. En passant un argument négatif à une commande qui agit vers l'avant (par exemple kill-line), on inversera le sens d'action de cette commande. On détaillera les commandes dont les arguments ont un comportement particulier.

Quand une commande est décrite comme destructive (killing), le texte effacé est sauvegardé pour une éventuelle récupération ulterieure (yanking). Le texte est sauvegardé dans des tampons circulaires(kill-ring). Les destructions successives accumulent les textes dans le même tampon qui peut être récupéré en une seule fois. Les commandes qui ne détruisent pas de texte permettent de séparer les différents tampons.

Voici une liste des noms de commandes, ainsi que les séquences de touches auxquelles elles sont attribuées 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ééiques (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'ecran. 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 cette ligne est non vide, l'ajouter à la liste d'historique, en fonction de l'état 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.

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. Par défaut cette commande n'est affectée à aucune touche.

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.

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.

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 le paragraphe 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.

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

un synonyme de yank-last-arg.

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

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

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 C-d, 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 un buffer.

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)

Echanger les caractères se trouvant devant et sous le curseur. Le curseur est alors avancé d'un caractère. S'il se trouve à 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)

Echanger le mot où se trouve le curseur et le mot précédent, puis avancer le curseur après ce mot.

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.

Effacement et récuperation

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.

kill-whole-line

Effacer toute la ligne sans tenir compte de la position du curseur. Par défaut cette fonction n'est affectée à aucune touche.

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.

delete-horizontal-space

Effacer tous les espaces blancs et les tabulations autour du curseur. Par défaut cette commande n'est affectée à aucune touche.

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

Chaque fois que cette commande est exécutée, le compteur d'arguments est multiplié par 4. Ce compteur est initialement à 1, aussi en exécutant la fonction une fois il passera à 4. Par défaut cette commande n'est affectée à aucune touche.

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

Insérer l'ensemble des complétions du texte situé avant le curseur. Par défaut cette commande n'est affectée à aucune touche.

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-{)

Affiche la liste des complétions possibles en noms de fichiers pour le texte situé avant le curseur, en renvoyant la liste entre accolades, afin qu'elle soit utilisable par le shell (voir le paragraphe 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 derniere 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, ...)

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éparement.

revert-line (M-r)

Annuler toutes les modifications sur cette ligne. Ceci est équivalent à répéter commande 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.

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.

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

Afficher des informations sur la version de bash en cours d'exécution.

Historique

Expansion De L'historique

Le shell propose des possibilités d'expansion de l'historique qui sont semblables à celles de csh. Ce paragraphe décrit la syntaxe de ces commandes. Elles sont utilisables par défaut dans les shells interactifs, il est toutefois possible de les désactiver en utilisant l'option +H de la commande interne set (voir le paragraphe COMMANDES INTERNES DU SHELL plus bas). Les shells non-interactifs n'effectuent pas d'expansion d'historique.

Le développement de l'historique est fait immédiatement après la lecture d'une ligne complète, avant que le shell ne fasse la séparation des mots. Il se déroule en deux parties. La première consiste à déterminer la ligne de l'historique à utiliser pour les substitutions, la seconde permet de sélectionner les parties de la lignes à inclure dans la nouvelle ligne. La ligne sélectionnée dans l'historique est l'évènement, et les parties de cette ligne à réutiliser sont des mots. La ligne est découpée en mots de la même manière que lors d'une saisie, ainsi plusieurs mots séparés par des méta-caractères, et protégés par des guillemets sont considérés comme un unique mot. Seul le backslash (\) et les apostrophes permettent de protéger le caractère d'échappement de l'historique, par défaut !.

Le shell offre le contrôle des divers caractères utilisés par le mécanisme d'expansion de l'historique (voir la description de histchars plus haut dans le paragraphe Variables du Shell).

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, retour-chariot, = ou (.

!!

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

!n

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

!-n

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

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

d^uchaîne_1d^uchaîne_2d^u

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

!#

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

Indicateurs de mots

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

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 ayant été mis en correspondance lors de la dernière recherche `?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.

Modificateurs

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

h

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

r

Supprime un suffixe final de la forme .xxx<