bash-builtins

NOM

SYNOPSIS

COPYRIGHT

DESCRIPTION

OPTIONS

-c

Si l'option -c est présente, les commandes sont lues depuis le premier argument chaîne_de_commande qui n’est pas une option. Si des arguments suivent la chaîne_de_commande, le premier argument est assigné à $0 et tous les autres sont affectés aux paramètres positionnels. Le nom de l'interpréteur, utilisé pour les messages d'avertissement et d'erreur, est fixé par l'assignation à $0.

-i

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

-l

Faire que bash se comporte comme s'il avait été appelé comme interpréteur de commandes de connexion (consultez APPEL ci-dessous).

-r

Si l'option -r est présente, l'interpréteur devient restreint (consultez INTERPRÉTEUR RESTREINT ci-dessous).

-s

Si l'option -s est présente ou s'il ne reste plus d'argument après le traitement des options, alors les commandes sont lues depuis l'entrée standard. Cette option permet d'affecter les paramètres positionnels lors de l'appel d'un interpréteur interactif ou de la lecture de l'entrée à travers un tube.

-v

Afficher les lignes en entrée de l'interpréteur lorsqu'elles sont lues.

-x

Afficher les commandes et leurs arguments à mesure qu'elles sont exécutées.

-D

Une liste de toutes les chaînes entre guillemets doubles précédées de $ est affichée sur la sortie standard. Ce sont les chaînes qui sont soumises à une traduction quand le paramètre linguistique régional n'est ni C ni POSIX. Cela implique l'option -n ; aucune commande ne sera exécutée.

[-+]O [option_shopt]

option_shopt est une des options de l'interpréteur acceptées par la commande interne shopt (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Si option_shopt est présente, -O crée cette option ; +O la détruit. Si option_shopt n'est pas fournie, les noms et valeurs des options de l'interpréteur acceptées par shopt sont affichés sur la sortie standard. Si l'option d'appel est +O, la sortie est affichée dans un format réutilisable en entrée.

--

Deux caractères -- indiquent la fin des options et désactivent le traitement des arguments. Tous les arguments après le -- sont traités comme des noms de fichiers et paramètres. - est équivalent à --.

--debugger

Prend les dispositions pour que le paramétrage du traçage soit exécuté avant que l'interpréteur démarre. Enclenche le mode de traçage étendu (consultez ci-dessous la description de l'option extdebug de la commande interne shopt).

--dump-po-strings

Équivalent à -D, mais la sortie est dans le format des fichiers po (objets portables) de l'outil GNU gettext.

--dump-strings

Équivalent à -D.

--help

Affiche un message d'aide sur la sortie standard et termine avec succès.

--init-file fichier

--rcfile fichier

Exécuter les commandes contenues dans fichier plutôt que celles du fichier d'initialisation commun à tout le système /etc/bash.bashrc et que le fichier d'initialisation personnel standard ~/.bashrc si l'interpréteur est interactif (consultez APPEL ci-dessous).

--login

Équivalent à -l.

--noediting

Ne pas utiliser la bibliothèque GNU readline pour lire les lignes de commande, lorsque l'interpréteur est interactif.

--noprofile

Ne lire ni le fichier d'initialisation commun à tout le système /etc/profile ni les fichiers personnels d'initialisation ~/.bash_profile, ~/.bash_login ou ~/.profile. Par défaut, bash lit ces fichiers lorsqu'il est appelé comme interpréteur de commandes de connexion (consultez APPEL ci-dessous).

--norc

Ne pas lire ou exécuter le fichier de configuration commun à tout le système /etc/bash.bashrc, ni le fichier personnel d'initialisation ~/.bashrc lorsque l'interpréteur est interactif. Cette option est activée par défaut si l'interpréteur est appelé sous le nom sh.

--posix

Aligner le comportement de bash sur la norme (mode POSIX), en ce qui concerne les options dont l'action par défaut diffère de la norme POSIX. La section VOIR AUSSI ci-dessous référence un document précisant la façon dont le mode POSIX affecte le comportement de bash.

--restricted

L'interpréteur devient restreint (consultez INTERPRÉTEUR RESTREINT ci-dessous).

--verbose

Équivalent à -v.

--version

Affiche le numéro de version de bash sur la sortie standard et termine avec succès.

ARGUMENTS

APPEL

DÉFINITIONS

blanc

Une espace ou une tabulation.

mot

Une suite de caractères considérée comme une unité élémentaire par l'interpréteur. On parle également de lexème (« token »).

nom

Un mot ne contenant que des caractères alphanumériques et des tirets bas (« underscore »), commençant par une lettre ou un tiret bas. On s'y réfère également sous le terme identificateur.

métacaractère

Un caractère qui, non protégé, sépare les mots. Un de ceux-ci :

 

opérateur de contrôle

Un lexème ayant une fonction de contrôle. C'est l'un des symboles suivants :

MOTS RÉSERVÉS

GRAMMAIRE DE L'INTERPRÉTEUR

Commandes simples

Pipelines

Listes

Commandes composées

(liste)

liste est exécutée dans un sous-interpréteur (consultez ENVIRONNEMENT D'EXÉCUTION DES COMMANDES ci-dessous pour une description d'un environnement de sous-interpréteur). 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. L'état renvoyé est l'état final de la liste.

{ liste; }

liste est simplement exécutée avec l'environnement de l'interpréteur en cours. liste doit se terminer par un changement de ligne ou un point-virgule. Cette construction est connue sous le nom de commandes groupées. L'état renvoyé est l'état final de la liste. Remarquez que contrairement aux métacaractères ( et ), { et } sont des mots réservés qui ne doivent apparaître que là où un mot réservé peut être reconnu. Puisqu'ils ne conduiront pas à un découpage en mots, ils doivent être séparés de la liste par un blanc ou un autre métacaractère de l'interpréteur.

((expression))

L'expression est évaluée selon les règles décrites ci-dessous dans ÉVALUATION ARITHMÉTIQUE. Si la valeur arithmétique de l'expression est différente de zéro, l'état renvoyé est 0 ; sinon l'état renvoyé est 1. L'expression est sujette aux mêmes développements que si elle était entre guillemets doubles, mais les caractères guillemet double dans l' expression ne sont pas traités expressément et sont supprimés.

[[ expression ]]

Renvoie un état de 0 ou 1 selon l'évaluation de la condition expression. Les conditions sont composées de primitives décrites ci-dessous dans CONDITIONS. Les mots entre [[ et ]] ne sont sujets ni au découpage en mots ni au développement des chemins. L'interpréteur effectue le développement des tildes, des paramètres, des variables, le développement arithmétique, la substitution de commande et de processus, ainsi que la suppression des protections sur ces mots (les développements qui se produiraient si les mots étaient entre guillemets doubles). Les opérateurs conditionnels comme -f ne doivent pas être protégés afin d'être reconnus comme primitives. Lorsqu'ils sont utilisés avec [[, les opérateurs < et > ordonnent d'un point de vue lexicographique en utilisant les paramètres linguistiques régionaux actuels.

for nom [ [ in [ mot ... ] ] ; ] do liste ; done

La liste de mots suivant in est développée, produisant une liste d'éléments. La variable nom prend tour à tour 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 existants (consultez PARAMÈTRES ci-dessous). L'état renvoyé est l'état final de la dernière commande exécutée. Si le développement des éléments suivant in conduit à une liste vide, aucune commande n'est exécutée et l'état renvoyé est 0.

for (( expr1 ; expr2 ; expr3 )) ; do liste ; done

L'expression arithmétique expr1 est d'abord évaluée selon les règles décrites ci-dessous sous ÉVALUATION ARITHMÉTIQUE. L'expression arithmétique expr2 est ensuite évaluée répétitivement jusqu'à valoir zéro. Chaque fois que expr2 est évaluée en une valeur différente de zéro, liste est exécutée et l'expression arithmétique expr3 est évaluée. Si l'une des expressions est omise, elle est considérée comme s'évaluant à 1. La valeur renvoyée est l'état final de la dernière commande dans liste qui est exécutée ou faux si l'une des expressions est incorrecte.

select nom [ in mot ] ; do liste ; done

La liste de mots à la suite de in est développée, produisant une liste d'éléments et 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 (consultez PARAMÈTRES ci-dessous). select affiche alors l'invite PS3 et lit une ligne depuis l'entrée standard. Si la ligne est constituée d'un nombre correspondant à l'un des mots affichés, alors ce mot est affecté à la valeur de la variable nom. Si la ligne est vide, les mots et l'invite sont affichés à nouveau. Si une fin de fichier (EOF) est lue, la commande select se termine et renvoie 1. Toute autre valeur lue force la variable nom à être définie à NULL. La ligne lue est conservée dans la variable REPLY. La liste est exécutée après chaque sélection, jusqu'à ce qu'une commande break soit atteinte. L'état final de select est l'état final de la dernière commande exécutée dans la liste ou zéro si aucune commande n'a été exécutée.

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

Une commande case commence d'abord par développer le mot, puis essaye de le mettre en correspondance tour à tour avec chacun des motifs en utilisant les règles de mise en correspondance dans Motifs génériques ci-dessous. Le mot est développé en utilisant le développement du tilde, le développement des paramètres et des variables, le développement arithmétique, la substitution de commande, la substitution de processus et la suppression des protections. Chaque motif examiné est développé en utilisant le développement du tilde, le développement des paramètres et des variables, le développement arithmétique, la substitution de commande et la substitution de processus et la suppression des protections. Si l'option d'interpréteur nocasematch est activée, la mise en correspondance est effectuée sans tenir compte de la casse des caractères alphabétiques. 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 essai si l'opérateur ;; est utilisé. Si ;& est utilisé au lieu de ;;, l'exécution continue avec la liste associée au jeu de motifs suivant. Si ;;& est utilisé au lieu de ;;, l'interpréteur essaye la liste de motifs suivante, si elle existe, et exécute toute liste associée à un motif correspondant, poursuivant l'exécution de la déclaration de cas comme si la liste de motifs n'avait pas de correspondance. Le code de retour est zéro si aucun motif ne correspond. Sinon il est le code de retour de la dernière commande exécutée dans la liste.

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

La liste du if est exécutée. Si son état final est zéro, la liste du then est exécutée. Sinon, chacune des listes des elif est exécutée tour à tour et si son état final est zéro, la liste du then associé est exécutée et la commande se termine. Sinon, la liste du else, si présente, est exécutée. L'état final est l'état final de la dernière commande exécutée ou zéro si aucune condition n'a été satisfaite.

while liste-1; do liste-2; done

until liste-1; do liste-2; done

La commande while répète la liste liste-2 tant que la dernière commande de la liste liste-1 renvoie un état final de zéro. La commande until est identique à la commande while, sauf que le test est inversé : la liste-2 est exécutée tant que la dernière commande de la liste-1 renvoie un état final différent de zéro. L'état final des commandes while et until est l'état final de la dernière commande exécutée dans la liste-2 ou zéro si aucune commande n'a été exécutée.

Coprocessus

Définitions des fonctions de l'interpréteur

nomfonction () commande-composée [redirection]

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

Cela définit une fonction possédant le nomfonction mentionné. Le mot réservé function est facultatif. S'il est fourni, les parenthèses sont facultatives. Le corps de la fonction est la commande composée commande-composée (consultez Commandes composées ci-dessus). Cette commande est généralement une liste de commandes entre { et }, mais peut être n'importe quelle commande décrite dans Commandes composées ci-dessus. Si le mot réservé function est utilisé, mais que les parenthèses ne sont pas fournies, les accolades sont recommandées. La commande-composée est exécutée chaque fois que nomfonction est indiqué comme le nom d'une commande normale. En mode POSIX, nomfonction doit un nom valable d'interpréteur et ne peut pas être le nom d’une des commandes internes spéciales de POSIX («  special builtins »). En mode par défaut, un nom de fonction peut être n'importe quel mot de l'interpréteur non protégé qui ne contient pas de $. Toutes les redirections (consultez REDIRECTIONS ci-dessous) indiquées lorsqu'une fonction est définie sont effectuées lorsque la fonction est exécutée. Le code de retour d'une définition de fonction est zéro, à moins qu'une erreur de syntaxe ne se produise ou qu'une fonction en lecture seule n'existe déjà avec le même nom. Lorsque la fonction est exécutée, le code de retour est celui de la dernière commande exécutée dans le corps de la fonction (consultez FONCTIONS ci-dessous).

COMMENTAIRES

PROTECTIONS

PARAMÈTRES

Paramètres positionnels

Paramètres spéciaux

*

Se développe en l'ensemble des paramètres positionnels, commençant par le premier. Quand le développement n’est pas entre guillemets doubles, tous les paramètres positionnels se développent en mots séparés. Dans les contextes où il sont réalisés, ces mots sont soumis à d’autres découpages en mots et développements de chemin. Quand le développement se produit entre des guillemets doubles, * se transforme en un seul mot constitué de la valeur de tous les paramètres positionnels séparés par le premier caractère de la variable spéciale IFS. C'est-à-dire que "$*" est équivalent à "$1c$2c...", où c est le premier caractère de la valeur de la variable IFS. Si IFS est inexistante, les paramètres sont séparés par des espaces. Si IFS est NULL, les paramètres sont accolés sans séparateurs.

@

Se développe en ensemble des paramètres positionnels, commençant par le premier. Dans les contextes où le découpage en mots est réalisé, chaque paramètre positionnel se développe en un mot séparé ; si ces mots ne sont pas entre des guillemets doubles, ils sont sujets au découpage de mot. Dans les contextes où il n'y a pas de découpage en mots, chaque paramètre positionnel se développe en un mot distinct séparé par des espaces. Quand le développement a lieu entre guillemets doubles, chaque paramètre se développe en un mot distinct. C'est-à-dire que "$@" est équivalent à "$1" "$2" .... Si le développement des guillemets doubles survient dans un mot, le développement du premier paramètre est accolé à la première partie du mot d'origine et le développement du dernier paramètre est accolé à la dernière partie du mot d'origine. Quand il n'y a pas de paramètres positionnels, "$@" et $@ ne se développent en rien (c'est-à-dire qu'ils sont simplement éliminés).

#

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

?

Se développe en état final du dernier pipeline exécuté au premier plan.

-

Est remplacé par la liste des options de l'interpréteur indiquées durant l'appel, configurées avec la commande interne set ou celles créées par l'interpréteur lui-même (comme avec l'option -i).

$

Se transforme en PID de l'interpréteur. Dans un sous-interpréteur, il se transforme en PID de l'interpréteur et non pas du sous-interpréteur.

!

Se transforme en PID de la dernière tâche placée en arrière-plan, soit exécutée comme une commande asynchrone, soit en utilisant la commande interne bg (consultez CONTRÔLE DES TÂCHES ci-dessous).

0

Se développe en nom de l'interpréteur ou du script. Ce paramètre est créé lors de l'initialisation de l'interpréteur. Si bash est appelé 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 nom de fichier utilisé pour appeler bash, comme indiqué par l'argument zéro.

Variables de l'interpréteur

_

Au lancement de l'interpréteur, contient le chemin d'accès utilisé pour appeler l'interpréteur, ou le script en cours d'exécution tel qu'il est passé dans l'environnement ou dans la liste des arguments. Devient ensuite le dernier argument de la commande simple précédente exécutée au premier plan, après développement. Contient également le 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 consultation.

BASH

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

BASHOPTS

Liste des options activées de l'interpréteur, séparées par des deux-points « : ». Chaque mot de la liste est un argument correct pour l'option -s de la commande interne shopt (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les options apparaissant dans BASHOPTS sont celles indiquées comme actives par shopt. Si cette variable est dans l'environnement au lancement de bash, chaque option de la liste est activée avant de lire les fichiers d’initialisation. Cette variable est en lecture seule.

BASHPID

Se transforme en PID du processus de l'interpréteur bash actuel. Diffère de $$ sous certaines conditions, comme dans les sous-interpréteurs ne nécessitant pas que bash soit réinitialisé. Les assignations à BASHPID n'ont pas d”effet. Si BASHPID est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_ALIASES

Une variable de type tableau associatif dont les éléments correspondent à une liste interne d'alias comme celle gérée par la commande interne alias. Les éléments ajoutés à ce tableau apparaissent dans la liste d'alias ; cependant, la destruction d'éléments du tableau ne provoque pas actuellement le retrait des alias de la liste d'alias. Si BASH_ALIASES est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_ARGC

Une variable de type tableau contenant le nombre de paramètres de chaque trame de la pile d'appel d'exécution de l'interpréteur bash actuel. Le nombre de paramètres du sous-programme actuel (fonction de l'interpréteur ou du script exécuté par . ou source) est au sommet de la pile. Lorsqu'un sous-programme est exécuté, le nombre de paramètres passés est placé dans BASH_ARGC. L'interpréteur crée BASH_ARGC seulement dans le mode de traçage étendu (consultez ci-dessous la description de l'option extdebug de la commande interne shopt). La configuration de extdebug après que l'interpréteur ait démarré l'exécution d'un script, ou le référencement de cette variable quand extdebug n'existe pas, peut provoquer une incohérence des valeurs.

BASH_ARGV

Une variable de type tableau contenant tous les paramètres de la pile d'appel d'exécution de l'interpréteur bash actuel. Le dernier paramètre du dernier sous-programme est au sommet de la pile ; le premier paramètre de l'appel initial est en bas. Lorsqu'un sous-programme est exécuté, les paramètres fournis sont placés dans BASH_ARGV. BASH_ARGV est créé uniquement dans le mode de traçage étendu (consultez ci-dessous la description de l'option extdebug de la commande interne shopt). La configuration de extdebug après que l'interpréteur ait démarré l'exécution d'un script, ou le référencement de cette variable quand extdebug n'existe pas peut provoquer une incohérence des valeurs.

BASH_ARGV0

Quand elle est référencée, cette variable développe le nom de l'interpréteur ou du script de l'interpréteur (identique à $0 ; voir la description du paramètre spécial 0 ci-dessus). L'affectation d'une valeur à BASH_ARGV0 fait que cette valeur est aussi assignée à $0. Si BASH_ARGV0 est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_CMDS

Une variable de type tableau associatif dont les éléments correspondent à une table de hachage interne de commandes comme celle gérée par la commande interne hash. Les éléments ajoutés à ce tableau apparaissent dans la table de hachage ; cependant, la destruction d'éléments du tableau ne provoque pas actuellement le retrait des noms de commandes de la table de hachage. Si BASH_CMDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_COMMAND

La commande en cours d'exécution ou sur le point d'être exécutée, à moins que l'interpréteur n'exécute une commande à la suite d'une capture, auquel cas c'est la commande s'exécutant au moment de la capture. Si BASH_COMMAND est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_EXECUTION_STRING

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

BASH_LINENO

Une variable de type tableau dont les éléments sont les numéros de ligne des fichiers sources où chaque élément correspondant de FUNCNAME a été invoqué. ${BASH_LINENO[ $i]} est le numéro de la ligne dans le fichier source ( ${BASH_SOURCE[$i+1]}) où ${FUNCNAME[$i]} a été appelé (ou ${BASH_LINENO[$i-1]} si consulté depuis une autre fonction de l'interpréteur). Utilisez LINENO pour obtenir le numéro de ligne actuel.

BASH_LOADABLES_PATH

Liste des répertoires, séparés par des deux-points « : », que l'interpréteur consulte lorsqu'il cherche les commandes internes chargeables dynamiquement spécifiées par la commande enable.

BASH_REMATCH

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

BASH_SOURCE

Une variable de type tableau dont les éléments sont les noms des fichiers source où les noms des fonctions d'interpréteur correspondants à la variable de type tableau FUNCNAME sont définis. La fonction d'interpréteur ${FUNCNAME[$i]} est définie dans le fichier ${BASH_SOURCE[$i]} et appelée depuis ${BASH_SOURCE[ $i+1]}.

BASH_SUBSHELL

Incrémentée dans tous les sous-interpréteurs et environnements de sous-interpréteur quand l’interpréteur commence à s’exécuter dans cet environnement. La valeur initiale est 0. Si BASH_COMMAND est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_VERSINFO

Une variable de type tableau protégée en écriture dont les éléments représentent la version de cette instance de bash. Cette valeur est affectée aux éléments du tableau comme suit :

BASH_VERSION

Se développe en une chaîne décrivant le numéro de version de cette instance de bash.

COMP_CWORD

Un indice dans ${COMP_WORDS} du mot contenant la position actuelle du curseur. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_KEY

La touche (ou dernière touche d'une suite de touches) utilisée pour appeler la fonction de complètement actuelle.

COMP_LINE

La ligne de commande actuelle. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_POINT

L'indice de la position actuelle du curseur relatif au début de la commande actuelle. Si la position actuelle du curseur est à la fin de la commande actuelle, la valeur de cette variable est égale à ${#COMP_LINE}. Cette variable n'est disponible que dans les fonctions de l'interpréteur et les commandes externes appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_TYPE

Configurée à une valeur entière correspondant au type de complètement essayé qui a provoqué l'appel d'une fonction de complètement : TAB pour un complètement normal, ? pour l'affichage des complètements après tabulations successives, ! pour l'affichage des alternatives de complètement de mot partiel, @ pour afficher les complètements si le mot n'est pas modifié, ou % pour le menu de complètement. Cette variable n'est disponible que dans les fonctions de l'interpréteur et les commandes externes appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_WORDBREAKS

Le jeu de caractères que la bibliothèque readline considère comme séparateurs de mots lors du complètement de mot. Si COMP_WORDBREAKS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

COMP_WORDS

Une variable de type tableau (consultez Tableaux ci-dessous) consistant en mots individuels de la ligne de commande actuelle. La ligne est découpée en mots comme readline la découperait, en utilisant COMP_WORDBREAKS tel que décrit ci-dessus. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COPROC

Une variable de type tableau (consultez Tableaux ci-dessous) créée pour représenter les descripteurs de fichier pour les sorties depuis et les entrées vers un coprocessus non nommé (consultez Coprocessus ci-dessus).

DIRSTACK

Une variable de type tableau (consultez Tableaux ci-dessous) représentant le contenu actuel de la pile de répertoires. Les répertoires apparaissent dans la pile dans l'ordre dans lequel la commande interne dirs les affiche. Les affectations des éléments de cette variable tableau peuvent être utilisés pour modifier les répertoires déjà dans la pile, mais les commandes internes pushd et popd doivent être utilisées pour ajouter et enlever des répertoires. L'affectation de cette variable ne modifiera pas le répertoire actuel. Si DIRSTACK est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

EPOCHREALTIME

À chaque fois que ce paramètre est consulté, il se développe en nombre de secondes écoulées depuis l'Epoch Unix (consultez time(3)) comme valeur en virgule flottante avec une granularité d'une microseconde. Les affectations à EPOCHREALTIME sont ignorées. Si EPOCHREALTIME est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

EPOCHSECONDS

À chaque fois que ce paramètre est consulté, il se développe en nombre de secondes écoulées depuis l'Epoch Unix (consultez time(3)). Les affectations à EPOCHSECONDS sont ignorées. Si EPOCHSECONDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

EUID

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

FUNCNAME

Une variable de type tableau contenant le nom de toutes les fonctions de l'interpréteur actuellement dans la pile d'appel d'exécution. L'élément d'indice 0 est le nom de l'une des fonctions en cours d'exécution dans l'interpréteur. L'élément le plus bas (celui avec l'indice le plus grand) est "main". Cette variable n'existe que si une fonction de l'interpréteur est en cours d'exécution. Les affectations de FUNCNAME n'ont aucun effet. Si FUNCNAME est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite. Cette variable peut être utilisée avec BASH_LINENO et BASH_SOURCE. Chaque élément de FUNCNAME a des éléments correspondant dans BASH_LINENO et BASH_SOURCE pour décrire la pile d'appel. Par exemple, ${FUNCNAME[ $i]} a été appelé depuis le fichier ${BASH_SOURCE[$i+1]} à la ligne numéro ${BASH_LINENO[$i]}. La commande interne caller affiche la pile d'appel actuelle utilisant ces renseignements.

GROUPS

Une variable de type tableau contenant la liste des groupes dont l'utilisateur est membre. Les affectations de GROUPS n'ont aucun effet. Si GROUPS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

HISTCMD

Le numéro d'historique, ou l'indice dans la file d'historique, de la commande en cours. Les affectations de HISTCMD sont ignorées. Si HISTCMD est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

HOSTNAME

Automatiquement configurée au nom de la machine actuelle.

HOSTTYPE

Automatiquement configurée en chaîne décrivant de façon unique le type de machine sur laquelle bash s'exécute. La valeur par défaut dépend du système.

LINENO

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

MACHTYPE

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

MAPFILE

Une variable de type tableau (consultez Tableaux ci-dessous) créée pour représenter le texte lu par la commande interne mapfile si aucun nom de variable n'a été fourni.

OLDPWD

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

OPTARG

La valeur du dernier argument d'option traité par la commande interne getopts (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

OPTIND

L'indice du prochain argument à traiter par la commande interne getopts (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

OSTYPE

Automatiquement configurée en chaîne décrivant le système d'exploitation sur lequel bash s'exécute. La valeur par défaut dépend du système.

PIPESTATUS

Une variable de type tableau (consultez Tableaux ci-dessous) contenant une liste des états finaux des processus exécutés dans le pipeline exécuté le plus récemment au premier plan (qui peut éventuellement contenir une seule commande).

PPID

L'identifiant du processus parent de l'interpréteur. Cette variable est en lecture seule.

PWD

Le répertoire de travail actuel tel que configuré par la commande cd.

RANDOM

À chaque fois que ce paramètre est consulté, un entier aléatoire entre 0 et 32767 est engendré. L'affectation d'une valeur à RANDOM initialise (ensemence) la suite de nombres aléatoires. Si RANDOM est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

READLINE_ARGUMENT

Tout argument numérique donné à une commande readline qui a été définie en utilisant "bind -x" (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) quand il a été invoqué.

READLINE_LINE

Le contenu du tampon de ligne readline, pour utiliser avec "bind -x" (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

READLINE_MARK

La position de la marque (point d'insertion enregistré) dans le tampon de ligne readline, pour utiliser avec "bind -x" (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les caractères entre le point d'insertion et la marque sont souvent appelés la zone.

READLINE_POINT

La position du point d'insertion dans le tampon de ligne readline, pour utiliser avec "bind -x" (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

REPLY

Configurée en ligne de saisie lue par la commande interne read lorsqu'aucun argument n'a été fourni.

SECONDS

À chaque fois que ce paramètre est consulté, il se développe en nombre de secondes écoulées depuis le lancement de l'interpréteur. Si une valeur est affectée à SECONDS, la valeur renvoyée lors d’une consultation ultérieure est le temps en seconde écoulé depuis l'affectation, ajouté à la valeur affectée. Le nombre de secondes entre le moment du lancement de l'interpréteur et l'heure actuelle sont toujours déterminés en interrogeant l'horloge système. Si SECONDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

SHELLOPTS

Liste des options activées de l'interpréteur, séparées par des deux-points « : ». Chaque mot de la liste est un argument correct pour l'option -o de la commande interne set (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les options apparaissant dans SHELLOPTS sont celles 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 en lecture seule.

SHLVL

Incrémenté de 1 à chaque appel d'une instance de bash.

SRANDOM

Cette variable engendre un nombre pseudo-aléatoire de 32 bits chaque fois qu'elle est consultée. Le générateur de nombres aléatoires n'est pas linéaire sur les systèmes qui prennent en charge /dev/urandom ou arc4random, aussi chaque nombre renvoyé n'a aucune relation avec les nombres précédents. Le générateur de nombre aléatoire ne peut pas être ensemencé, aussi les affectations à cette variable n'ont aucun effet. Si SRANDOM est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

UID

Contient l'UID de l'utilisateur actuel, initialisé au démarrage de l'interpréteur. Cette variable est en lecture seule.

BASH_COMPAT

La valeur est utilisée pour définir le niveau de compatibilité de l’interpréteur. Consultez MODE DE COMPATIBILITÉ DE L'INTERPRÉTEUR ci-dessous pour une description des différents niveaux de compatibilité et leurs conséquences. La valeur peut être un nombre décimal (par exemple 4.2) ou entier (par exemple 42) correspondant au niveau de compatibilité voulu. Si BASH_COMPAT est détruite ou définie comme une chaîne vide, le niveau de compatibilité est défini à la valeur par défaut de la version actuelle. Si BASH_COMPAT est définie à une valeur de niveau de compatibilité impossible, l’interpréteur affiche un message d’erreur et définit le niveau de compatibilité à la valeur par défaut de la version actuelle. Les valeurs possibles correspondent aux niveaux de compatibilité décrits ci-dessous dans MODE DE COMPATIBILITÉ DE L'INTERPRÉTEUR. Par exemple, 4.2 et 42 sont des valeurs possibles qui correspondent à l'option compat42 de shopt et définissent le niveau de compatibilité à 42. La version actuelle est aussi une valeur possible.

BASH_ENV

Si ce paramètre existe 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 dans ~/.bashrc. La valeur de BASH_ENV est soumise au développement des paramètres, à la substitution de commande et au développement arithmétique avant d'être considérée comme un nom de fichier. PATH n'est pas utilisée pour rechercher le fichier obtenu.

BASH_XTRACEFD

Si configurée à une valeur entière correspondant à un descripteur de fichier correct, bash écrira la trace de sortie si set -x est activé vers ce descripteur de fichier. Le descripteur de fichier est fermé quand BASH_XTRACEFD est détruite ou qu'une nouvelle valeur lui est affectée. Détruire BASH_XTRACEFD ou lui affecter la chaîne vide conduit la trace de sortie à être envoyée vers la sortie d'erreur standard. Remarquez que configurer BASH_XTRACEFD à 2 (le descripteur de fichier de la sortie d'erreur standard) puis la détruire revient à fermer la sortie d'erreur standard.

CDPATH

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

CHILD_MAX

Définir le nombre de valeurs d’état de sortie des enfants dont l’interpréteur doit se souvenir. Bash ne permettra pas à cette valeur d’être inférieure à un minimum imposé par POSIX, ni d’être supérieure à une valeur maximale (8192 pour l’instant). La valeur minimale dépend du système.

COLUMNS

Utilisée par la commande composée select pour déterminer la largeur du terminal lors de l'affichage des listes de sélection. Automatiquement configurée si l’option checkwinsize est activée ou dans un interpréteur interactif à la réception d'un signal SIGWINCH.

COMPREPLY

Une variable de type tableau dans lequel bash lit les complètements possibles produits par une fonction de l'interpréteur appelée par les outils de complètement programmables (consultez Complètement programmable ci-dessous). Chaque élément du tableau contient un complètement possible.

EMACS

Si bash trouve cette variable dans l'environnement lorsque l'interpréteur démarre avec la valeur "t", il considère que l'interpréteur est lancé dans un tampon d'interpréteur d'Emacs et désactive l'édition en ligne.

ENV

Développé et exécuté de façon similaire à BASH_ENV (consultez APPEL ci-dessus) quand l'interpréteur interactif est invoqué en mode POSIX.

EXECIGNORE

Une liste, séparée par des deux-points « : », de motifs de l'interpréteur (voir Motifs génériques) définissant la liste de noms de fichier à ignorer par la commande de recherche utilisant PATH. Les fichiers dont les noms de chemin complets correspondent à un de ces motifs ne sont pas considérés comme des fichiers exécutables en vue du complètement et de l'exécution de commande au moyen d'une recherche dans PATH. Cela n'affecte pas le comportement des commandes [, test et [[. Les noms de chemin complets dans la table de hachage des commandes ne sont pas sujets à EXECIGNORE. Utiliser cette variable pour ignorer des fichiers de bibliothèque partagée dont le bit exécutable est présent, mais qui ne sont pas des fichiers exécutables. La correspondance de motif respecte la configuration de l'option d'interpréteur extglob.

FCEDIT

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

FIGNORE

Une liste de suffixes, séparés par des deux-points « : », que bash ignorera lors du complètement des noms de fichiers (consultez READLINE ci-dessous). Un nom de fichier dont le suffixe correspond à l'un de ceux mentionnés dans FIGNORE est exclu de la liste des noms de fichiers correspondant pour le complètement. Par exemple, cette variable peut prendre la valeur ".o:~" (des protections sont nécessaires pour l'affectation d'une valeur à cette variable qui contient des tildes).

FUNCNEST

Si configurée à une valeur numérique strictement positive, cela définit le niveau maximal d'imbrication de fonctions. Les invocations de fonctions qui dépassent ce niveau d'imbrication forceront la commande actuelle à abandonner.

GLOBIGNORE

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

HISTCONTROL

Une liste de valeurs, séparées par des deux-points « : », commandant la façon dont les commandes sont sauvegardées dans la file d'historique. Si la liste des valeurs contient la valeur ignorespace, les lignes commençant par une espace ne sont pas sauvegardées dans la file d'historique. La valeur ignoredups conduit à ne pas sauvegarder une ligne correspondant exactement à la ligne de commande précédente. La présence de ignoreboth est un condensé pour ignorespace et ignoredups. La valeur erasedups conduit à retirer de la file d'historique toutes les lignes précédant la ligne actuelle et lui correspondant avant que cette ligne y soit sauvegardée. Toute valeur qui ne fait pas partie de la liste ci-dessus est ignorée. Si HISTCONTROL est inexistante ou si elle ne contient pas une valeur correcte, toutes les lignes lues par l'analyseur de l'interpréteur seront sauvegardées dans la file d'historique, selon la valeur de HISTIGNORE. La seconde ligne et les suivantes d'une commande multiligne ne sont pas testées et sont ajoutées dans l'historique indépendamment de la valeur de HISTCONTROL.

HISTFILE

Le nom du fichier dans lequel l'historique des commandes est sauvegardé (consultez HISTORIQUE ci-dessous). Par défaut, il s'agit de ~/.bash_history. Si inexistante, l'historique des commandes n'est pas sauvegardé lorsqu'un interpréteur se termine.

HISTFILESIZE

Le nombre maximal de lignes contenues dans le fichier d'historique. Quand cette variable contient une valeur, le fichier d’historique est tronqué, si besoin, pour ne pas contenir plus que ce nombre de lignes en enlevant les entrées les plus anciennes. Ce fichier est aussi tronqué à cette taille après son écriture quand un interpréteur se termine. Si la valeur est 0, le fichier d’historique est tronqué à une taille nulle. Les valeurs non numériques ou négatives empêchent la troncature. L’interpréteur définit la valeur par défaut à la valeur de HISTSIZE après avoir lu tous les fichiers d’initialisation.

HISTIGNORE

Une liste de motifs, séparés par des deux-points « : », déterminant quelles lignes de commande devraient être sauvegardées dans la file d'historique. Chaque motif est accroché au début de la ligne et doit correspondre à celle-ci complètement (aucun ajout de «  * » implicite). Chaque motif est comparé à chaque ligne après application des vérifications de HISTCONTROL. En plus des motifs génériques usuels de l'interpréteur, «  & » correspond à la ligne précédente de l'historique. «  & » peut être protégée par une contre-oblique ; la contre-oblique est supprimée avant de tenter une comparaison. La seconde ligne et les suivantes d'une commande composée multiligne ne sont pas testées et sont ajoutées dans l'historique quelque soit la valeur de HISTIGNORE. La correspondance de motif respecte la configuration de l'option d'interpréteur extglob.

HISTSIZE

Le nombre de commandes à mémoriser dans l'historique (consultez HISTORIQUE ci-dessous). Si la valeur est 0, les commandes ne sont pas sauvegardées dans la liste d’historique. Les valeurs négatives permettent de sauvegarder toutes les commandes dans la liste d’historique (sans limite). L’interpréteur définit la valeur par défaut à 500 après avoir lu tous les fichiers d’initialisation.

HISTTIMEFORMAT

Si cette variable existe et n'est pas NULL, sa valeur est utilisée comme une chaîne de caractères par strftime(3) afin d'imprimer l'horodatage associé à chaque élément de l'historique affiché par la commande interne history. Si cette variable existe, les horodatages sont écrits dans le fichier d'historique afin d'être conservés au fur et à mesure des sessions de l'interpréteur. Cela utilise le caractère de commentaire d'historique pour distinguer l'horodatage des autres lignes de l'historique.

HOME

Le répertoire d'accueil de l'utilisateur actuel ; l'argument par défaut de la commande interne cd. La valeur de cette variable est aussi utilisée lors du développement du tilde.

HOSTFILE

Contient le nom d'un fichier ayant le même format /etc/hosts qui devra être lu lorsque l'interpréteur aura besoin de compléter un nom de machine. La liste des complètements possibles de noms de machine peut être changée pendant l'exécution de l'interpréteur ; à la tentative de complètement de nom de machine suivant le changement de valeur, bash ajoute le contenu du nouveau fichier à la liste existante. Si HOSTFILE existe mais est vide, ou désigne un fichier non accessible en lecture, bash essaie de lire /etc/hosts pour obtenir la liste des complètements de noms de machine possibles. Lorsque HOSTFILE est détruite, la liste des noms de machine est effacée.

IFS

Le séparateur de champs interne («  Internal Field Separator ») qui est utilisé pour le découpage en mots après les développements et pour découper les lignes en mots avec la commande interne read. La valeur par défaut est « <espace><tab><changement_de_ligne> ».

IGNOREEOF

Commande le comportement d'un interpréteur interactif à la réception d'un caractère EOF (fin de fichier) comme unique saisie. Si elle existe, la valeur est le nombre de caractères EOF consécutifs qui doivent être tapés comme premiers caractères sur une ligne de saisie avant que bash ne termine. Si la variable existe mais que sa valeur n'est pas numérique ou si elle n'a pas de valeur, la valeur par défaut est 10. Si elle n'existe pas, EOF signifie la fin de la saisie pour l'interpréteur.

INPUTRC

Le nom du fichier d’initialisation pour readline, prioritaire sur le fichier par défaut de ~/.inputrc (consultez READLINE ci-dessous).

INSIDE_EMACS

Si cette variable apparaît dans l'environnement quand le script démarre, bash considère qu'il s'exécute dans un tampon d'interpréteur d'Emacs et peut désactiver l'édition de ligne, suivant la valeur de TERM.

LANG

Utilisée pour déterminer le paramètre linguistique régional pour toute catégorie non spécifiquement sélectionnée par une variable commençant par LC_.

LC_ALL

Cette variable surpasse LANG et toute autre variable LC_ indiquant une catégorie de paramètres linguistiques régionaux.

LC_COLLATE

Cette variable détermine l'ordre de collation utilisé pour trier les résultats du développement des chemins et détermine le comportement des expressions d’intervalle, des classes d'équivalences et des suites de collations dans le développement des chemins et la correspondance de motifs.

LC_CTYPE

Cette variable détermine l'interprétation des caractères et le comportement des classes de caractères lors du développement des chemins et de la recherche de correspondances de motifs.

LC_MESSAGES

Cette variable détermine le paramètre linguistique régional utilisé pour traduire les chaînes entre guillemets doubles précédées d'un $.

LC_NUMERIC

Cette variable détermine le paramètre linguistique régional utilisé pour formater les nombres.

LC_TIME

Cette variable détermine le paramètre linguistique régional utilisé pour les données et le temps.

LINES

Utilisée par la commande composée select pour déterminer la taille des colonnes lors de l'affichage des listes de sélection. Automatiquement configurée si l’option checkwinsize est activée ou dans un interpréteur interactif à la réception d'un signal SIGWINCH.

MAIL

Si ce paramètre correspond à un nom de fichier ou de répertoire et si la variable MAILPATH est inexistante, bash informe l'utilisateur de l'arrivée de messages dans le fichier indiqué ou le répertoire au format Maildir.

MAILCHECK

Indique la durée (en seconde) au bout de laquelle bash vérifie si un nouveau message est arrivé. La valeur par défaut est 60 secondes. Lorsque le délai est écoulé, l'interpréteur vérifiera la présence d'un courrier électronique avant d'afficher son invite de base. Si cette variable est inexistante, ou contient une valeur strictement négative, l'interpréteur désactive la vérification du courrier.

MAILPATH

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

OPTERR

Si configurée à la valeur 1, bash affiche les messages d'erreurs engendrés par la commande interne getopts (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). OPTERR est initialisée avec la valeur 1 à chaque appel de l'interpréteur ou au lancement d'un script.

PATH

Le chemin de recherche des commandes à exécuter. Il s'agit d'une liste de répertoires, séparés par des deux-points « : » dans lesquels l'interpréteur recherche les commandes (consultez EXÉCUTION DES COMMANDES ci-dessous). Un nom de répertoire de taille nulle (NULL) dans la valeur de PATH désigne le répertoire actuel. Un répertoire NULL peut apparaître comme deux deux-points consécutifs ou comme des deux-points en début ou en fin. Le chemin par défaut dépend du système et est choisi par l'administrateur installant bash. Une valeur commune est ``/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin''.

POSIXLY_CORRECT

Si cette variable existe dans l'environnement lorsque bash démarre, l'interpréteur passe en mode POSIX avant de lire les fichiers d’initialisation comme si l'option --posix avait été fournie. Si elle est créée pendant que l'interpréteur est en cours d'exécution, bash active le mode POSIX comme si la commande set -o posix a été exécutée. Quand l'interpréteur passe en mode POSIX, il configure cette variable si elle ne l'a pas déjà été.

PROMPT_COMMAND

Si cette variable existe et est un tableau, la valeur de chaque élément existant est exécutée comme commande préalablement à l'affichage de chaque invite de base. Si elle existe mais n'est pas une variable de type tableau, sa valeur est utilisée comme commande à exécuter à la place.

PROMPT_DIRTRIM

Si elle contient un nombre supérieur à zéro, cette valeur est utilisée comme nombre de répertoires finaux à conserver lors du développement des protections de chaîne d'invite \w et \W (consultez INVITES ci-dessous). Les caractères supprimés sont remplacés par une ellipse.

PS0

La valeur de ce paramètre est développée (consultez INVITES ci-dessous) puis affichée par les interpréteurs interactifs après la lecture d'une commande et avant son exécution.

PS1

La valeur de ce paramètre est développée puis utilisée comme chaîne d'invite de base (consultez INVITES ci-dessous). La valeur par défaut est «  \s-\v\$  ».

PS2

La valeur de ce paramètre est développée comme PS1 puis utilisée comme chaîne d'invite secondaire. La valeur par défaut est «  >  ».

PS3

La valeur de ce paramètre est utilisée comme invite de la commande select (consultez GRAMMAIRE DE L'INTERPRÉTEUR ci-dessus).

PS4

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

SHELL

Cette variable développe le chemin d'accès complet à l'interpréteur de commandes. Si elle est inexistante au démarrage de l'interpréteur, bash lui affecte le chemin d'accès complet à l'interpréteur de commandes de connexion de l'utilisateur actuel.

TIMEFORMAT

La valeur de ce paramètre est utilisée en tant que chaîne de format indiquant comment les informations de paramétrage doivent être affichées pour les pipelines précédés du mot réservé time. Le caractère % introduit une suite de caractères de protection qui est développée en valeur de temps ou autre information. Les suites de caractères de protection et leurs significations sont les suivantes ; les crochets marquent les parties facultatives.

Le p facultatif est un chiffre indiquant la précision, le nombre de chiffres après la virgule. Une valeur de 0 conduit à affichage de nombres entiers. Trois chiffres au plus peuvent être affichés après la virgule ; toute valeur supérieure à 3 sera modifiée en 3. Si p n'est pas précisé, la valeur 3 est utilisée.

Le l facultatif indique un format plus long, incluant les minutes, de la forme MMmSS.DD s. La valeur de p détermine si la partie décimale est affichée ou non.

Si cette variable n'existe pas, bash agit comme si elle avait la valeur $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. Si la valeur est NULL, aucune information de chronométrage n'est affichée. Un caractère final de changement de ligne est ajouté quand la chaîne de format est affichée.

TMOUT

Si configurée en valeur strictement positive, TMOUT est traitée comme le délai par défaut pour la commande interne read. La commande select se termine s'il n'y a pas de saisie au bout de TMOUT secondes lorsque l'entrée vient d'un terminal. Dans un interpréteur interactif, la valeur est interprétée comme une durée en seconde à attendre une ligne de saisie après avoir affiché l'invite de base. Bash se termine après avoir attendu pendant ce temps en seconde si aucune saisie de ligne complète n'est arrivée.

TMPDIR

Si existante, bash utilise sa valeur comme nom de répertoire dans lequel bash crée les fichiers temporaires nécessaires au fonctionnement de l'interpréteur.

auto_resume

Cette variable commande le comportement de l'interpréteur vis-à-vis de l'utilisateur et du contrôle des tâches. Si cette variable existe, les commandes simples constituées d'un seul mot, sans redirection, sont considérées comme de possibles relances de tâches suspendues. Aucune ambiguïté n'est possible, si plusieurs tâches commencent par la chaîne saisie, la tâche à laquelle il a été accédé le plus récemment est sélectionnée. Le nom d'une tâche suspendue, dans ce contexte, est la ligne de commande utilisée pour la lancer. Si configurée à la valeur exact, la chaîne fournie doit correspondre exactement au nom d'une tâche suspendue ; si configurée à substring, la chaîne fournie doit correspondre à une sous-chaîne du nom de la tâche suspendue. La valeur substring donne une fonctionnalité analogue à l'identificateur de tâche %? (consultez CONTRÔLE DES TÂCHES ci-dessous). Si configurée à toute autre valeur, la chaîne fournie doit être le préfixe du nom d'une tâche suspendue ; cela fournit une fonctionnalité analogue à l'identificateur de tâche %string.

histchars

Les deux ou trois caractères commandant le développement de l'historique et le découpage en lexèmes (consultez DÉVELOPPEMENT DE L'HISTORIQUE ci-dessous). Le premier caractère est le caractère de développement de l'historique, celui qui indique le début d'un développement d'historique (normalement «  ! »). Le second caractère est celui de substitution rapide, utilisé comme raccourci pour relancer la commande précédente, en modifiant une partie de la chaîne (par défaut «  ^ »). Le troisième caractère facultatif est celui qui indique, lorsqu'on le trouve en début de mot que le reste de la ligne est un commentaire (normalement «  # »). Ce caractère de commentaire empêche le développement de l'historique pour tous les mots restants sur la ligne. Il ne conduit pas nécessairement l'analyseur de l'interpréteur à considérer le reste de la ligne comme un commentaire.

Tableaux

DÉVELOPPEMENTS

Développement des accolades

Développement du tilde

Développement des paramètres

${paramètre}

est remplacé par la valeur du paramètre. Les accolades sont nécessaires quand le paramètre est un paramètre positionnel ayant plusieurs chiffres, ou si le paramètre est suivi de caractères n'appartenant pas à son nom. Le paramètre est un paramètre d’interpréteur (comme décrit précédemment dans PARAMÈTRES) ou une référence de tableau ( Tableaux).

${paramètre:-mot}

Utilisation de valeur par défaut. Si le paramètre est inexistant ou NULL, le développement du mot est substitué. Sinon, c'est la valeur du paramètre qui est substituée.

${paramètre:=mot}

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

${paramètre:?mot}

Affichage d'erreur si NULL ou inexistant. Si le paramètre est inexistant ou NULL, 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 termine, s'il n'est pas interactif. Sinon, la valeur du paramètre est substituée.

${paramètre:+mot}

Utilisation de valeur alternative. Si le paramètre est NULL ou inexistant, rien n'est substitué. Sinon le développement du mot est substitué.

${paramètre:début}

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

Développement des sous-chaînes. Se développe pour fournir la sous-chaîne de longueur indiquée (en caractère) commençant au début. Si le paramètre est @ ou *, un tableau indicé par @ ou *, ou un nom de tableau associatif, le résultat diffère comme décrit ci-dessous. Si la longueur est omise, fournit la sous-chaîne commençant au caractère indiqué par début et s'étendant jusqu'à la fin de la valeur. La longueur et le début sont des expressions arithmétiques (consultez ÉVALUATION ARITHMÉTIQUE ci-dessous). Si le début est négatif, sa valeur est considérée à partir de la fin du contenu du paramètre. Si longueur est négatif, sa valeur est considérée comme une position en caractère à partir de la fin de la valeur du paramètre plutôt que comme un nombre de caractères, et le développement est constitué des caractères entre le début et cette position. Remarquez que les positions négatives doivent être séparées des deux-points par au moins une espace pour éviter d’être confondues avec le développement de :-. Si le paramètre est @ ou *, le résultat correspond à longueurparamètres positionnels commençant au début. Une valeur négative de début est considérée relative au plus grand paramètre positionnel plus un (ainsi un indice -1 fait référence au dernier paramètre positionnel). C’est une erreur de développement si longueur est évaluée en nombre négatif. Si le paramètre est un nom de tableau indicé par @ ou *, le résultat est les longueur éléments du tableau commençant à ${paramètre [début]}. Une valeur négative de début est prise relativement à la valeur maximale de l'indice du tableau considéré plus un. C’est une erreur de développement si longueur est évaluée en nombre négatif. Le développement de sous-chaîne appliqué à un tableau associatif produit des résultats non définis. L'indexation des sous-chaînes commence à zéro, sauf pour les paramètres positionnels pour lesquels l'indexation commence à 1 par défaut. Si début est 0, et que les paramètres positionnels sont utilisés, la liste est préfixée par $0.

${!préfixe*}

${!préfixe@}

Noms correspondant au préfixe. Se développe en noms des variables dont les noms commencent par préfixe, séparés par le premier caractère de la variable spéciale IFS. Si @ est utilisé et que le développement apparaît entre guillemets doubles, chaque nom de variable se développe séparément.

${!nom[@]}

${!nom[*]}

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

${#paramètre}

Longueur du paramètre. Est remplacé par la longueur, en caractères, de la valeur du paramètre. Si le paramètre est * ou @, la valeur est le nombre de paramètres positionnels. Si le paramètre est un nom de tableau indicé par * ou @, la valeur donnée est le nombre d'éléments du tableau. Si le paramètre est un nom de tableau indicé par un nombre négatif, ce nombre est considéré comme ajouté à l'indice maximal de paramètre plus un (ainsi un indice négatif compte à rebours depuis la fin du tableau et un indice -1 fait référence au dernier élément).

${paramètre#mot}

${paramètre##mot}

Retrait du motif correspondant au préfixe. Le mot est développé pour fournir un motif, comme dans le développement des chemins et mis en correspondance avec la valeur développée du paramètre avec les règles décrites dans Motifs génériques ci-dessous. Si le motif correspond au début de la valeur du paramètre, alors le développement prend la valeur développée du paramètre après suppression du plus court (cas «  # ») ou du plus long (cas «  ## ») motif correspondant. Si le paramètre est @ ou *, l'opération de suppression de motif est appliquée à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, l'opération de suppression de motif est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre%mot}

${paramètre%%mot}

Retrait du motif correspondant au suffixe. Le mot est développé pour fournir un motif, comme dans le développement des chemins et mis en correspondance avec la valeur développée du paramètre avec les règles décrites dans Motifs génériques ci-dessous. Si le motif correspond à une portion finale de la valeur développée du paramètre, alors le développement prend la valeur développée du paramètre après suppression du plus court (cas «  % ») ou du plus long (cas «  %% ») motif correspondant. Si le paramètre est @ ou *, l'opération de suppression de motif est appliquée à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, l'opération de suppression de motif est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

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

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

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

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

Substitution de motif. Le motif est développé produire un motif comme dans le développement des chemins. Le paramètre est développé et la plus longue portion correspondant au motif est remplacée par la chaîne. La chaîne est sujette au développement du tilde, des paramètres et des variables, au développement arithmétique, à la substitution de commande et de processus, et à la suppression des protections. La mise en correspondance est réalisée en utilisant les règles décrites dans Motifs génériques ci-dessous. Dans la première forme ci-dessus, seule la première correspondance est remplacée. S'il y a deux barres obliques séparant le paramètre et le motif, (la seconde forme ci-dessus) toutes les correspondances au motif sont remplacées par la chaîne. Si le motif est précédé par # (la troisième forme ci-dessus), il doit correspondre au début de la valeur développée du paramètre. Si le motif est précédé par % (la quatrième forme ci-dessus), il doit correspondre à la fin de la valeur du développement du paramètre. Si la chaîne est NULL, les portions correspondant au motif sont supprimées et le / suivant le motif peut être omis. Si l'option d'interpréteur patsub_replacement est activée en utilisant shopt, toutes les instances non protégées de & dans la chaîne sont remplacées par la partie correspondante du motif. La protection d'une partie de la chaîne empêche les remplacements dans le développement de la partie protégée, y compris le remplacement des chaînes stockées dans les variables de l'interpréteur. La contre-oblique protégera & dans la chaîne ; la contre-oblique est supprimée afin de permettre un & littéral dans la chaîne de remplacement. La contre-oblique peut aussi être utilisée pour protéger une contre-oblique ; \\ résulte en une contre-oblique littérale dans le remplacement. Les utilisateurs doivent faire attention si la chaîne est protégée entre des guillemets doubles pour éviter des interactions non souhaitées entre la contre-oblique et les guillemets doubles, dans la mesure où la contre-oblique a une signification particulière avec des guillemets doubles. La substitution de motif réalise la vérification de la présence de & non protégée après le développement de chaîne ; les développeurs de programmes d’interpréteur doivent protéger toutes les occurrences de & qu'ils souhaitent être traitées littéralement dans le remplacement et s'assurer que toutes les instances de & qu'ils souhaitent voir remplacées ne soient pas protégées. Si l'option d'interpréteur nocasematch est activée, la mise en correspondance est réalisée sans tenir compte de la casse des caractères alphabétiques. Si le paramètre est @ ou *, la substitution est appliquée à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, l'opération de substitution est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre^motif}

${paramètre^^motif}

${paramètre,motif}

${paramètre,,motif}

Modification de la casse. Ce développement modifie la casse des caractères alphabétiques du paramètre. Le motif est développé pour fournir un motif, comme dans le développement des chemins. Chaque caractère de la valeur développée du paramètre est testé par rapport au motif et, en cas de correspondance, sa casse est convertie. Le motif ne devrait pas essayer de correspondre à plus d’un caractère. L'opérateur ^ convertit les lettre minuscules correspondant à ce motif en majuscules ; l'opérateur , convertit les lettre majuscules correspondant à ce motif en minuscules. Les développements ^^ et ,, convertissent tous les caractères correspondant à leur valeur développée ; les développements ^ et , convertissent seulement le premier caractère de la valeur développée correspondant. Si motif est omis, il est traité comme un ?, ce qui correspond à n'importe quel caractère. Si le paramètre est @ ou *, la modification de casse s'applique à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, la modification de casse s'applique à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre@opérateur}

Transformation de paramètre. Le développement est soit une transformation de la valeur du paramètre ou des informations sur paramètre lui-même, selon la valeur de opérateur. Chaque opérateur est une lettre unique :

Substitution de commande

Développement arithmétique

Substitution de processus

Découpage en mots

Développement des chemins

Suppression des protections

REDIRECTIONS

Redirection d'entrée

Redirection de sortie

Ajout d'une sortie redirigée

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

Ajout de la sortie standard et de la sortie d'erreur standard

Document en ligne

[ n]<<[-]mot
         document_en_ligne
délimiteur

Chaînes en ligne

[ n]<<<mot

Dédoublement de descripteurs de fichier

Déplacement de descripteurs de fichier

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

ALIAS

FONCTIONS

ÉVALUATION ARITHMÉTIQUE

id++ id--

post-incrément et post-décrément de variables

- +

moins et plus unaires

++id --id

préincrément et prédécrément de variables

! ~

négations logique et binaire

**

exponentiation

* / %

multiplication, division, reste

+ -

addition, soustraction

<< >>

décalage arithmétique à gauche et à droite

<= >= < >

comparaisons

== !=

égalité et différence

&

ET binaire

^

OU exclusif binaire

|

OU binaire

&&

ET logique

||

OU logique

expr?expr:expr

opérateur conditionnel

= *= /= %= += -= <<= >>= &= ^= |=

affectations

expr1 , expr2

virgule

CONDITIONS

-a fichier

Vrai si le fichier existe.

-b fichier

Vrai si le fichier existe et est un fichier spécial bloc.

-c fichier

Vrai si le fichier existe et est un fichier spécial caractère.

-d fichier

Vrai si le fichier existe et est un répertoire.

-e fichier

Vrai si le fichier existe.

-f fichier

Vrai si le fichier existe et est un fichier normal.

-g fichier

Vrai si le fichier existe et a son bit Set-GID positionné.

-h fichier

Vrai si le fichier existe et est un lien symbolique.

-k fichier

Vrai si le fichier existe et a son bit « sticky » positionné.

-p fichier

Vrai si le fichier existe et est un tube nommé (FIFO).

-r fichier

Vrai si le fichier existe et est accessible en lecture.

-s fichier

Vrai si le fichier existe et a une taille strictement positive.

-t df

Vrai si le descripteur de fichier df est ouvert et se rapporte à un terminal.

-u fichier

Vrai si le fichier existe et a son bit Set-UID positionné.

-w fichier

Vrai si le fichier existe et est accessible en écriture.

-x fichier

Vrai si le fichier existe et est exécutable.

-G fichier

Vrai si le fichier existe et appartient au GID effectif du groupe.

-L fichier

Vrai si le fichier existe et est un lien symbolique.

-N fichier

Vrai si le fichier existe et a été modifié depuis sa dernière lecture.

-O fichier

Vrai si le fichier existe et appartient à l'UID effectif de l'utilisateur.

-S fichier

Vrai si le fichier existe et est une socket.

fichier_1 -ef fichier_2

Vrai si le fichier_1 et le fichier_2 se rapportent au même périphérique et ont les mêmes numéros d'inœuds.

fichier_1 -nt fichier_2

Vrai si le fichier_1 est plus récent que le fichier_2 (selon les dates de dernière modification) ou si fichier_1 existe et non fichier_2.

fichier_1 -ot fichier_2

Vrai si le fichier_1 est plus ancien que le fichier_2 ou si fichier_2 existe et non fichier_1.

-o nom_opt

Vrai si l'option d'interpréteur nom_opt est activée. Consulter la liste des options ci-dessous dans la description de l'option -o de la commande interne set.

-v nom_de_variable

Vrai si la variable nom_de_variable de l'interpréteur est configurée (si une valeur lui a été assignée).

-R nom_de_variable

Vrai si la variable nom_de_variable de l'interpréteur est configurée et est une référence de nom.

-z chaîne

Vrai si la longueur de la chaîne est nulle.

chaîne

-n chaîne

Vrai si la longueur de la chaîne est non nulle.

chaîne_1 == chaîne_2

chaîne_1 = chaîne_2

Vrai si les deux chaînes sont égales. Le symbole = devrait être utilisé avec la commande test pour être en conformité POSIX. Utilisée avec la commande [[, cela réalise une correspondance de motif tel que décrit précédemment ( Commandes composées).

chaîne_1 != chaîne_2

Vrai si les deux chaînes sont différentes.

chaîne_1 < chaîne_2

Vrai si chaîne_1 se trouve avant chaîne_2 dans l'ordre lexicographique.

chaîne_1 > chaîne_2

Vrai si chaîne_1 se trouve après chaîne_2 dans l'ordre lexicographique.

arg1 OP arg2

OP est l'un des opérateurs suivants -eq, -ne, -lt, -le, -gt ou -ge. Ces opérateurs arithmétiques binaires renvoient vrai si arg1 est respectivement égal, différent, inférieur, inférieur ou égal, supérieur, supérieur ou égal à arg2. arg1 et arg2 peuvent être des entiers positifs ou négatifs. Lorsqu'ils sont utilisés avec la commande [[, arg1 et arg2 sont évalués comme des expressions arithmétiques (consultez ÉVALUATION ARITHMÉTIQUE ci-dessus).

DÉVELOPPEMENT DES COMMANDES SIMPLES

1.

Les mots que l'analyseur a repéré comme affectations de variables (ceux qui précèdent le nom de la commande) et les redirections sont conservées pour un traitement ultérieur.

2.

Les mots qui ne sont ni des affectations de variables ni des redirections sont développés. S'il reste des mots après le développement, le premier mot est considéré comme le nom d'une commande et les suivants comme ses arguments.

3.

Les redirections sont effectuées comme décrit ci-dessus dans REDIRECTIONS.

4.

Le texte suivant le signe = de chaque affectation de variable est sujet au développement du tilde, des paramètres, à la substitution de commande, au développement arithmétique et à la suppression des protections avant d'être affecté à la variable.

EXÉCUTION DES COMMANDES

ENVIRONNEMENT D'EXÉCUTION DES COMMANDES

•

les fichiers ouverts hérités par l'interpréteur à son appel et modifiés par les redirections fournies à la commande interne exec ;

•

le répertoire de travail actuel comme configuré par cd, pushd ou popd ou hérité par l'interpréteur à son appel ;

•

le masque de création de fichier comme configuré par umask ou hérité du parent de l'interpréteur ;

•

les captures actuelles configurées par trap ;

•

les paramètres de l'interpréteur configurés par des affectations de variables, avec la commande interne set, ou hérités de l'environnement du parent de l'interpréteur ;

•

les fonctions de l'interpréteur définies lors de l'exécution ou héritées de l'environnement du parent de l'interpréteur ;

•

les options activées à l'appel (par défaut ou avec les arguments de ligne de commande) ou par set ;

•

les options activées par shopt ;

•

les alias de l'interpréteur définies par la commande alias ;

•

les ID des divers processus, y compris ceux des tâches en arrière-plan, la valeur de $$ et la valeur de PPID.

•

les fichiers ouverts de l'interpréteur, ainsi que toutes modifications et ajouts précisés par les redirections de la commande ;

•

le répertoire de travail actuel ;

•

le masque de création de fichiers ;

•

les variables et les fonctions de l'interpréteur marquées pour l'exportation, ainsi que les variables exportées spécialement pour la commande ;

•

les captures interceptées par l'interpréteur sont réinitialisées aux valeurs héritées de l'interpréteur parent et les captures ignorées par l'interpréteur restent ignorées.

ENVIRONNEMENT

CODE DE RETOUR

SIGNAUX

1.

Si la commande termine du fait du SIGINT, bash conclut que l'utilisateur a l'intention de mettre fin à tout le script et répond au SIGINT (par exemple en exécutant une capture de SIGINT ou en s'arrêtant lui-même) ;

2.

Si la commande ne se termine pas du fait du SIGINT, le programme a géré le SIGINT lui même et ne l'a pas traité comme un signal fatal. Dans ce cas bash ne traite pas le SIGINT comme un signal fatal, en supposant plutôt soit que le SIGINT était utilisé comme un élément du déroulement normal du programme (par exemple, emacs l'utilise pour interrompre des commandes d'édition) ou était abandonné délibérément. Néanmoins, bash exécutera toute capture définie par SIGINT, comme il le fait pour tout autre signal capturé reçu pendant qu'il attend que la commande au premier plan s'achève, pour des raisons de compatibilité

CONTRÔLE DES TÂCHES

INVITES

READLINE

Notation readline

Initialisation de readline

Raccourcis clavier readline

Variables de readline

active-region-start-color

Une variable de chaîne qui contrôle la couleur du texte et du fond lors de l'affichage du texte dans la zone active (consultez la description de enable-active-region ci-dessous). Cette chaîne ne doit pas occuper l'emplacement d'un caractère physique quelconque sur l'affichage, aussi elle devrait consister uniquement en séquences d'échappement du terminal. Elle est envoyée au terminal avant l'affichage du texte dans la zone active. Cette variable est remise à sa valeur par défaut chaque fois que le type de terminal change. La valeur par défaut est la chaîne qui place le terminal en mode standout tel qu'obtenu à partir de la description terminfo du terminal. Cette valeur pourrait être par exemple "\e[01;33m".

active-region-end-color

Une variable de chaîne qui « annule » les effets de active-region-start-color et rétablit l'apparence « normale » de l'affichage du terminal après l'affichage de texte dans la zone active. Cette chaîne ne doit pas occuper l'emplacement d'un caractère physique quelconque sur l'affichage, aussi elle devrait consister uniquement en séquences d'échappement du terminal. Elle est envoyée au terminal après l'affichage du texte dans la zone active. Cette variable est remise à sa valeur par défaut chaque fois que le type de terminal change. La valeur par défaut est la chaîne qui rétablit le terminal à partir du mode standout tel qu'obtenu à partir de la description terminfo du terminal. Cette valeur pourrait être par exemple "\e[0m".

bell-style (audible)

Cette variable commande readline lorsqu'il faut déclencher l'alarme du terminal. Si configurée à none, readline n'émet jamais d'alarme. Si configurée à visible, readline utilise une alarme visuelle s'il y en a une disponible. Si configurée à audible, readline essaie de faire sonner l'alarme du terminal.

bind-tty-special-chars (On)

Si configurée à On, readline tente d'associer les caractères de contrôle traités spécialement par le pilote de terminal du noyau à leurs équivalents readline.

blink-matching-paren (Off)

Si configurée à On, readline tente de déplacer brièvement le curseur vers une parenthèse ouvrante lors de l'insertion d'une parenthèse fermante.

colored-completion-prefix (Off)

Si configurée à On, lors du listage des complètements, readline affiche le préfixe commun du jeu des complètements possibles en utilisant une couleur différente. Les définitions de couleur sont prises selon la valeur de la variable d’environnement LS_COLORS. S'il y a une définition de couleur dans $LS_COLORS pour le suffixe personnalisé « readline-colored-completion-prefix », readline utilise cette couleur pour le suffixe commun plutôt que la valeur par défaut.

colored-stats (Off)

Si configurée à On, readline affiche les complètements possibles en utilisant des couleurs différentes pour indiquer leur type de fichier. Les définitions de couleur sont prises dans la valeur de la variable d’environnement LS_COLORS.

comment-begin (« # »)

Cette chaîne est insérée quand la commande readline insert-comment est exécutée. Cette commande est associée à M-# en mode Emacs et à # en mode de commande vi.

completion-display-width (-1)

Le nombre de colonnes d'écran utilisées pour afficher de possibles correspondances lors de la réalisation du complètement. La valeur est ignorée si elle est inférieure à 0 ou supérieure à la largeur de l'écran du terminal. Une valeur de 0 fera que les correspondances seront affichées une par ligne. La valeur par défaut est  -1.

completion-ignore-case (Off)

Si configurée à On, readline effectue les correspondances et complètements de noms de fichiers sans tenir compte de la casse.

completion-map-case (Off)

Si configurée à On et completion-ignore-case activée, readline traite les traits d'union ( -) et les tirets bas (_) comme équivalents lorsqu'elle réalise une recherche de correspondance et un complètement de nom de fichier insensibles à la casse.

completion-prefix-display-length (0)

La longueur, en caractères, du préfixe commun d'une liste de complètements possibles affiché sans modification. Si configurée en valeur positive, les préfixes communs plus longs que cette valeur sont remplacés par une ellipse lors de l'affichage des complètements possibles.

completion-query-items (100)

Cela détermine quand l'utilisateur est interrogé pour voir le nombre de complètements possibles produits par la commande possible-completions. Elle peut être configurée à toute valeur entière positive. Si le nombre de complètements possibles est supérieur ou égal à la valeur de cette variable, readline demandera à l'utilisateur s'il veut ou non les voir ; sinon, ils sont simplement affichés sur le terminal. Une valeur zéro signifie que readline ne demandera jamais ; des valeurs négatives sont traitées comme un zéro.

convert-meta (On)

Si configurée à On, readline transformera les caractères avec leur huitième bit réglé à une suite de caractères ASCII en supprimant le huitième bit et en préfixant un caractère de protection (en fait, en utilisant le caractère de protection comme préfixe méta). La configuration par défaut est On, mais readline la fixe à Off si le paramètre linguistique régional contient des caractères 8 bits. Cette variable dépend du paramètre linguistique régional LC_CTYPE et peut être modifiée si le paramètre linguistique régional est changé.

disable-completion (Off)

Si configurée à On, readline empêchera le complètement des mots. Les caractères de complètement seront insérés sur la ligne comme s'ils avaient été associés à self-insert.

echo-control-characters (On)

Si configurée à On, sur les systèmes d'exploitation le permettant, readline affiche un caractère correspondant à un signal provenant du clavier.

editing-mode (emacs)

Commande si readline doit démarrer avec des raccourcis clavier similaires à Emacs ou à vi. editing-mode peut être positionné soit à emacs, soit à vi.

emacs-mode-string (@)

Si la variable show-mode-in-prompt est activée, cette chaîne est affichée immédiatement avant la dernière ligne de la première invite quand le mode édition d'Emacs est activé. La valeur est développée comme un raccourci clavier, donc le jeu standard de préfixes meta- ou Control- et de séquences de protections par contre-oblique est disponible. Utiliser les caractères de protection \1 et \2 pour ouvrir et fermer les séquences de caractères non imprimables, ce qui peut être utilisé pour inclure une suite de caractères de contrôle du terminal dans la chaîne de mode.

enable-active-region (On)

Le curseur (« point ») correspond à la position actuelle du curseur et la marque correspond à une position de curseur sauvegardée. Le texte entre le curseur et la marque est désigné comme la zone. Quand cette variable est réglée à On, readline permet à certaines commandes de désigner la zone comme active. Quand la zone est active, readline surligne le texte en utilisant la valeur de active-region-start-color qui est par défaut la chaîne qui active le mode standout du terminal. La région active montre le texte inséré par collage spécial ( bracketed-paste) et tout texte correspondant trouvé lors de recherches incrémentales et non-incrémentales dans l'historique.

enable-bracketed-paste (On)

Quand configurée à On, readline configurera le terminal pour pouvoir insérer chaque collage dans le tampon d'édition comme une chaîne de caractères uniques, plutôt que de traiter chaque caractère comme s'il avait été lu du clavier. Cela empêche readline d'exécuter toute commande d'édition liée à des suites de touches apparaissant dans le texte collé.

enable-keypad (Off)

Quand configurée à On, readline essayera d'activer le pavé numérique de l'application une fois appelée. Sur certains systèmes, c'est nécessaire pour utiliser les flèches.

enable-meta-key (On)

Quand configurée à On, readline essayera d'activer toutes les touches de modificateur Méta que le terminal peut prendre en charge une fois appelé. Sur de nombreux terminaux, la touche Méta est utilisée pour saisir des caractères sur huit bits.

expand-tilde (Off)

Si configurée à On, le développement du tilde est effectué lorsque readline tente un complètement de commandes.

history-preserve-point (Off)

Si configurée à On, le programme d'historique tente de placer le curseur au même endroit sur chaque ligne d'historique récupérée avec previous-history ou next-history.

history-size (unset)

Configure le nombre maximal d'éléments sauvegardés dans la file de l'historique. Si configuré à zéro, tous les éléments sont effacés et aucun nouvel élément n’est sauvegardé. Si configuré à une valeur strictement négative, le nombre d'éléments de la file d’historique n'est pas limité. Par défaut, le nombre d’éléments est configuré à la valeur de la variable HISTSIZE de l'interpréteur. En cas de tentative de régler history-size à une valeur non numérique, le nombre maximal d'éléments est configuré à 5OO.

horizontal-scroll-mode (Off)

Quand configurée à On, readline utilisera une seule ligne d'affichage et fera défiler la saisie horizontalement sur une seule ligne d'écran quand elle devient plus longue que la largeur de l'écran, plutôt que de faire un retour à la ligne. Ce réglage est activé automatiquement pour les terminaux de hauteur 1.

input-meta (Off)

Si configurée à On, readline acceptera des saisies sur huit bits (autrement dit il ne supprimera pas le huitième bit), quel que soit le terminal utilisé. Le nom meta-flag est un synonyme pour cette variable. La configuration par défaut est Off, mais readline la fixe à On si le paramètre linguistique régional contient des caractères 8 bits. Cette variable dépend du paramètre linguistique régional LC_CTYPE et peut être modifiée si le paramètre linguistique régional est changé.

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

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

keymap (emacs)

Configure le jeu de raccourcis readline actuel. L'ensemble des noms corrects de jeux de raccourcis est emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command et vi-insert. vi est équivalent à vi-command ; emacs est équivalent à emacs-standard. La valeur par défaut est emacs ; la valeur de editing-mode modifie aussi le jeu de raccourcis par défaut.

keyseq-timeout (500)

Indique le temps que readline attendra un caractère lors de la lecture d’une suite de touches ambiguë (c’est-à-dire qui peut former une suite de touches complète en utilisant l’entrée lue jusqu’à présent, ou accepter une entrée supplémentaire pour compléter une suite de touches plus longue). Si aucune entrée n’est reçue pendant le temps d’attente, readline utilisera la suite la plus courte, mais complète. La valeur est indiquée en milliseconde, donc une valeur de 1000 signifie que readline attendra pendant une seconde une entrée supplémentaire. Si cette variable est configurée à une valeur inférieure ou égale à zéro, ou à une valeur non numérique, readline attendra la saisie d’une autre touche pour décider de la suite de touches à compléter.

mark-directories (On)

Si configurée à On, une barre oblique est ajoutée aux noms de répertoires.

mark-modified-lines (Off)

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

mark-symlinked-directories (Off)

Si configurée à On, une barre oblique est ajoutée aux noms complétés si ce sont des liens symboliques vers des répertoires (selon la valeur de mark-directories).

match-hidden-files (On)

Cette variable, quand elle est configurée à On, conduit readline à faire correspondre des fichiers dont le nom commence par un « . » (fichiers cachés) lors du complètement de noms de fichiers. Si configurée à Off, le « . » du début doit être fourni par l'utilisateur dans le nom de fichier à compléter.

menu-complete-display-prefix (Off)

Si configurée à On, le complètement de menu affiche le préfixe commun à la liste de complètements possibles (qui peut être vide) avant de tourner dans la liste.

output-meta (Off)

Si configurée à On, readline affichera directement les caractères ayant leur huitième bit défini plutôt que d'utiliser une suite de caractères de protection avec préfixe méta. La configuration par défaut est Off, mais readline la fixe à On si le paramètre linguistique régional contient des caractères 8 bits. Cette variable dépend du paramètre linguistique régional LC_CTYPE et peut être modifiée si le paramètre linguistique régional est changé.

page-completions (On)

Si configurée à On, readline utilise un afficheur de texte interne du type more pour afficher les complètements possibles sur un seul plein écran.

print-completions-horizontally (Off)

Si configurée à On, readline affichera les complètements correspondants triés horizontalement dans l'ordre alphabétique plutôt que verticalement.

revert-all-at-newline (Off)

Si configurée à On, readline annulera toutes les modifications des lignes d'historique avant de s'arrêter quand accept-line est exécuté. Par défaut les lignes d'historique peuvent être modifiées et conservent les listes d'annulation individuelles au fur et à mesure des appels à readline.

show-all-if-ambiguous (Off)

Cela modifie le comportement par défaut des fonctions de complètement. Si configurée à On, les mots qui ont plus d'un complètement possibles conduisent à l'affichage immédiat des correspondances plutôt qu'à l'émission d'une alarme.

show-all-if-unmodified (Off)

Cela modifie le comportement par défaut des fonctions de complètement de façon similaire à show-all-if-ambiguous. Si configurée à On, les mots qui ont plus d'un complètement possible sans aucun complètement partiel possible (les complètements possibles ne partagent pas de préfixe commun) conduisent à l'affichage immédiat des correspondances plutôt qu'à l'émission d'une alarme.

show-mode-in-prompt (Off)

Si configurée à On, ajoute une chaîne au début de l’invite indiquant le mode d’édition : Emacs, commande Vi ou insertion Vi. L'utilisateur peut configurer la chaîne de mode (par exemple, emacs-mode-string).

skip-completed-text (Off)

Si configurée à On, modifie le comportement par défaut du complètement lors de l'insertion d'une unique correspondance dans la ligne. Elle n'est utilisée que lors d'un complètement effectué au milieu d'un mot. Si elle est activée, readline n'insère pas de caractères de complètement correspondant à des caractères situés après le curseur dans le mot en train d'être complété, ainsi les parties du mots situées après le curseur ne sont pas dupliquées.

vi-cmd-mode-string ((cmd))

Si la variable show-mode-in-prompt est activée, cette chaîne est affichée immédiatement avant la dernière ligne de la première invite quand le mode d'édition de vi est activé et en mode commande. La valeur est développée comme un raccourci clavier, donc le jeu standard de préfixes meta- ou Control- et de séquences de protections par contre-oblique est disponible. Utiliser les caractères de protection \1 et \2 pour ouvrir et fermer les séquences de caractères non imprimables, ce qui peut être utilisé pour inclure une suite de caractères de contrôle du terminal dans la chaîne de mode.

vi-ins-mode-string ((ins))

Si la variable show-mode-in-prompt est activée, cette chaîne est affichée immédiatement avant la dernière ligne de la première invite quand le mode d'édition de vi est activé et en mode insertion. La valeur est développée comme un raccourci clavier, donc le jeu standard de préfixes meta- ou Control- et de séquences de protections par contre-oblique est disponible. Utiliser les caractères de protection \1 et \2 pour ouvrir et fermer les séquences de caractères non imprimables, ce qui peut être utilisé pour inclure une suite de caractères de contrôle du terminal dans la chaîne de mode.

visible-stats (Off)

Si configurée à On, un caractère indiquant le type de fichier, comme signalé par stat(2) est ajouté aux noms de fichiers en affichant les complètements possibles.

Constructions conditionnelles de readline

$if

La structure $if permet de choisir les raccourcis selon le mode d'édition, le terminal utilisé ou l'application utilisant readline. Le texte du test, après n’importe quel opérateur de comparaison, va jusqu'à la fin de la ligne ; sauf notation contraire, aucun caractère n'est nécessaire pour le délimiter.

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

$endif

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

$else

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

$include

Cette directive prend un seul nom de fichier comme argument et y lit les commandes et les raccourcis. Par exemple, la directive suivante lirait le fichier /etc/inputrc :

$include  /etc/inputrc

Recherche

Noms des commandes readline

Commandes de déplacement

beginning-of-line (C-a)

Reculer au début de la ligne actuelle.

end-of-line (C-e)

Avancer à la fin de la ligne.

forward-char (C-f)

Avancer d'un caractère.

backward-char (C-b)

Reculer d'un caractère.

forward-word (M-f)

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

backward-word (M-b)

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

shell-forward-word

Avancer jusqu'à la fin du mot suivant. Les mots sont séparés par des métacaractères non protégés de l'interpréteur.

shell-backward-word

Reculer jusqu'au début du mot actuel ou du précédent. Les mots sont séparés par des métacaractères non protégés de l'interpréteur.

previous-screen-line

Tenter de déplacer le curseur vers la même colonne physique de l'écran sur la ligne physique précédente de l'écran. Cela n'aura pas l'effet désiré si la ligne actuelle de readline n'accepte pas sur d'une ligne physique ou si le but n'est pas supérieur à la longueur de l'invite plus la largeur de l'écran.

next-screen-line

Tenter de déplacer le curseur vers la même colonne de l'écran physique sur la ligne suivante de l'écran physique. Cela n'aura pas l'effet désiré si la ligne actuelle de readline n'accepte pas plus d'une ligne physique ou si la longueur de la ligne actuelle de readline n'est pas supérieure à la longueur de l'invite plus la largeur de l'écran.

clear-display (M-C-l)

Effacer l'écran et, si possible, le tampon de défilement du terminal, puis rafraîchir la ligne actuelle, en laissant la ligne actuelle au sommet de l'écran.

clear-screen (C-l)

Effacer l'écran, puis rafraîchir la ligne actuelle, en laissant la ligne actuelle au sommet de l'écran. S'il y a un argument, rafraîchir la ligne actuelle sans effacer l'écran.

redraw-current-line

Rafraîchir la ligne actuelle.

Commandes de manipulation de l'historique

accept-line (changement de ligne, retour chariot)

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

previous-history (C-p)

Récupérer la commande précédente de la file d'historique, en remontant dans la file.

next-history (C-n)

Récupérer la commande suivante dans la file d'historique, en descendant dans la file.

beginning-of-history (M-<)

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

end-of-history (M->)

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

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

Valider la ligne actuelle pour exécution et récupérer de l'historique la ligne suivante liée à la ligne actuelle pour édition. Si un argument numérique est fourni, il spécifie l'entrée de l'historique à utiliser à la place de la ligne actuelle.

fetch-history

Avec argument numérique, récupérer cette entrée de la file d'historique et en faire la ligne actuelle. Sans argument, revenir à la première entrée de la file d'historique.'

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 pour une chaîne fournie par l'utilisateur.

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

Rechercher une chaîne en avant dans l'historique, utiliser une recherche non incrémentale pour une chaîne fournie par l'utilisateur.

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. C'est une recherche non incrémentale.

history-search-backward

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

history-substring-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. La chaîne recherchée peut trouver une correspondance n'importe où dans une ligne de l'historique. C'est une recherche non incrémentale.

history-substring-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. La chaîne recherchée peut trouver une correspondance n'importe où dans une ligne de l'historique. C'est une recherche non incrémentale.

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

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

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

Insérer le dernier argument de la commande précédente (le dernier mot de l'élément précédent de la file d'historique). Avec un argument numérique, se comporte exactement comme yank-nth-arg. Les appels successifs à yank-last-arg remontent dans la file d'historique en insérant le dernier mot (ou le mot indiqué par l'argument du premier appel) de chaque ligne tour à tour. Tous les arguments numériques fournis à ces appels successifs déterminent la direction de déplacement dans l'historique. Un argument négatif modifie la direction dans l'historique (en avant ou en arrière). Les outils de développement d'historique sont utilisés pour extraire le dernier mot, comme si le développement d'historique « !$ » avait été indiqué.

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

Développer, comme le fait l'interpréteur, la ligne actuelle. Cela effectue le développement des alias et d'historique, ainsi que tous les développements de mot de l'interpréteur. Consultez ci-dessous DÉVELOPPEMENT DE L'HISTORIQUE, pour une description détaillée du développement de l'historique.

history-expand-line (M-^)

Effectuer le développement d'historique sur la ligne actuelle. Consultez ci-dessous DÉVELOPPEMENT DE L'HISTORIQUE, pour une description détaillée.

magic-space

Effectuer le développement de l'historique sur la ligne actuelle et insérer une espace. Consultez ci-dessous DÉVELOPPEMENT DE L'HISTORIQUE, pour une description détaillée.

alias-expand-line

Effectuer le développement des alias sur la ligne actuelle. Consultez ALIAS ci-dessus pour une description des développements d'alias.

history-and-alias-expand-line

Effectuer le développement de l'historique et des alias sur la ligne actuelle.

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

Un synonyme de yank-last-arg.

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

Appeler un éditeur sur la ligne de commande actuelle et exécuter le résultat comme une commande d'interpréteur. Bash tente d'appeler, dans cet ordre, $VISUAL, $EDITOR et emacs comme éditeur.

Commande d'édition de texte

end-of-file (généralement C-d)

Le caractère indiquant la fin de fichier, comme défini, par exemple, par ``stty''. Si ce caractère est lu alors qu’aucun caractère n’est sur la ligne, et que le curseur est au début de la ligne, readline l’interprète comme le fin de l’entrée et renvoie EOF.

delete-char (C-d)

Effacer le caractère sous le curseur. Si cette fonction est associée au même caractère que le caractère EOF du terminal, comme c’est souvent le cas avec C-d, consultez les effets dans le paragraphe précédent.

backward-delete-char (Effacement ou « Rubout »)

Effacer le caractère avant le curseur. Lorsque un argument numérique est indiqué, le texte effacé est sauvegardé dans le tampon circulaire.

forward-backward-delete-char

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

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

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

tab-insert (C-v TAB)

Insérer un caractère de tabulation.

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

Insérer le caractère mentionné.

transpose-chars (C-t)

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

transpose-words (M-t)

Déplace le mot avant le curseur au-delà du mot après le curseur et déplace aussi le curseur sur ce mot. Si le curseur est à la fin de la ligne, cela échange les deux derniers mots de la ligne.

upcase-word (M-u)

Transformer le mot actuel (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 actuel (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 actuel (ou du suivant). Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

overwrite-mode

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

Effacement et récupération

kill-line (C-k)

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

backward-kill-line (C-x Effacement)

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 la position du curseur. Le texte est sauvegardé dans le tampon circulaire.

kill-whole-line

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

kill-word (M-d)

Effacer le texte entre le curseur et la fin du mot actuel ou, si entre des mots, jusqu'à la fin du mot suivant. Les limites des mots sont identiques à celles utilisées par forward-word.

backward-kill-word (M-Effacement)

Effacer le mot sous le curseur. Les limites de mots sont identiques à celles utilisées par backward-word.

shell-kill-word

Effacer le texte entre le curseur et la fin du mot actuel ou, si entre des mots, jusqu'à la fin du mot suivant. Les limites des mots sont identiques à celles utilisées par shell-forward-word.

shell-backward-kill-word

Effacer le mot sous le curseur. Les limites de mots sont identiques à celles utilisées par shell-backward-word.

unix-word-rubout (C-w)

Effacer le mot sous le curseur, en utilisant une espace blanche comme limite de mot. Le texte effacé est sauvegardé dans le tampon circulaire.

unix-filename-rubout

Effacer le mot sous le curseur, en utilisant l'espace blanche et la barre oblique comme limites de mot. Le texte supprimé est sauvegardé dans le tampon circulaire.

delete-horizontal-space (M-\)

Effacer toutes les espaces blanches et les tabulations autour du curseur.

kill-region

Effacer le texte de la zone actuelle.

copy-region-as-kill

Copier le texte de la zone vers le tampon circulaire.

copy-backward-word

Copier le mot précédant le curseur dans le tampon circulaire. Les limites de mots sont identiques à celles de backward-word.

copy-forward-word

Copier le mot suivant le curseur dans le tampon circulaire. Les limites de mots sont identiques à celles de forward-word.

yank (C-y)

Récupérer le texte au sommet du tampon circulaire à la position du curseur dans le tampon.

yank-pop (M-y)

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

Arguments numériques

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

Ajouter ce chiffre à l'argument en cours de rédaction ou créer un nouvel argument. M-- crée un argument négatif.

universal-argument

Il s'agit d'une autre façon d'indiquer un argument. Si cette commande est suivie d'un ou plusieurs chiffres facultativement précédés d'un signe moins, ces chiffres définissent l'argument. Si la commande est suivie de chiffres, une nouvelle exécution de universal-argument termine l'argument numérique, mais est ignorée dans les autres cas. Par exception, si cette commande est suivie immédiatement par un caractère qui n'est ni un chiffre ni le signe moins, le compteur d'arguments de la commande suivante est multiplié par 4. Le compteur d'arguments est initialement à un, donc la première exécution de cette commande amène le compteur d'arguments à quatre, une seconde fois porte le compteur d'arguments à seize et ainsi de suite.

Complètement

complete (TAB)

Essayer d'effectuer un complètement du texte situé avant le curseur. Bash effectue le complètement en considérant tour à tour le texte comme une variable (s'il commence par $), un nom d'utilisateur (s'il commence par ~), un nom de machine (s'il commence par @) ou une commande (y compris les alias et les fonctions). Si aucun ne correspond, un complètement de nom de fichier est essayé.

possible-completions (M-?)

Afficher les complètements possibles pour le texte situé avant le curseur.

insert-completions (M-*)

Insérer avant le curseur l'ensemble des complètements qui auraient été produits par possible-completions.

menu-complete

Analogue à complete, mais en remplaçant le mot à compléter par une seule correspondance de la liste des complètements possibles. Des exécutions répétées de menu-complete parcourent la liste des complètements possibles, en insérant chaque correspondance tour à tour. À la fin de la liste des complètements, une alarme est émise (selon la configuration de bell-style) et le texte original est restauré. Un argument de n déplace de n positions dans la liste des correspondances. Un argument négatif peut être utilisé pour revenir en arrière dans la liste. Cette commande est destinée à être associée à la touche TAB, mais ne l'est pas par défaut.

menu-complete-backward

Identique à menu-complete, mais se déplace en arrière dans la liste des complètements possibles, comme si un argument négatif avait été passé à menu-complete. Cette commande n'est associée à aucune touche par défaut.

delete-char-or-list

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

complete-filename (M-/)

Essayer le complètement des noms de fichiers sur le texte situé avant le curseur.

possible-filename-completions (C-x /)

Afficher les complètements possibles du texte situé avant le curseur, traité comme un nom de fichier.

complete-username (M-~)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme un nom d'utilisateur.

possible-username-completions (C-x ~)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme un nom d'utilisateur.

complete-variable (M-$)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme une variable de l'interpréteur.

possible-variable-completions (C-x $)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme une variable de l'interpréteur.

complete-hostname (M-@)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme un nom de machine.

possible-hostname-completions (C-x @)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme un nom de machine.

complete-command (M-!)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme un nom de commande. Le complètement des commandes essaie de faire correspondre le texte, dans cet ordre, aux alias, mots réservés, fonctions de l'interpréteur, commandes internes de l'interpréteur et finalement les noms de fichiers exécutables.

possible-command-completions (C-x !)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme un nom de commande.

dynamic-complete-history (M-TAB)

Essayer le complètement du texte situé avant le curseur, en le comparant aux lignes de la file d'historique lui correspondant pour les complètements possibles.

dabbrev-expand

Essayer le menu de complètement du texte situé avant le curseur, en le comparant aux lignes de la file d'historique lui correspondant pour les complètements possibles.

complete-into-braces (M-{)

Effectuer un complètement en noms de fichiers et insérer la liste des complètements possibles entre accolades afin que la liste soit exploitable par l'interpréteur (consultez Développement des accolades ci-dessus).

Macros clavier

start-kbd-macro (C-x ()

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

end-kbd-macro (C-x ))

Arrêter la mémorisation dans la macro en cours des caractères saisis et conserver la définition.

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

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

print-last-kbd-macro ()

Afficher la dernière macro de clavier définie, mise en forme de façon à être incorporée dans un fichier inputrc.

Divers

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

Lire le contenu du fichier inputrc et prendre en compte tous raccourcis ou affectations de variables qui s'y trouvent.

abort (C-g)

Abandonner l'édition en cours et émettre une alarme de terminal (selon la configuration de la variable bell-style).

do-lowercase-version (M-A, M-B, M-x, ...)

Si le caractère x précédé de Méta est en majuscule, exécuter la commande qui est associée aux caractères minuscules correspondants. Le comportement est non défini si x est déjà en minuscule.

prefix-meta (ESC)

Considérer le prochain caractère saisi comme un Méta. ESC f est équivalent à Meta-f.

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

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

revert-line (M-r)

Annuler toutes les modifications sur cette ligne. C’est équivalent à répéter undo suffisamment de fois pour ramener la ligne à son état initial.

tilde-expand (M-&)

Effectuer le développement du tilde sur le mot actuel.

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

Placer la marque à la position actuelle du curseur. Si un argument numérique est fourni, la marque est posée à la position correspondante.

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

Échanger le curseur et la marque. La position actuelle du curseur est configurée à la position sauvegardée précédemment et l'ancienne position du curseur est mémorisée comme la marque.

character-search (C-])

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

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

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

skip-csi-sequence

Lire suffisamment de caractères pour englober une suite multitouche comme celles définies pour des touches comme Début et Fin. De telles suites commencent par un indicateur de suite de contrôle (« control sequence indicator » ou CSI), habituellement ESC-[. Si cette suite est associée à "\[", les touches qui produisent de telles suites n'auront pas d'effet à moins d'être explicitement associées à une commande readline, au lieu d'insérer des caractères parasites dans le tampon d'édition. N'est associée à aucune touche par défaut, mais est souvent associée à ESC-[.

insert-comment (M-#)

Sans argument numérique, la valeur de la variable comment-begin de readline est insérée au début de la ligne actuelle. Si un argument numérique est fourni, cette commande agit comme une bascule : si les caractères du début de ligne ne correspondent pas à la valeur de comment-begin, la valeur est insérée, sinon, les caractères de comment-begin sont effacés du début de la ligne. Dans les deux cas, la ligne est acceptée comme si un changement de ligne avait été saisi. La valeur par défaut de comment-begin conduit cette commande à transformer la ligne actuelle de l'interpréteur en commentaire. Si un argument numérique conduit à l'effacement du caractère de commentaire, la ligne sera exécutée par l'interpréteur.

spell-correct-word (C-x s)

Effectuer la correction orthographique sur le mot actuel, en le traitant comme un répertoire ou un nom de fichier, de la même manière que l'option de l'interpréteur cdspell. Les limites des mots sont identiques à celles utilisées par shell-forward-word.

glob-complete-word (M-g)

Le mot avant le curseur est traité comme un motif pour un développement de chemin, avec un astérisque implicitement ajouté. Ce motif est utilisé pour produire une liste de noms de fichiers correspondants pour de possibles complètements.

glob-expand-word (C-x *)

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

glob-list-expansions (C-x g)

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

dump-functions

Afficher toutes les fonctions et leurs raccourcis clavier sur le flux de sortie de readline. Si un argument numérique est fourni, la sortie est mise en forme de façon à être incorporée dans un fichier inputrc.

dump-variables

Afficher toutes les variables readline modifiables et leurs valeurs sur le flux de sortie de readline. Si un argument numérique est fourni, la sortie est mise en forme de façon à être incorporée dans un fichier inputrc.

dump-macros

Afficher toutes les suites de touches readline associées à des macros et les chaînes auxquelles elles correspondent. Si un argument numérique est fourni, la sortie est mise en forme de façon à être incorporée dans un fichier inputrc.

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

Afficher des informations sur la version actuelle de bash.

Complètement programmable

HISTORIQUE

DÉVELOPPEMENT DE L'HISTORIQUE

Indicateur d'événement

!

Débute une substitution d'historique, sauf s'il est suivi par un blanc, changement de ligne, retour chariot, = ou ( (lorsque l'option d'interpréteur extglob est activée en utilisant la commande interne shopt).

!n

Se rapporte à la ligne de commande n.

!-n

Se rapporte à la commande actuelle moins n.

!!

Se rapporte à la commande précédente. C'est un synonyme de « !-1 ».

!chaîne

Se rapporte à la commande la plus récente précédant la position actuelle dans la file d'historique commençant par chaîne.

!?chaîne[?]

Se rapporte à la commande la plus récente précédant la position actuelle dans la file d'historique contenant chaîne. Le ? final peut être omis si chaîne est immédiatement suivie d'un changement de ligne. Si chaîne est absente, la chaîne de la dernière recherche est utilisée ; c'est une erreur s'il n'y a pas de chaîne de recherche précédente.

^chaîne_1^chaîne_2^

Substitution rapide. Répéter la commande précédente en remplaçant chaîne_1 par chaîne_2. Équivalent à «  !!:s^ chaîne_1^chaîne_2^ » (consultez Modificateurs ci-dessous).

!#

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

Indicateurs de mots

0 (zéro)

Le zéroième mot. Pour l'interpréteur, c'est le nom de la commande.

n

Le n-ième mot.

^

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

$

Le dernier mot. C’est généralement le dernier argument, mais qui sera développé en zéroième mot s’il n’y a qu’un seul mot sur la ligne.

%

Le premier mot correspondant à la recherche « ? chaîne? » la plus récente, si la chaîne de recherche débute par un caractère qui fait partie d'un mot.

x-y

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

*

Tous les mots sauf le zéroième. C'est un synonyme pour «  1-$ ». Il n'est pas erroné d'utiliser * s'il n'y a qu'un mot dans l'événement ; la chaîne vide est renvoyée dans ce cas.

x*

Abréviation de x-$.

x-

Abréviation de x-$ comme x*, mais sans le dernier mot. Si x est absent, la valeur par défaut est 0.

Modificateurs

h

Éliminer la fin du chemin d'accès, en ne gardant que le début.

t

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

r

Supprimer un suffixe final de la forme .xxx, en ne gardant que le nom de base.

e

Supprimer tout sauf le suffixe final.

p

Afficher la nouvelle commande sans l'exécuter.

q

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

x

Protéger les mots substitués comme avec q, mais avec séparation des mots aux blancs et changements de ligne. Les modificateurs q et x s'excluent mutuellement ; le dernier fourni est utilisé.

s/ancien/nouveau/

Remplacer par nouveau la première occurrence de ancien sur la ligne d'événement. Tout caractère peut être utilisé comme délimiteur à la place de /. Le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événement. Le délimiteur peut être protégé dans ancien et nouveau avec une seule contre-oblique. Si & apparaît dans nouveau, il est remplacé par ancien. Une seule contre-oblique protégera le &. Si ancien est NULL, il est configuré au dernier ancien substitué ou si aucune substitution n'a eu lieu précédemment, à la dernière chaîne dans une recherche !?chaîne[?]. Si nouveau est NULL, chaque correspondance à ancien est supprimée.

&

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

g

Appliquer les modifications sur toute la ligne d'événements. C'est utilisé conjointement à «  :s » (par exemple «  :gs/ancien/nouveau/ ») ou «  :& ». Si utilisé avec «  :s », tout délimiteur peut être utilisé à la place de / et le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événements. Un a peut être utilisé en tant que synonyme de g.

G

Appliquer une fois le modificateur « s » ou «  & » suivant à tous les mots de la ligne d'événement.

COMMANDES INTERNES DE L'INTERPRÉTEUR

: [arguments]

Sans effet ; cette commande ne fait rien d'autre que développer les arguments et effectuer toute redirection indiquée. L'état renvoyé est 0.

. fichier [arguments]

source fichier [arguments]

Lire et exécuter les commandes du fichier dans l'environnement de l'interpréteur actuel, puis renvoyer l'état final de la dernière commande exécutée depuis fichier. Si le nom du fichier ne contient pas de barre oblique, les chemins d'accès contenus dans PATH sont parcourus pour rechercher le répertoire contenant le fichier, mais le fichier n'a pas besoin d'être exécutable. Lorsqu'il est recherché dans PATH le fichier n'a pas besoin d'être exécutable. Lorsque bash n'est pas en mode POSIX, il examine le répertoire de travail actuel si aucun fichier n'est trouvé dans PATH. Si l'option sourcepath de la commande interne shopt est désactivée, le PATH n'est pas parcouru. Si des arguments sont fournis, ils sont transmis dans les paramètres positionnels lorsque le fichier est exécuté. Sinon les paramètres positionnels ne sont pas modifiés. Si l'option -T est activée, . hérite de toutes les captures de DEBUG ; si elle ne l'est pas, toutes les chaînes de capture de DEBUG sont sauvegardées et restaurées autour de l'appel à ., et détruit les captures de DEBUG lors de son exécution. Si -T n'existe pas et si le fichier venant de la source modifie la capture de DEBUG, la nouvelle valeur est conservée quand . se termine. L'état renvoyé est l'état de la dernière commande terminée au sein du script ( 0 si aucune commande n'a été exécutée) et faux si le fichier n'est pas trouvé ou ne peut être lu.

alias [-p] [nom[=valeur] ...]

La commande alias sans argument ou avec l'option -p affiche sur la sortie standard la liste des alias actuellement définis, sous la forme nom=valeur. Lorsque des arguments sont fournis, un alias est créé pour chaque nom auquel on a donné une valeur. Une espace finale dans une valeur conduira à la recherche d'alias dans le mot suivant lors du développement de l'alias. Pour tous les noms sans valeur fournie dans la liste d'arguments, le nom et la valeur de l'alias sont affichés. La commande alias renvoie vrai, à moins qu'un nom n'ait été indiqué pour lequel aucun alias n'a été défini.

bg [tâche ...]

Reprendre en arrière-plan chaque tâche suspendue, comme si elle avait été lancée avec &. Si aucune tâche n'est précisée, la notion d'interpréteur de tâche actuelle est utilisée. bg tâche renvoie 0 sauf si le contrôle des tâches est désactivé, ou, quand le contrôle des tâches est activé, si une tâche précisée n'a pas été trouvée ou a été lancée sans contrôle de tâches.

bind [-m jeu_de_raccourcis] [-lpsvPSVX]

bind [-m jeu_de_raccourcis] [-q fonction] [-u fonction] [-r suite_de_touches]

bind [-m jeu_de_raccourcis] -f fichier

bind [-m jeu_de_raccourcis] -x suite_de_touches:commande_de_l'interpréteur

bind [-m jeu_de_raccourcis] suite_de_touches: nom_de_fonction

bind [-m jeu_de_raccourcis] suite_de_touches: commande_readline

bind readline-command-line

Afficher les associations de touches readline actuelles et les raccourcis de fonctions, associer une suite de touches à une fonction ou une macro readline ou créer une variable readline. Chaque argument qui n'est pas une option est une commande comme elle devrait apparaître dans un fichier d'initialisation de readline comme .inputrc, mais chaque raccourci ou commande doit être fourni comme un argument indépendant ; par exemple « "\C-x\C-r": re-read-init-file ». Les options, si fournies, ont les significations suivantes :

break [n]

Sortir d'une boucle for, while, until ou select. Si n est indiqué, sortir de n niveaux de boucles. n doit être ≥ 1. Si n est supérieur au nombre de boucles imbriquées, sortir de toutes les boucles. La valeur renvoyée est 0, à moins que n ne soit pas supérieur ou égal à 1.

builtin commande_interne [arguments]

Exécuter la commande interne de l'interpréteur indiquée, en lui passant les arguments, puis renvoyer son état final. C'est utile lorsqu'une fonction est définie avec le même nom qu'une commande interne, et que cette commande est appelée depuis l'intérieur de la fonction. La commande interne cd est souvent redéfinie de cette façon. L'état renvoyé est faux si la commande_interne n'est pas une commande interne de l'interpréteur.

caller [expr]

Renvoyer le contexte de tout appel de sous-programme actif (une fonction de l'interpréteur ou un script lancé avec les commandes internes . ou source). Sans expr, caller affiche le numéro de ligne et le nom de fichier du sous-programme actuel. Si un entier positif est fourni comme expr, caller affiche le numéro de ligne, le nom du sous-programme et le nom de fichier source correspondant à la position dans la pile d'appels d'exécution actuelle. Cette information supplémentaire peut être utilisée, par exemple, pour afficher une trace de la pile. La trame actuelle est la trame 0. La valeur renvoyée est 0, à moins que l'interpréteur ne soit pas en train d'exécuter un sous-programme ou que expr ne corresponde pas à une position correcte dans la pile d'appels.

cd [-L|[-P [-e]] [-@]] [rép]

Remplacer le répertoire de travail actuel par rép. Si rép n’est pas fourni, la valeur de la variable d’interpréteur HOME est la valeur par défaut. La variable CDPATH définit des chemins de recherche pour trouver le répertoire contenant rép : tous les noms de répertoire contenus dans CDPATH sont parcourus à la recherche de rép. Les répertoires possibles y sont fournis dans une liste séparés par des deux-points «  : ». Un nom de répertoire NULL dans CDPATH est équivalent au répertoire actuel, c'est-à-dire «  . ». Si rép commence par une barre oblique ( /), alors CDPATH n'est pas utilisé. L'option -P force cd à n'employer que la structure de répertoires physiques en résolvant les liens symboliques en traversant rép et avant de traiter les instances de .. dans rép (consultez aussi l'option -P de la commande interne set) ; l'option -L force à suivre les liens symboliques en résolvant les liens symboliques après le traitement des instances de .. dans rép. Si .. apparaît dans rép, il est traité en supprimant le composant de chemin précédant directement rép, jusqu’à une barre oblique ou le début de rép. Si l'option -e est fournie avec -P, et que le répertoire de travail actuel ne peut pas être déterminé avec succès après un changement de répertoire avec succès, cd renverra un état d'échec. Sur les systèmes qui le permettent, l’option -@ présente les attributs étendus associés à un fichier comme à un répertoire. Un argument - est converti en $OLDPWD avant d’essayer un changement de répertoire. Si un nom de répertoire non vide de CDPATH est utilisé ou si - est le premier argument et si le changement de répertoire réussit, le chemin absolu du nouveau répertoire de travail est écrit sur la sortie standard. Si le changement de répertoire réussit, cd définit la valeur de la variable d'environnement PWD au nom du nouveau répertoire et règle la variable d'environnement OLDPWD à celle du répertoire de travail en cours avant le changement. La valeur renvoyée est vrai si le changement de répertoire a réussi, faux sinon.

command [-pVv] commande [arguments ...]

Exécuter la commande avec les arguments indiqués, mais en supprimant le processus habituel de recherche des commandes. Seules les commandes internes ou les commandes trouvées dans PATH seront exécutées. Si l'option -p est indiquée, la recherche de la commande est effectuée en utilisant une valeur par défaut pour PATH garantissant de trouver tous les utilitaires standards. Si l'option -V ou -v est fournie, une description de la commande est affichée. L'option -v conduit à n'afficher qu'un seul mot indiquant la commande ou le nom de fichier utilisé pour appeler la commande. L'option -V fournit une description plus prolixe. Si l'option -V ou -v est fournie, l'état final est 0 si la commande a été trouvée et 1 sinon. Si aucune option n'est fournie et si une erreur s'est produite ou si la commande ne peut être trouvée, l'état final est 127. Sinon, l'état final de la command interne est l'état final de commande.

compgen [option] [mot]

Produire les correspondances des complètements possibles pour mot selon les options, qui peuvent être toute option acceptée par la commande interne complete à l'exception de -p et -r et écrit le résultat sur la sortie standard. Lorsqu'on utilise les options -F ou -C, les diverses variables de l'interpréteur créées par les outils de complètement programmables, lorsque disponibles, n'auront pas de valeurs utilisables. Les correspondances seront produites de la même façon que si le programme de complètement programmable les avait produites directement à partir d'une spécification de complètement avec les mêmes attributs. Si mot est indiqué, seuls les complètements qui correspondent à mot sont affichés. La valeur renvoyée est vrai, sauf si une option incorrecte a été fournie ou si aucune correspondance n'a été produite.

complete [-abcdefgjksuv] [-o option-complètement] [ -DEI] [-A action] [ -G globpat] [-W liste_de_mots]

 

[ -F fonction] [-C commande] [-X motif_filtre] [ -P préfixe] [-S suffixe] nom [nom ...]

complete -pr [-DEI] [nom ...]

Indiquer la façon de compléter les arguments de chaque nom. Si l'option -p est fournie ou si aucune option n'est fournie, les spécifications de complètement existantes sont affichées de telle façon qu'elles puissent être réutilisées comme entrée. L'option -r retire une spécification de complètement à chaque nom fourni ou, si aucun nom n'est fourni, toutes les spécifications de complètement. L'option -D indique que les options restantes et les actions devraient s'appliquer au complètement de commande par « défaut », c'est-à-dire le complètement essayé sur une commande pour laquelle aucun complètement n'a été préalablement défini. L'option -E indique que les options restantes et les actions devraient s'appliquer au complètement de commande « vide », c'est-à-dire le complètement essayé sur une ligne vide. L'option -I indique que les options restantes et les actions devraient s'appliquer au complètement du premier mot de non affectation de la ligne ou après un délimiteur de commande ; ou |, ce qui est habituellement le complètement d'un nom de commande. Si plusieurs options sont fournies, l'option -D prend la préséance sur -E et les deux prennent la préséance sur -I. Si une des -options -D, -E ou -I est fournie, tous les autres arguments de nom sont ignorés ; ces complètements ne s'appliquent qu'au cas précisé par l'option. Le processus d'application de ces spécifications de complètement, lorsqu'un complètement de mot est tenté, est décrit above under Programmable Completion. Les autres options, si indiquées, ont les significations suivantes. Les arguments des options -G, -W et -X (et, si nécessaire, les options -P et -S) devraient être protégées pour éviter leur développement avant que la commande interne complete ne soit appelée.

compopt [-o option] [-DEI] [+o option] [nom]

Modifier les options de complètement pour chaque nom en fonction des options, ou pour le complètement en cours d'exécution si aucun nom n'est fourni. Si aucune option n'est donnée, afficher les options de complètement pour chaque nom ou pour le complètement actuel. Les valeurs d’options possibles sont celles décrites ci-dessus pour la commande interne complete. L'option -D indique que les options restantes devraient s'appliquer à la commande de complètement par « défaut » ; c'est-à-dire le complètement essayé sur une commande pour laquelle aucun complètement n'a été préalablement défini. L'option -E indique que les options fournies devraient s'appliquer au complètement de commande « vide » ; c'est-à-dire le complètement essayé sur une ligne vide. L'option I indique que les options fournies restantes devraient s'appliquer au complètement du premier mot de non affectation de la ligne ou après un délimiteur de commande ; ou |, ce qui est habituellement le complètement d'un nom de commande. La valeur renvoyée est vrai, à moins qu'une option incorrecte ait été fournie, qu'une tentative ait été faite pour modifier les options pour un nom pour lequel il n'existe pas de spécification de complètement, ou bien qu'une erreur de sortie soit survenue.

continue [n]

Reprendre l'exécution à l'itération suivante d'une boucle for, while, until ou encore select. Si n est indiqué, reprendre l'exécution à la n-ième boucle imbriquée. n doit être ≥ 1. Si n est supérieur au nombre de boucles imbriquées, l'exécution reprend à la boucle la plus externe (la boucle « au sommet »). La valeur renvoyée est 0, à moins que n ne soit supérieur ou égal à 1.

declare [-aAfFgiIlnrtux] [-p] [nom[ =valeur] ...]

typeset [-aAfFgiIlnrtux] [-p] [nom[ =valeur] ...]

Déclarer des variables ou leur fournir des attributs. Si aucun nom n'est indiqué, afficher les valeurs des variables. L'option -p affichera les attributs et les valeurs de chaque nom. Quand -p est utilisée avec des arguments nom, les options supplémentaires, à part -f et -F, sont ignorées. Quand -p est fourni sans argument nom, les attributs et valeurs de toutes les variables ayant des attributs indiqués par les options additionnelles seront affichés. Si aucune autre option n'est fournie avec -p, declare affichera les attributs et valeurs de toutes les variables de l'interpréteur. L'option -f limite l'affichage aux fonctions de l'interpréteur. L'option -F empêche l'affichage des définitions de fonctions : seuls le nom de la fonction et ses attributs sont affichés. Si l'option d'interpréteur extdebug est activée en utilisant shopt, le nom du fichier source et le numéro de ligne où chaque nom est défini sont aussi affichés. L'option -F implique -f. L'option -g force la création ou la modification de variables avec une portée globale, même si declare est exécutée dans une fonction de l'interpréteur. Elle est ignorée dans tous les autres cas. L'option -I fait que les variables locales héritent des attributs (sauf de l'attribut nameref) et prennent la valeur de n'importe quelle variable existante du même nom dans son environnement. S'il n'y a pas de variable existante, la variable locale est détruite dans un premier temps. Les options suivantes permettent de restreindre l'affichage aux variables dotées de certains attributs ou de configurer les attributs des variables :

dirs [-clpv] [+n] [-n]

Sans option, afficher la liste des répertoires actuellement mémorisés. L'affichage par défaut est réalisé sur une seule ligne, les noms de répertoires étant séparés par des espaces. Les répertoires sont ajoutés à la liste avec la commande pushd et supprimés avec la commande popd. Le répertoire courant est toujours le premier répertoire de la pile.

disown [-ar] [-h] [tâche ... | pid ... ]

Sans options, supprimer chaque tâche de la table des tâches actives. Si aucune tâche n'est précisée et qu’aucune des options -a ou -r n'est fournie, la tâche actuelle est utilisée. Si l'option -h est indiquée, aucune tâche n'est supprimée de la table, mais chaque tâche est marquée pour que le signal SIGHUP ne lui soit pas envoyé si l'interpréteur reçoit un signal SIGHUP. Si aucune tâche n'est fournie, l'option -a signifie la suppression ou le marquage de toutes les tâches ; l'option -r sans l'argument tâche restreint les opérations aux tâches en cours d'exécution. La valeur renvoyée est 0, sauf si tâche n'indique pas une tâche correcte.

echo [-neE] [arguments ...]

Afficher les arguments, séparés par des espaces, suivis par un saut de ligne. La valeur renvoyée est 0 sauf en cas d’erreur. Si -n est indiqué, le changement de ligne final est supprimé. Si l'option -e est indiquée, l'interprétation des caractères de protection suivants par une contre-oblique est activée. L'option -E désactive l'interprétation de ces caractères de protection, même sur les systèmes où ils sont interprétés par défaut. L'option d'interpréteur xpg_echo peut être utilisée dynamiquement pour déterminer si echo développe ou non par défaut ces caractères de protection. echo n'interprète pas -- comme signifiant la fin des options. echo reconnaît les suites de caractères de protection suivants :

enable [-a] [-dnps] [-f fichier] [ nom ...]

Activer ou désactiver les commandes internes de l'interpréteur. Désactiver une commande interne permet d'exécuter une commande disque ayant le même nom qu'une commande interne de l'interpréteur, sans avoir à indiquer un chemin d'accès complet, même quand l'interpréteur recherche normalement les commandes internes avant les commandes du disque. Si -n est utilisé, chaque nom indiqué est désactivé, sinon ils sont activés. Par exemple, pour utiliser le programme binaire test qui se trouve dans PATH plutôt que la commande interne, utilisez ``enable -n test''. L'option -f demande de charger la nouvelle commande interne avec le nom indiqué depuis le fichier objet partagé sur les systèmes qui le permettent. bash utilisera la valeur de la variable BASH_LOADABLES_PATH comme une liste séparée par des deux-points dans laquelle rechercher le fichier. La valeur par défaut dépend du système. L'option -d permet de supprimer une commande interne chargée précédemment avec -f. Si aucun argument nom n'est indiqué ou si l'option -p est fournie, une liste des commandes internes de l'interpréteur est affichée. Sans autre option, la liste est celle des commandes internes actives de l'interpréteur. Si -n est fournie, seules les commandes désactivées sont affichées. Si -a est fournie, la liste de toutes les commandes est affichée, avec une indication des activations et désactivations. Si -s est fournie, la sortie est limitée aux commandes internes spéciales POSIX. Si aucune option n'est fournie et si nom n'est pas une commande interne de l'interpréteur, enable tentera de charger nom à partir d'un objet partagé nommé nom comme si la commande était ``enable -f name name . La valeur renvoyée est 0 à moins que nom ne soit pas une commande interne de l'interpréteur ou qu'il y ait une erreur au chargement d'une nouvelle commande interne d'un objet partagé.

eval [arguments ...]

Les arguments sont lus et regroupés en une seule commande simple. Cette commande est alors lue et exécutée par l'interpréteur et son état final est renvoyé comme valeur de la commande eval. S'il n'y a pas d' arguments ou uniquement des arguments NULL, eval renvoie 0.

exec [-cl] [-a nom] [commande [ arguments]]

Si une commande est indiquée, elle remplace l'interpréteur. Aucun nouveau processus n'est créé. Les arguments deviennent ceux de la commande. Si l'option -l est fournie, l'interpréteur place un tiret en guise de zéroième argument fourni à la commande. C'est ce que fait login(1). L'option -c conduit à l'exécution de la commande avec un environnement vide. Si l'option -a est fournie, l'interpréteur transmet le nom comme zéroième argument. Si la commande ne peut être exécutée pour une raison quelconque, un interpréteur non interactif termine, sauf si l'option de l'interpréteur execfail est activée. Dans ce cas, une erreur est renvoyée. Un interpréteur interactif renvoie une erreur si le fichier ne peut pas être exécuté. Un sous-interpréteur termine sans conditions si exec échoue. Si aucune commande n'est indiquée, les éventuelles redirections sont mises en place dans l'interpréteur actuel et l'état renvoyé est 0. S'il y a une erreur de redirection, l'état renvoyé est 1.

exit [n]

Termine l'interpréteur avec un état de n. Si n est omis, l'état final est celui de la dernière commande exécutée. Une capture sur EXIT est exécutée avant que l'interpréteur ne se termine.

export [-fn] [nom[=mot]] ...

export -p

Les noms fournis sont marqués pour être exportés automatiquement dans l'environnement des commandes exécutées par la suite. Si l'option -f est indiquée, les noms se rapportent à des fonctions. Si aucun nom n'est donné ou si l'option -p est fournie, une liste de noms de toutes les variables exportées est affichée. L'option -n conduit à supprimer l'attribut d'exportation de toutes les variables nommées. Si un nom de variable est suivi par = mot, la valeur de la variable est configurée à mot. export renvoie un état final de 0, sauf si une option incorrecte est rencontrée, si un des noms n'est pas un nom correct de variable de l'interpréteur, ou si l'option -f est fournie avec un nom qui n'est pas une fonction.

fc [-e éditeur] [-lnr] [première] [dernière]

fc -s [motif=nouveau] [commande]

La première forme sélectionne un intervalle de commandes de la première à la dernière dans la file d’historique et l’affiche ou l’édite pour les réexécuter. La première et la dernière peuvent être indiquées sous forme de chaînes (pour trouver la dernière commande commençant par cette chaîne) ou sous forme numérique (un indice dans la file d'historique où un nombre négatif est utilisé comme décalage par rapport au numéro de la commande actuelle). Sur la liste, une première ou une dernière de valeur 0 est équivalente à -1, et -0 est équivalent à la commande actuelle (habituellement la commande fc) ; autrement, 0 est équivalent à -1 et -0 n'est pas valable. Si la dernière n'est pas indiquée, elle est configurée à la commande actuelle si l'on veut afficher la liste (ainsi ``fc -l -10'' affiche les 10 dernières commandes) et à l'identique de la première sinon. Si la première n'est pas indiquée, elle est configurée à la commande précédente pour une édition et à -16 pour l'affichage de liste. L'option -n supprime l'affichage des numéros dans la liste. L'option -r inverse l'ordre des commandes. Si l'option -l est indiquée, les commandes sont affichées sur la sortie standard. Sinon, l' éditeur indiqué est appelé avec un fichier contenant les commandes sélectionnées. Si aucun éditeur n'est indiqué, on utilise la valeur de la variable FCEDIT et la valeur de EDITOR si FCEDIT n'existe pas. Si aucune variable n'existe, vi est utilisé. Lorsque l'édition se termine, les commandes sont affichées puis exécutées. Dans la seconde forme, la commande est réexécutée après avoir remplacé chaque instance du motif par nouveau. commande est interprétée de la même façon que première ci-dessus. Un alias utile pour cela est ``r="fc -s"'', ainsi en tapant ``r cc'' on relance la dernière commande commençant par ``cc'' et en tapant ``r'' on réexécute la commande précédente. Lorsque la première forme est utilisée, la valeur renvoyée est 0, sauf si une option incorrecte est trouvée ou si première ou dernière indiquent des lignes d'historique hors d'atteinte. Si l'option -e est fournie, la valeur renvoyée est celle de la dernière commande exécutée ou un échec si une erreur s'est produite avec le fichier temporaire des commandes. Avec la seconde forme, l'état renvoyé est celui de la commande réexécutée, sauf si commande n'indique pas une ligne correcte de l'historique, auquel cas fc renvoie un échec.

fg [tâche]

Reprendre la tâche au premier plan qui devient la tâche actuelle. Si aucune tâche n'est précisée, l'interpréteur utilise la notion de tâche actuelle. La valeur renvoyée est celle de la commande placée au premier plan ou un échec si le contrôle des tâches est désactivé ou, lorsque le contrôle des tâches est activé, si la tâche n'indique pas une tâche correcte ou si la tâche indique une tâche lancée sans contrôle des tâches.

getopts chaîne_d_options nom [arguments ...]

getopts est utilisé par les scripts d'interpréteur pour analyser les paramètres positionnels. La chaîne_d_options contient l'ensemble des caractères d'options à reconnaître ; si un caractère est suivi par un deux-points, l'option est censée avoir un argument, qui devrait en être séparé par une espace. Les caractères deux-points et le point d'interrogation ne peuvent pas être utilisés comme caractères d'option. À chaque appel, getopts place l'option suivante dans la variable de l'interpréteur dont le nom est fourni, en la créant si elle n'existe pas et l'indice de l'argument suivant à traiter dans la variable OPTIND. OPTIND est initialisée à 1 à chaque appel d'un interpréteur ou d'un script. Quand une option nécessite un argument, getopts place cet argument dans la variable OPTARG. L'interpréteur ne réinitialise pas OPTIND automatiquement, il faut le faire manuellement entre des appels multiples à getopts au sein du même appel d'interpréteur si un nouveau jeu de paramètres doit être utilisé. Lorsque la fin des options est atteinte, getopts termine avec une valeur renvoyée strictement supérieure à zéro. OPTIND est positionné à l'indice du premier argument obligatoire et un point d'interrogation ( ?) est placé dans la variable nom. getopts analyse en principe les paramètres positionnels, mais si plus d'arguments sont indiqués comme valeur d' arguments, getopts analysera ces derniers à la place. getopts peut signaler des erreurs de deux façons. Si le premier caractère de la chaîne_d_options est un deux-points, les erreurs sont signalées de façon silencieuse. Lors d'un fonctionnement normal, des messages de diagnostic sont affichés si une option est incorrecte ou s'il manque un argument d'option. Si la variable OPTERR est configurée à 0, aucun message d'erreur ne sera affiché, même si le premier caractère de la chaîne_d_options n'est pas un deux-points. Si une option incorrecte est rencontrée, getopts place un point d'interrogation ( ?) dans la variable nom, affiche un message d'erreur (s'il n'est pas en mode silencieux) et détruit la variable OPTARG. Si getopts fonctionne en mode silencieux, le caractère d'option est placé dans OPTARG et aucun message de diagnostic n'est affiché. Lorsqu'un argument d'option nécessaire est absent et si getopts n'est pas silencieux, un point d'interrogation ( ?) est placé dans la variable nom, OPTARG est détruite et un message de diagnostic est affiché. Si getopts est silencieux, un deux-points (:) est placé dans la variable nom et OPTARG est positionné à l'option monocaractère trouvée. getopts renvoie vrai si une option, indiquée ou non, est trouvée. Il renvoie faux si la fin des options est atteinte ou si une erreur se produit.

hash [-lr] [-p fichier] [-dt] [ nom]

Chaque fois que hash est invoquée, le chemin d'accès complet de la commande nom est déterminé en examinant les répertoires de $PATH, et mémorisé. Tous les chemins précédemment mémorisés sont supprimés. Si l'option -p est fournie, aucune recherche de chemin d'accès n'est effectuée et le fichier est utilisé comme chemin d'accès complet pour la commande. L'option -r conduit l'interpréteur à oublier tous les emplacements mémorisés. L'option -d conduit l'interpréteur à oublier tous les emplacements mémorisés de chaque nom. Si l'option -t est fournie, le chemin d'accès complet de chaque nom correspondant est affiché. Si plusieurs arguments nom sont fournis avec -t, le nom est affiché avant chaque chemin d'accès complet associé. L'option -l conduit à afficher la sortie dans un format réutilisable en entrée. Si aucun argument n'est indiqué ou si seulement -l est fournie, des informations sur les commandes mémorisées sont affichées. La valeur renvoyée est vrai, sauf si nom n'est pas trouvé ou si une option incorrecte est fournie.

help [-dms] [motif]

Afficher des informations d'aide au sujet des commandes internes. Si un motif est indiqué, help fournit de l'aide sur toutes les commandes internes correspondant à ce motif, sinon, une liste des commandes internes et des structures de contrôle de l'interpréteur est affichée.

history [n]

history -c

history -d nombre

history -d début-fin

history -anrw [fichier]

history -p argument [argument ...]

history -s argument [argument ...]

Sans options, afficher la liste des commandes de la file d'historique, avec les numéros de ligne. Les lignes marquées avec un * ont été modifiées. Un argument n permet de n'afficher que les n dernières lignes. Si la variable de l'interpréteur HISTTIMEFORMAT existe et n'est pas NULL, elle est utilisée comme chaîne de format pour strftime(3) afin d'afficher l'horodatage associé à chaque élément de l'historique. Aucun blanc ne sépare l'horodatage ainsi mis en forme de la ligne d'historique. Si un argument fichier est fourni, il est utilisé comme nom de fichier d'historique ; sinon la valeur de HISTFILE est utilisée. Les options, si fournies, ont les significations suivantes :

jobs [-lnprs] [ tâche ... ]

jobs -x commande [ arguments ... ]

La première forme affiche la liste des tâches actives. Les options ont les significations suivantes :

kill [-s signal | -n num-signal | -signal] [pid | tâche] ...

kill -l|-L [signal | état_final]

Envoyer le signal indiqué par signal ou num-signal aux processus indiqués par pid ou par tâche. signal est soit sous la forme de nom de signal (indifférent à la casse), comme SIGKILL (avec ou sans le préfixe SIG), soit sous forme numérique ; num-signal est un numéro de signal. Si signal est absent, SIGTERM est supposé par défaut. Un argument -l provoque l'affichage de la liste des noms de signaux. Si des arguments sont fournis quand -l est indiqué, les noms des signaux correspondant aux arguments sont affichés et l'état renvoyé est 0. L'argument état_final de l'option -l est un nombre indiquant soit un numéro de signal, soit l'état final d'un processus terminé par un signal. L'option -L est équivalente de -l. kill renvoie vrai si au moins un signal a été envoyé avec succès ou faux si une erreur s'est produite ou si une option incorrecte a été rencontrée.

let argument [argument ...]

Chaque argument est une expression arithmétique à évaluer (consultez ÉVALUATION ARITHMÉTIQUE above). Si l'évaluation du dernier argument donne 0, let renvoie 1 ; sinon 0 est renvoyé.

local [option] [nom[=valeur] ...] - ]

Pour chaque argument, une variable locale nom est créée et la valeur lui est affectée. L' option peut être n'importe quelle option acceptée par declare. Quand local est utilisé dans une fonction, la variable nom possède une portée visible restreinte à cette fonction et ses enfants. Si nom est -, les options de l'interpréteur sont réglées à locales pour la fonction dans laquelle local est invoquée : les options de l'interpréteur, modifiées en utilisant la commande interne set dans la fonction, sont restaurées à leur valeur originale quand la fonction redonne la main. La restauration est effectuée comme si une série de commandes set avaient été exécutées pour restaurer les valeurs qui étaient en place avant la fonction. Sans opérandes, local affiche la liste des variables locales sur la sortie standard. Une utilisation de local hors des fonctions est erronée. La valeur renvoyée est 0, sauf si local est utilisé hors d'une fonction, si un nom incorrect est fourni ou si nom est une variable en lecture seule.

logout

Terminer un interpréteur de connexion.

mapfile [-d délimiteur] [-n nombre] [-O origine] [-s nombre] [ -t] [-u df] [-C rappel] [ -c quantum] [tableau]

readarray [-d délimiteur] [-n nombre] [-O origine] [-s nombre] [ -t] [-u df] [-C rappel] [ -c quantum] [tableau]

Lire les lignes depuis l'entrée standard dans la variable de type tableau indicé tableau, ou depuis le descripteur de fichier df si l'option -u est fournie. La variable MAPFILE est le tableau par défaut. Les options, si fournies, ont les significations suivantes :

popd [-n] [+n] [-n]

Enlever des éléments de la pile des répertoires. Les éléments sont numérotés à partir de 0 avec le premier répertoire listé par dirs. Sans argument popd supprime le répertoire du sommet de la pile et un cd est effectué en direction du nouveau répertoire au sommet. Les arguments, si fournis, ont les significations suivantes :

printf [-v var] format [arguments]

Écrire les arguments mis en forme sur la sortie standard sous le contrôle du format. L'option -v conduit à affecter la sortie à la variable var plutôt que de l'afficher sur la sortie standard. Ce format est une chaîne de caractères contenant trois types d'objets : les caractères normaux, qui sont simplement copiés sur la sortie standard, les caractères de protection qui sont convertis puis copiés sur la sortie standard et les spécifications de format, qui conduisent chacun à l'affichage des arguments successifs. En plus des spécifications de format standard de printf(1), printf interprète les extensions suivantes :

pushd [-n] [+n] [-n]

pushd [-n] [rép]

Ajouter un répertoire au sommet de la pile des répertoires ou effectuer une rotation dans la pile, en ramenant le répertoire actuel au sommet. Sans argument, la commande pushd échange les deux éléments au sommet de la pile des répertoires. Les arguments, si fournis, ont les significations suivantes :

pwd [-LP]

Afficher le chemin d'accès absolu au répertoire de travail actuel. Le chemin ne contiendra pas de liens symboliques si l'option -P est fournie, ou si l'option -o physical de la commande interne set est activée. Si l'option -L est utilisée, le chemin affiché peut contenir des liens symboliques. L'état renvoyé est 0, sauf si une erreur s'est produite lors de la lecture du nom du répertoire actuel ou si une option incorrecte est fournie.

read [-ers] [-a tableau] [-d délimiteur] [-i texte] [-n nb_car] [ -N nb_car] [-p invite] [-t délai] [-u df] [nom ...]

Une ligne est lue depuis l'entrée standard ou à partir du descripteur de fichier df fourni en argument à l'option -u, découpée en mots comme décrit above dans Découpage en mots, puis le premier mot de cette ligne est affecté au premier nom, le second mot au second nom, et ainsi de suite. S'il y a plus de mots que de noms, les mots restants et leurs séparateurs intercalaires sont affectés au dernier nom. S'il y a moins de mots lus dans le flux d'entrée que de variables, des valeurs vides sont affectées à celles restantes. Les caractères contenus dans la variable IFS sont utilisés pour découper la ligne en mots en utilisant les mêmes règles que celles utilisées par l’interpréteur pour le développement (décrites above dans Découpage en mots). Le caractère contre-oblique ( \) permet de supprimer toute signification spéciale pour le caractère suivant et autorise la continuation de ligne. Les options, si fournies, ont les significations suivantes :

readonly [-aAf] [-p] [nom[= mot] ...]

Les noms indiqués reçoivent un attribut lecture seule ; les valeurs de ces noms ne pourront plus être modifiées par des affectations ultérieures. Si l'option -f est fournie, les fonctions correspondant à ces noms sont marquées en conséquence. L'option -a restreint l'action aux variables tableaux indicés ; l'option -A restreint l'action aux variables tableaux associatifs. Si les deux options sont fournies, -A est prioritaire. Si aucun argument nom n'est indiqué ou si l'option -p est fournie, une liste de tous les noms en lecture seule est affichée. Les autres options peuvent être utilisées pour restreindre l'affichage à un sous-ensemble de l'ensemble des noms en lecture seule. L'option -p conduit à afficher la sortie dans un format susceptible d'être réutilisé en entrée. Si le nom d'une variable est suivi par =mot, la variable est configurée à mot. L'état renvoyé est 0, sauf si une option incorrecte a été rencontrée, si l'un des noms n'est pas un nom correct de variable de l'interpréteur ou si l'option -f est fournie avec un nom qui n'est pas une fonction.

return [n]

Forcer une fonction à arrêter son exécution et à renvoyer la valeur indiquée par n dans son contexte d'appel. Si n est omis, la valeur de retour renvoyée est celle de la dernière commande exécutée dans le corps de la fonction. Si return est exécuté par un gestionnaire de capture, la dernière commande utilisée pour déterminer l'état est la dernière commande exécutée avant le gestionnaire de capture. Si return est exécutée durant une capture de DEBUG, la dernière commande utilisée pour déterminer l'état est la dernière commande exécutée par le gestionnaire de capture avant que return soit invoquée. Si return est utilisée hors d'une fonction, mais pendant l'exécution d'un script par la commande . ( source), elle conduit à l'arrêt de l'exécution du script par l'interpréteur et renvoie comme état final du script soit n, soit l'état final de la dernière commande exécutée dans le script. Si n est fourni, la valeur de retour est ses 8 bits de poids faible. La valeur de retour est non nulle si un argument non numérique est fourni à return, ou si elle est utilisée hors d'une fonction ou pas lors de l'exécution d'un script par . ou source. Toute commande associée à la capture de RETURN est exécutée avant la reprise de l'exécution après la fonction ou le script.

set [-abefhkmnptuvxBCEHPT] [-o nom_d_option] [ --] [-] [argument ...]

set [+abefhkmnptuvxBCEHPT] [+o nom_d_option] [ --] [-] [argument ...]

Sans options, afficher le nom et la valeur de toutes les variables de l'interpréteur dans un format susceptible d'être réutilisé en entrée pour créer ou réinitialiser les variables actuelles. Les variables en lecture seule ne peuvent pas être réinitialisées. En mode POSIX, seules les variables de l'interpréteur sont affichées. La sortie est triée en fonction des paramètres linguistiques régionaux actuels. Lorsque des options sont indiquées, elles créent ou détruisent des attributs de l'interpréteur. Tous les arguments restant après traitement des options sont considérés comme des valeurs pour les paramètres positionnels et sont affectés, dans l'ordre, à : $1, $2, ... $n. Les options, si indiquées, ont les significations suivantes :