Man page 1 : bash-static

bash - Interpréteur de commandes GNU Bourne-Again SHell

bash [options] [fichier]

Bash est Copyright © 1989-2011 par la Free Software Foundation, Inc.

Bash est un interpréteur de commandes (shell) compatible sh qui exécute les commandes lues depuis l'entrée standard ou depuis un fichier. Bash inclut aussi des fonctionnalités utiles des interpréteurs de commandes Korn et C (ksh et csh).

Bash vise à être une implémentation conforme à la partie relative aux interpréteurs de commandes et utilitaires des spécifications IEEE POSIX (norme IEEE 1003.1). Bash peut être configuré pour être conforme aux spécifications POSIX par défaut.

Toutes les options d'interpréteur monocaractères documentées dans la description de la commande interne set peuvent être utilisées comme options si l'interpréteur est invoqué. De plus, bash accepte les options suivantes lors de son appel :

• -c  chaîne
            Si l'option -c est présente, les commandes sont lues depuis la chaîne fournie. S'il y a des arguments après la chaîne, ils sont affectés aux paramètres positionnels, en commençant par $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 tout en appelant un interpréteur interactif.
• -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 sujettes à 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 à --.

Bash reconnaît également plusieurs options multicaractères. Ces options doivent, pour être reconnues, apparaître sur la ligne de commande avant les options monocaractères.

• --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 de configuration générale /etc/profile , ni les fichiers d'initialisation personnels ~/.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 le standard POSIX, en ce qui concerne les options dont l'action par défaut diffère de ce standard (mode posix).
• --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.

S'il reste des arguments sur la ligne de commande après traitement des options et que ni l'option -c, ni l'option -s n'ont été fournies, le premier argument est supposé être le nom du fichier dans lequel lire les commandes d'interpréteur. Si bash est appelé de cette façon, le nom du ficher est affecté à $0 et les arguments restants aux autres paramètres positionnels. Bash lit et exécute les commandes depuis ce fichier, puis termine. L'état final de bash est l'état final de la dernière commande exécutée dans le script. Si aucune commande n'a été exécutée, l'état final est 0. Une tentative est d'abord faite de trouver le fichier dans le répertoire actuel et, si aucun fichier n'est trouvé, l'interpréteur cherche le script dans les répertoires contenus dans PATH.

Un interpréteur de commandes est dit de connexion (login shell) si le premier caractère de son argument numéro zéro est un - ou s'il est appelé avec l'option --login.

Un interpréteur est interactif s'il est appelé sans argument autre que des options et sans l'option -c, dont l'entrée standard et sa sortie d'erreur sont toutes deux connectées à des terminaux (comme déterminé par la fonction isatty(3)) ou s'il est appelé avec l'option -i. PS1 est créée et $- contient la lettre i si bash est interactif, ce qui permet à un script ou à un fichier de démarrage de tester cet état.

Le paragraphe suivant décrit comment bash exécute ses fichiers d'initialisation. Si un de ces fichiers existe mais n'est pas accessible en lecture, bash signale une erreur. Les tildes sont remplacés par des noms de fichiers comme décrit ci-dessous dans Développement du tilde dans le paragraphe DÉVELOPPEMENTS.

Lorsque bash est lancé comme interpréteur de commandes de connexion interactif ou comme interpréteur non interactif avec l'option --login, il lit et exécute tout d'abord les commandes se trouvant dans le fichier /etc/profile si ce fichier existe. Après lecture de ce fichier, il recherche ~/.bash_profile, ~/.bash_login et ~/.profile, dans cet ordre, puis lit et exécute les commandes se trouvant dans le premier fichier existant et accessible en lecture. L'option --noprofile peut être utilisée à l'appel de l'interpréteur pour empêcher ce comportement.

Lorsqu'un interpréteur de commandes de connexion termine, bash lit et exécute les commandes du fichier ~/.bash_logout, s'il existe.

Quand un interpréteur interactif démarre sans être un interpréteur de commandes de connexion, bash lit et exécute les commandes se trouvant dans /etc/bash.bashrc et ~/.bashrc s'ils existent. Ce comportement peut être empêché à l'aide de l'option --norc. L'option --rcfile fichier forcera bash à lire et exécuter les commandes dans fichier plutôt que dans /etc/bash.bashrc et ~/.bashrc.

Quand bash est démarré de façon non interactive, par exemple pour lancer un script, il consulte la variable BASH_ENV dans l'environnement, développe son contenu si elle existe et considère cette valeur comme le nom d'un fichier à lire et exécuter. Bash se comporte comme si la commande suivante était exécutée :

if [ -n "$BASH_ENV" ]; then . "$BASH_ENV"; fi

mais la valeur de la variable PATH n'est pas utilisée pour rechercher le fichier.

Si bash est appelé sous le nom sh, il essaye d'imiter le comportement de démarrage des versions historiques de sh aussi fidèlement que possible, tout en restant conforme aux spécifications POSIX. Lorsqu'il est appelé comme interpréteur de commandes de connexion interactif ou non interactif avec l'option --login, il essaye d'abord de lire et exécuter, dans cet ordre, les commandes de /etc/profile puis de ~/.profile. L'option --noprofile peut être utilisée pour empêcher ce comportement. Quand il est appelé en tant qu'interpréteur interactif sous le nom sh, bash consulte la variable ENV, développe sa valeur si elle est définie et utilise le résultat en tant que nom de fichier à lire et exécuter. Comme un interpréteur appelé sous le nom sh n'essaye ni de lire, ni d'exécuter des commandes d'un autre fichier de démarrage, l'option --rcfile n'a aucun effet. Un interpréteur non interactif appelé sous le nom sh n'essaie de lire aucun autre fichier d'initialisation. Quand il est appelé sous le nom sh, bash entre en mode posix après avoir lu les fichiers d'initialisation.

Quand bash est appelé en mode posix comme avec l'option --posix sur la ligne de commande, il suit le standard POSIX pour les fichiers de démarrage. Dans ce mode, les interpréteurs interactifs développent la variable ENV et les commandes sont lues et exécutées à partir du fichier dont le nom est la valeur développée. Aucun autre fichier d'initialisation n'est lu.

Bash tente de déterminer s'il est exécuté avec son entrée standard reliée à une connexion réseau, comme quand il est exécuté par le démon lançant les interpréteurs de commandes à distance, généralement rshd, ou le démon d'interpréteur sécurisé sshd. Si bash conclut qu'il est exécuté de cette façon, il lit et exécute les commandes de /etc/bash.bashrc et ~/.bashrc si ces fichiers existent et sont accessibles en lecture. Il n'a pas ce comportement lorsqu'il est appelé sous le nom sh. L'option --norc peut être utilisée pour empêcher ce comportement et l'option --rcfile peut être utilisée pour forcer la lecture d'un autre fichier, mais rshd n'appelle généralement pas l'interpréteur avec ces options ni ne permet de les indiquer.

Si l'interpréteur est lancé avec un identifiant (de groupe) d'utilisateur effectif différent de l'identifiant (de groupe) d'utilisateur réel et si l'option -p n'est pas fournie, aucun fichier d'initialisation n'est lu, les fonctions de l'interpréteur ne sont pas importées depuis l'environnement, les variables SHELLOPTS, BASHOPTS, CDPATH, et GLOBIGNORE, si présentes dans l'environnement, sont ignorées, et l'identifiant de l'utilisateur effectif est configuré à celui de l'utilisateur réel. Si l'option -p est fournie à l'appel, le comportement au démarrage est le même mais l'identifiant d'utilisateur effectif n'est pas modifié.

Les définitions suivantes sont utilisées dans toute la suite ce document.

• 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 ou 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 :
  

| & ; ( ) < > espace tab

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

|| & && ; ;; ( ) | |& <changement de ligne>

Les mots réservés sont des mots qui ont une signification spéciale pour l'interpréteur. Les mots suivants sont reconnus comme réservés lorsqu'ils ne sont pas protégés et sont soit le premier mot d'une commande simple (consultez GRAMMAIRE DE L'INTERPRÉTEUR ci-dessous) soit le troisième mot d'une commande case ou for :

.RS

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

.RE

10.1. Commandes simples ▲

10.2. Conduites ▲

10.3. Listes ▲

10.4. Commandes composées ▲

10.5. Coprocessus ▲

10.6. Définitions des fonctions de l'interpréteur ▲

Dans un interpréteur non interactif ou dans un interpréteur interactif avec l'option interactive_comments activée par la commande interne shopt (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous), un mot commençant par # conduit à ignorer ce mot et tous les caractères restants sur la ligne. Un interpréteur interactif sans l'option interactive_comments n'autorise pas les commentaires. L'option interactive_comments est activée par défaut dans les interpréteurs interactifs.

Les protections (« quoting ») permettent de forcer l'interpréteur à ignorer la signification spéciale de certains caractères ou mots. Les protections peuvent être utilisées pour désactiver le traitement des caractères spéciaux, éviter la reconnaissance des mots réservés ou empêcher le développement des paramètres.

Tous les métacaractères décrits ci-dessus dans DÉFINITIONS ont des significations spéciales pour l'interpréteur et doivent être protégés pour ne représenter que leur propre caractère.

Lorsque les outils de développement de l'historique des commandes sont utilisés (consultez DÉVELOPPEMENT DE L'HISTORIQUE ci-dessous), le caractère de développement de l'historique, généralement !, doit être protégé pour éviter le développement de l'historique.

Il y a trois mécanismes de protection : le caractère d'échappement, les guillemets simples (« single quotes ») et les guillemets doubles (« double quotes »).

Le caractère d'échappement est une contre-oblique (\) non protégée. Il préserve la valeur littérale du caractère qui le suit, à l'exception du <changement de ligne>. Si un couple \<changement de ligne> apparaît et si la contre-oblique n'est pas elle-même protégée, l'ensemble \<changement de ligne> est considéré comme une continuation de ligne (c'est-à-dire qu'il est supprimé du flux d'entrée et ignoré en pratique).

Encadrer des caractères entre des guillemets simples préserve la valeur littérale de chacun des caractères entre guillemets simples. Un guillement simple ne peut pas être placé entre deux guillemets simples, même s'il est précédé d'une contre-oblique.

Encadrer des caractères entre des guillemets doubles préserve la valeur littérale de chacun des caractères sauf $, \`, \ et, lorsque le développement de l'historique est activé, !. Les caractères $ et \` conservent leurs significations spéciales entre guillemets doubles. La contre-oblique ne conserve sa signification spéciale que lorsqu'elle est suivie par l'un des caractères suivants : $, \`, ", \ ou <changement de ligne>. Un guillemet double peut être protégé entre deux guillemets doubles en étant précédé d'une contre-oblique. S'il est activé, le développement de l'historique sera effectué, à moins qu'un ! apparaissant entre guillemets doubles ne soit protégé par une contre-oblique. La contre-oblique précédant le ! n'est pas supprimée.

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

Les mots de la forme $chaîne sont traités spécialement. Le mot est développé en chaîne avec les caractères protégés par contre-oblique remplacés comme indiqué par le standard ANSI C. Les suites d'échappement par contre-oblique, si présentes, sont décodées comme suit :

• \a
      alerte (alarme) ;
• \b
      effacement arrière (« backspace ») ;
• \e
• \E
      caractère d'échappement ;
• \f
      saut de page (« form feed ») ;
• \n
      saut de ligne (« new line ») ;
• \r
      retour chariot (« carriage return ») ;
• \t
      tabulation horizontale ;
• \v
      tabulation verticale ;
• \\
      contre-oblique ;
• \
      guillemet simple ;
• \"
      guillemet double ;
• \nnn
      le caractère 8 bits dont la valeur octale est nnn (un à trois chiffres) ;
• \xHH
      le caractère 8 bits dont la valeur hexadécimale est HH (un ou deux chiffres hexadécimaux) ;
• \uHHHH
      le caractère Unicode (ISO/IEC 10646) dont la valeur hexadécimale est HHHH (un à quatre chiffres hexadécimaux) ;
• \UHHHHHHHH
      le caractère Unicode (ISO/IEC 10646) dont la valeur hexadécimale est HHHHHHHH (un à huit chiffres hexadécimaux) ;
• \cx
      un caractère contrôle-x.

Le résultat développé est protégé par des guillemets simples comme si le symbole dollar n'avait pas été présent.

Une chaîne entre guillemets doubles précédée d'un symbole dollar ($"chaîne") conduira à la traduction de la chaîne selon les paramètres linguistiques régionaux en vigueur. Si les paramètres linguistiques régionaux actuels est C ou POSIX, le symbole dollar est ignoré. Si la chaîne est traduite et remplacée, le résultat est protégé par des guillemets doubles.

Un paramètre est une entité permettant de stocker des valeurs. Il peut être un nom, un nombre ou un des caractères spéciaux décrits ci-dessous, dans Paramètres spéciaux. Une variable est un paramètre noté par un nom. Une variable possède une valeur et zéro ou plusieurs attributs. Les attributs sont affectés en utilisant la commande interne declare (consultez declare dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

Un paramètre est créé si une valeur lui a été affectée. La chaîne vide est une valeur correcte. Une fois qu'une variable est créée, elle ne peut être détruite qu'en utilisant la commande interne unset (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

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

nom=[valeur]

Si aucune valeur n'est indiquée, une chaîne vide est affectée à la variable. Toutes les valeurs sont sujettes au développement du tilde, des paramètres et des variables, à la substitution de commande, au développement arithmétique et à la suppression des protections (consultez DÉVELOPPEMENTS ci-dessous). Si une variable a son attribut integer configuré, alors la valeur est soumise à l'évaluation arithmétique, même si la syntaxe $((...)) n'est pas utilisée (consultez Développement arithmétique ci-dessous). Le découpage en mots n'est pas effectué, à l'exception de "$@" comme expliqué ci-dessous dans Paramètres spéciaux. Le développement des chemins n'est pas effectué. Les affectations peuvent également apparaître comme argument des commandes internes suivantes : alias, declare, typeset, export, readonly et local.

Dans le contexte où une affectation affecte une valeur à une variable de l'interpréteur ou à un indice de tableau, l'opérateur += peut être utilisé pour ajouter ou additionner à la précédente valeur de la variable. Lorsque l'opérateur += est appliqué à une variable dont l'attribut integer (entier) a été positionné, la valeur est évaluée comme une expression arithmétique et additionnée à la valeur actuelle de la variable qui est également évaluée. Lorsque += est appliqué à une variable tableau en utilisant l'affectation composée (consultez Tableaux ci-dessous), la valeur de la variable n'est pas détruite (comme elle l'est lorsque = est utilisé) et les nouvelles valeurs sont ajoutées au tableau, en commençant à l'indice maximum du tableau plus un (pour les tableaux indicés) ou ajoutées comme un couple clé-valeur pour un tableau associatif. Lorsque l'opérateur est appliqué à une variable de type chaîne, la valeur est développée et concaténée en valeur de la variable.

13.1. Paramètres positionnels ▲

13.2. Paramètres spéciaux ▲

13.3. Variables de l'interpréteur ▲

13.4. Tableaux ▲

Les développements sont appliqués à la ligne de commande après avoir été découpée en mots. Sept types de développements sont effectués : le développement des accolades, le développement du tilde, le développement des paramètres et des variables, la substitution de commande, le développement arithmétique, le découpage en mots et le développement des chemins.

L'ordre des développements est : développement des accolades, du tilde, des paramètres, des variables, arithmétique et substitution de commande (effectuée de la gauche vers la droite), découpage en mots et développement des chemins.

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

Seuls le développement des accolades, le découpage en mots et le développement des chemins peuvent modifier le nombre de mots. Les autres développement transforment un mot unique en un autre mot unique. La seule exception à cette règle est le développement de « $@ » et « ${nom[@]} » comme expliqué ci-dessus (consultez PARAMÈTRES).

14.1. Développement des accolades ▲

14.2. Développement du tilde ▲

14.3. Remplacement des paramètres ▲

14.4. Substitution de commande ▲

14.5. Développement arithmétique ▲

14.6. Substitution de processus ▲

14.7. Découpage en mots ▲

14.8. Développement des chemins ▲

14.9. Suppression des protections ▲

Avant qu'une commande ne soit exécutée, il est possible de rediriger son entrée et sa sortie en utilisant une notation spéciale interprétée par l'interpréteur. Les redirections peuvent également servir à ouvrir ou fermer des fichiers dans l'environnement actuel de l'interpréteur. Les opérateurs de redirection suivants peuvent précéder ou apparaître n'importe où dans une commande simple ou suivre une commande. Les redirections sont traitées dans leur ordre d'apparition, de gauche à droite.

Toutes les redirections pouvant être précédées par un numéro de descripteur de fichier peuvent aussi être précédées par un mot de la forme {nom_de_variable}. Dans ce cas, pour chaque opérateur de redirection à part >&- et <&-, l'interpréteur de commande allouera un descripteur de fichier supérieur à 10 et l'affectera à nom_de_variable. Si >&- ou <&- est précédé de {nom_de_variable}, la valeur de nom_de_variable définit le descripteur de fichier à fermer.

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

Le mot qui suit l'opérateur de redirection dans les descriptions suivantes, à moins qu'il en soit fait état autrement, est soumis au développement des accolades, du tilde, des paramètres, à la substitution de commande, au développement arithmétique, à la suppression des protections, au développement des chemins et au découpage en mots. S'il se développe en plusieurs mots, bash signale une erreur.

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

ls > liste_répertoires 2>&1

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

ls 2>&1 > liste_répertoires

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

Bash gère plusieurs noms de fichiers de façon particulière, lorsqu'ils sont utilisés dans des redirections, comme décrit dans la table suivante :

• /dev/fd/fd
      Si fd est un entier correct, le descripteur de fichier fd est dupliqué.
• /dev/stdin
      Le descripteur de fichier 0 est dupliqué.
• /dev/stdout
      Le descripteur de fichier 1 est dupliqué.
• /dev/stderr
      Le descripteur de fichier 2 est dupliqué.
• /dev/tcp/host/port
      Si host est une adresse Internet ou un nom de machine correct et si port est un numéro de port entier ou un nom de service, bash tentera d'ouvrir une connexion TCP sur la « socket » correspondante.
• /dev/udp/host/port
      Si host est un nom de machine correct ou une adresse Internet et si port est un numéro de port entier ou un nom de service, bash tentera d'ouvrir une connexion UDP sur la « socket » correspondante.

Un échec à l'ouverture ou à la création de fichier conduit à l'échec de la redirection.

Les redirections utilisant des descripteurs de fichiers supérieurs à 9 doivent être utilisées avec précaution car des conflits peuvent survenir avec les descripteurs de fichiers utilisés en interne par l'interpréteur.

Notez que la commande interne exec peut faire appliquer les redirections à l'interpréteur de commande en cours.

15.1. Redirection d'entrée ▲

15.2. Redirection de sortie ▲

15.3. Ajout d'une sortie redirigée ▲

15.4. Redirection de la sortie standard et de la sortie d'erreur standard ▲

15.5. Ajout de la sortie standard et de la sortie d'erreur standard ▲

15.6. Document en ligne ▲

<<[-]mot
        document_en_ligne
délimiteur

15.7. Chaînes en ligne ▲

<<<mot

15.8. Dédoublement de descripteur de fichier ▲

15.9. Déplacement de descripteurs de fichiers ▲

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

Les alias permettent de substituer une chaîne à un mot lorsqu'il est utilisé comme premier mot d'une commande simple. L'interpréteur gère une liste d'alias qui peuvent être créés et détruits avec les commandes internes alias et unalias (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). L'interpréteur vérifie si le premier mot de chaque commande simple, si non protégé, est un alias. Si c'est le cas, ce mot est remplacé par le texte de l'alias. Les caractères /, $, \` et = et tout métacaractère de l'interpréteur ou caractère de protection décrits ci-dessus ne peuvent pas apparaître dans un nom d'alias. Le texte de remplacement peut contenir toute entrée correcte pour l'interpréteur, y compris les métacaractères de l'interpréteur. L'interpréteur vérifie si le premier mot du texte de remplacement est à son tour un alias, mais un mot identique à un alias en cours de développement n'est pas développé une seconde fois. Cela signifie qu'on peut, par exemple, créer un alias ls valant ls -F et bash n'essaiera pas de développer récursivement le texte de substitution. Si le dernier caractère de la valeur de l'alias est un blanc, alors le prochain mot de commande suivant l'alias connaîtra aussi le développement d'alias.

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

Il n'existe pas de mécanisme permettant d'utiliser des arguments dans le texte de remplacement. S'ils sont nécessaires, une fonction de l'interpréteur devrait être utilisée (consultez FONCTIONS ci-dessous).

Les alias ne sont pas développés quand l'interpréteur n'est pas interactif sauf si l'option expand_aliases de l'interpréteur est créée par la commande shopt (consultez la description de shopt dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

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

Les alias sont surpassés par les fonctions de l'interpréteur dans la plupart des situations.

Une fonction de l'interpréteur, définie comme décrit ci-dessus, dans GRAMMAIRE DE L'INTERPRÉTEUR, conserve une suite de commandes pour exécution ultérieure. Lorsque le nom d'une fonction de l'interpréteur est utilisée comme un simple nom de commande, la liste des commandes associées à ce nom de fonction est exécutée. Les fonctions sont exécutées dans le contexte de l'interpréteur actuel ; aucun nouveau processus n'est créé pour les interpréter (à la différence d'un script). Lorsqu'une fonction est exécutée, les arguments de la fonction deviennent les paramètres positionnels pendant son exécution. Le paramètre spécial # est mis à jour en conséquence. Le paramètre spécial 0 reste inchangé. Le premier élément de la variable FUNCNAME contient le nom de la fonction pendant son exécution.

Tous les autres aspects de l'environnement d'exécution de l'interpréteur sont identiques entre la fonction et le contexte d'appel, aux exceptions suivantes : les captures de DEBUG et RETURN (consultez la description de la commande interne trap dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) ne sont pas héritées, à moins que l'attribut trace ne soit positionné pour la fonction (consultez la description de la commande interne declare ci-dessous) ou que l'option d'interpréteur -o functrace n'ait été activée avec la commande interne set (auquel cas toutes les fonctions hériteront des captures de DEBUG et RETURN), et la capture ERR n'est pas héritée à moins que l'option d'interpréteur -o errtrace n'ait été activée.

Les variables locales d'une fonction peuvent être déclarées avec la commande interne local. Dans le cas général, les variables et leurs valeurs sont partagées entre la fonction et le contexte d'appel.

La variable FUNCNEST, si configurée à une valeur numérique strictement positive, définit le niveau maximal d'imbrication de fonctions. Les invocations de fonctions qui dépassent la limite forceront toute la commande à abandonner.

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

Les noms de fonctions et leurs définitions peuvent être affichés avec l'option -f des commandes internes declare ou typeset. Les options -F de declare ou typeset n'afficheront que les noms de fonctions (et facultativement le fichier source et le numéro de ligne, si l'option d'interpréteur extdebug est activée). Les fonctions peuvent être exportées avec l'option -f de la commande interne export, afin d'être automatiquement définies dans les sous-interpréteurs. Une définition de fonction peut être supprimée avec l'option -f de la commande interne unset. Remarquez que les fonctions et variables de l'interpréteur de même nom pourront induire à plusieurs éléments de mêmes noms dans l'environnement passé aux enfants de l'interpréteur. Un soin particulier doit être pris dans les cas où cela peut conduire à un problème.

Les fonctions peuvent être récursives. La variable FUNCNEST peut être utilisée pour limiter la profondeur de la pile d'appel de la fonction et restreindre le nombre d'invocations de fonctions. Par défaut, aucune limite n'est imposée quant au nombre d'appels récursifs.

L'interpréteur permet, dans certaines circonstances, l'évaluation d'expressions arithmétiques (consultez les commandes internes let et declare ainsi que Développement arithmétique). L'évaluation est effectuée en utilisant des entiers de longueur fixe, sans vérification du débordement. Néanmoins, la division par 0 est capturée et marquée comme une erreur. Les opérateurs, leur priorité, associativité et leur valeur sont identiques à ceux du langage C. La liste suivante d'opérateurs est entre opérateurs de niveaux de priorité identiques. Les niveaux sont décrits par ordre de priorité décroissante.

• id++ id--
      post-incrément et post-décrément de variables
• ++id --id
      pré-incrément et pré-décrément de variables
• - +
      moins et plus unaires
• ! ~
      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

Les variables de l'interpréteur sont utilisables comme opérandes, le développement des paramètres étant effectué avant l'évaluation arithmétique. Dans une expression, les variables de l'interpréteur peuvent également être référencées par leur nom, sans utiliser la syntaxe de développement des paramètres. Une variable d'interpréteur vide ou inexistante est évaluée à 0 lorsqu'elle est consultée par son nom sans utiliser la syntaxe de développement des paramètres. La valeur d'une variable est évaluée comme une expression arithmétique lorsqu'elle est consultée, ou lorsqu'une valeur lui est affecté alors que son attribut integer (entier) a été positionné en utilisant declare -i. Une valeur vide est évaluée à 0. Une variable d'interpréteur n'a donc pas besoin d'avoir son attribut integer positionné pour être utilisable dans un calcul.

Les constantes commençant par 0 sont interprétées comme des nombres octaux. Un en-tête 0x ou 0X indique une valeur hexadécimale. Sinon, les nombres ont la forme [base#]n où la base facultative est un nombre décimal entre 2 et 64 représentant la base arithmétique et n est un nombre exprimé dans cette base. Si la base# est omise, la base 10 est utilisée. Les chiffres supérieurs à 9 sont représentés par les lettres minuscules, les lettres majuscules, le @ et le _, dans cet ordre. Si la base est inférieure ou égale à 36 les minuscules et les majuscules sont interchangeables pour représenter les nombres entre 10 et 35.

Les opérateurs sont évalués par ordre de priorité. Les sous-expressions entre parenthèses sont évaluées en premier, ce qui permet de surpasser les règles de priorité ci-dessus.

Les conditions sont utilisées par la commande composée [[ et les commandes internes test et [ pour vérifier l'état d'un fichier et effectuer des comparaisons arithmétiques ou sur des chaînes. Les conditions se forment à partir des primitives unaires ou binaires suivantes. Si n'importe quel argument fichier de l'une des primitives est de la forme /dev/fd/n, alors le descripteur de fichier n est examiné. Si l'argument fichier de l'une des primitives est parmi /dev/stdin, /dev/stdout ou /dev/stderr, le descripteur de fichier 0, 1 ou 2, respectivement, est examiné.

Sauf indication contraire, les primitives relatives aux fichiers suivent les liens symboliques et opèrent sur la cible du lien plutôt que sur le lien lui-même.

0.5 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. La commande test trie en utilisant l'ordre ASCII.

• -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 fd
      Vrai si le descripteur de fichier fd 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).
• -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.
• 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
      .SM 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.

Lors de l'exécution d'une commande simple, l'interpréteur effectue les développements, affectations et redirections suivants de gauche à droite.

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.

Si aucun nom de commande ne résulte des précédentes opérations, les affectations de variables modifient l'environnement actuel de l'interpréteur. Sinon les variables sont ajoutées à l'environnement de la commande exécutée et n'affectent pas l'environnement de l'interpréteur actuel. Si l'une des tentatives d'affectation concerne une variable en lecture seule, une erreur se produit et la commande termine avec un état différent de zéro.

Si aucun nom de commande n'est obtenu, les redirections sont effectuées mais ne modifient pas l'environnement de l'interpréteur actuel. Une erreur de redirection conduit à la terminaison de la commande avec un état différent de zéro.

S'il reste un nom de commande après le développement, l'exécution a lieu comme décrit ci-dessous. Sinon la commande termine. Si l'un des développements contient une substitution de commande, l'état final de la commande est l'état final de la dernière substitution de commande effectuée. S'il n'y avait aucune substitution de commande, la commande termine avec un état de zéro.

Après le découpage de la ligne de commande en mots, si le résultat est une commande simple suivie d'une liste facultative d'arguments, les actions suivantes sont effectuées.

Si le nom de la commande ne contient aucune barre oblique, l'interpréteur tente de la localiser. S'il existe une fonction de l'interpréteur de ce nom, elle est appelée comme nous l'avons vu ci-dessus dans FONCTIONS. Si le nom n'est pas celui d'une fonction, l'interpréteur le recherche dans la liste des commandes internes. Si une correspondance est trouvée, cette commande interne est appelée.

Si le nom n'est ni celui d'une fonction de l'interpréteur, ni celui d'une commande interne et s'il ne contient pas de barre oblique, bash va chercher dans chacun des éléments de PATH un répertoire contenant un fichier exécutable du nom désiré. Bash utilise une table de hachage pour mémoriser les chemins d'accès complets aux fichiers exécutables (consultez la commande hash dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Une recherche complète dans les répertoires du PATH n'est effectuée que si la commande ne se trouve pas dans la table de hachage. Si la recherche est infructueuse, l'interpréteur recherche une fonction de l'interpréteur appelée command_not_found_handle. Si cette fonction existe, elle est appelée avec pour arguments la commande d'origine et ses arguments, et l'état final de la fonction devient l'état final de l'interpréteur. Si cette fonction n'est pas définie, l'interpréteur affiche un message d'erreur et renvoie un état final de 127.

Si la recherche réussit ou si le nom de la commande contient une ou plusieurs barres obliques, l'interpréteur exécute le programme demandé dans un environnement d'exécution distinct. L'argument 0 est configuré au nom indiqué et les éventuels arguments restants de la commande sont configurés aux arguments indiqués.

Si cette exécution échoue parce que le programme n'est pas un exécutable et si le fichier n'est pas un répertoire, il est pris pour un script, un fichier contenant des commandes d'interpréteur. Un sous-interpréteur est alors créé pour exécuter ce script. Ce sous-interpréteur se réinitialisera lui-même, comme si un nouvel interpréteur avait été appelé pour exécuter le script, à la différence qu'il continuera à mémoriser l'emplacement des commandes connues de son parent (consultez hash dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

Si le programme est un fichier commençant par #!, le reste de la première ligne indique un interprète pour ce programme. L'interpréteur se chargera d'exécuter l'interprète indiqué sur les systèmes d'exploitation qui ne gèrent pas eux-mêmes ce format d'exécutable. Les arguments de l'interprète consistent en un seul argument facultatif fourni sur la première ligne du fichier à la suite du nom de l'interprète, suivi du nom du programme, suivi des arguments de la commande s'il y en a.

L'interpréteur fournit un environnement d'exécution consistant en l'ensemble des éléments suivants :

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.

Lorsqu'une commande différente d'une commande interne ou d'une fonction de l'interpréteur doit être exécutée, elle est appelée dans un environnement d'exécution séparé constitué de ce qui suit. Sauf indication contraire, les valeurs sont héritées de l'environnement de l'interpréteur :

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.

Une commande appelée dans un environnement distinct ne peut pas affecter l'environnement d'exécution de l'interpréteur.

Les substitutions de commande, les commandes groupées entre parenthèses et les commandes asynchrones sont appelées dans un environnement de sous-interpréteur qui est une copie de celui de l'interpréteur, mais les captures interceptées par l'interpréteur sont réinitialisées aux valeurs que l'interpréteur avait héritées de son parent à son appel. Les commandes internes appelées dans une conduite sont aussi exécutées dans un environnement de sous-interpréteur. Les modifications apportées à l'environnement d'un sous-interpréteur n'affectent aucunement l'environnement d'exécution de l'interpréteur.

Les sous-interpréteurs engendrés pour exécuter les substitutions de commande héritent des valeurs de l'option -e de l'interpréteur parent. En dehors du mode posix, bash efface l'option -e de tels sous-interpréteurs.

Si une commande est suivie par un & et que le contrôle des tâches n'est pas actif, l'entrée standard par défaut de la commande est le fichier vide /dev/null. Sinon, la commande appelée hérite des descripteurs de fichiers de l'interpréteur appelant comme modifiés par les redirections.

Quand un programme est appelé, il reçoit un tableau de chaînes que l'on appelle environnement. Il s'agit d'une liste de couples nom-valeur, de la forme nom=valeur.

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

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

Si l'option -k est configurée (consultez ci-dessous la commande interne set), alors toutes les affectations de paramètres sont placées dans l'environnement d'une commande exécutée et non seulement celles qui précèdent son nom.

Quand bash appelle une commande externe, la variable _ est configurée en chemin d'accès complet à cette commande et elle est transmise dans l'environnement.

L'état final d'une commande exécutée est la valeur renvoyée par l'appel système waitpid ou fonction équivalente. Les états finaux prennent leurs valeurs entre 0 et 255, néanmoins, comme expliqué ci-dessous, l'interpréteur peut utiliser les valeurs supérieures à 125 de façon particulière. Les états finaux des commandes internes et composées sont également limitées à cette plage. Sous certaines conditions, l'interpréteur utilisera des valeurs particulières pour indiquer des modes d'échec particuliers.

Du point de vue de l'interpréteur, une commande qui termine avec état final valant zéro a réussi. Un état final de zéro indique le succès. Un état final différent de zéro indique un échec. Quand une commande se termine par un signal mortel N, bash utilise la valeur 128+N comme état final.

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

Si une commande échoue à cause d'une erreur survenue lors d'un développement ou des redirections, l'état final est strictement plus grand que zéro.

Les commandes internes renvoient un état de 0 (vrai) si réussies et une valeur différente de zéro (faux) si une erreur se produit pendant leur exécution. Toutes les commandes internes renvoient un état final de 2 pour indiquer un usage incorrect.

Bash lui-même renvoie l'état final de la dernière commande exécutée, à moins qu'une erreur de syntaxe ne se produise, auquel cas il termine avec une valeur différente de zéro. Consultez aussi ci-dessous la commande interne exit.

Quand bash fonctionne de façon interactive, en absence de toute capture, il ignore SIGTERM (c'est ainsi que kill 0 ne tue pas un interpréteur interactif) et SIGINT est intercepté et géré (c'est ainsi que la commande interne wait est interruptible). Dans tous les cas, bash ignore SIGQUIT. Si le contrôle des tâches est actif, bash ignore SIGTTIN, SIGTTOU et SIGTSTP.

Les commandes externes lancées par bash ont les gestionnaires de signaux configurés aux valeurs héritées par l'interpréteur de son parent. Quand le contrôle des tâches n'est pas actif, les tâches en arrière-plan ignorent les signaux SIGINT et SIGQUIT en plus des gestionnaires hérités. Les commandes exécutées en tant que résultat d'une substitution de commande ignorent les signaux de contrôle de tâches émis par le clavier SIGTTIN, SIGTTOU et SIGTSTP.

Par défaut, l'interpréteur termine à la réception de SIGHUP. Avant de terminer, un interpréteur interactif renvoie le SIGHUP à toutes les tâches en cours ou suspendues. Les tâches suspendues reçoivent aussi SIGCONT pour s'assurer qu'elles reçoivent bien le SIGHUP. Pour empêcher l'interpréteur d'envoyer le signal à une tâche particulière, elle devrait être supprimée de la table des tâches avec la commande interne disown (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) ou marquée comme exemptée de SIGHUP en utilisant disown -h.

Si l'option d'interpréteur huponexit a été configurée avec la fonction shopt, bash envoie un signal SIGHUP à toutes les tâches lorsqu'un interpréteur de commandes de connexion interactif termine.

Lorsque bash attend qu'une commande se termine et qu'il reçoit un signal pour lequel une capture a été configurée, la capture ne sera pas exécutée tant que la commande n'est pas terminée. Lorsque bash attend la fin d'une commande asynchrone par la commande interne wait, la réception d'un signal pour lequel une capture a été configurée conduira à un retour immédiat de la commande interne wait avec un état final supérieur à 128, à la suite de quoi la capture est immédiatement exécutée.

Le contrôle des tâches se réfère à la capacité de suspendre (suspend) sélectivement l'exécution d'un processus et de la reprendre (resume) ultérieurement. L'utilisateur bénéficie généralement de cette possibilité grâce à l'action conjointe du pilote de terminal du noyau de système d'exploitation et de bash.

L'interpréteur associe une tâche à chaque conduite. Il maintient une table des tâches en cours d'exécution, cette table pouvant être affichée avec la commande jobs. Quand bash lance une tâche de façon asynchrone (en arrière-plan), il affiche une ligne qui ressemble à :

[1] 25647

Cette ligne indique que la tâche est la tâche numéro 1 et que le PID du dernier processus dans la conduite associée à cette tâche est 25647. Tous les processus d'une même conduite font partie de la même tâche. Bash utilise la notion de tâche comme base du contrôle des tâches.

Pour faciliter l'implémentation d'une interface utilisateur pour le contrôle de tâches, le système introduit la notion d'ID de groupe de processus associés à un terminal. Les membres de ce groupe de processus (processus dont le GID est égal au Process Group ID du terminal actuel) reçoivent les signaux émis par le clavier comme SIGINT. Ces processus sont dits au premier plan. Les processus en arrière-plan sont ceux dont le Process-GID diffère de celui du terminal ; ils sont indifférents aux signaux émis par le clavier. Seuls les processus au premier plan peuvent lire depuis le terminal ou, si l'utilisateur l'indique avec stty tostop, y écrire. Les processus en arrière-plan qui tentent une lecture (ou une écriture si stty tostop est actif) dans le terminal reçoivent un signal SIGTTIN (SIGTTOU) émis par le pilote du terminal du noyau, qui, sauf interception, suspend le processus.

Si le système d'exploitation sur lequel bash fonctionne permet le contrôle des tâches, bash fournit des outils pour l'utiliser. La frappe d'un caractère de suspension (généralement ^Z, Contrôle-Z) pendant l'exécution d'un processus conduit à la suspension de celui-ci et redonne la main à bash. La frappe d'un caractère de suspension différée (généralement ^Y, Contrôle-Y) conduira à la suspension du processus au moment où il tentera de lire des saisies depuis le terminal et la main reviendra à bash. L'utilisateur peut alors manipuler l'état de cette tâche en utilisant la commande bg (background = arrière-plan) pour en continuer l'exécution en arrière-plan, la commande fg (foreground = premier plan) pour la continuer au premier plan ou encore la commande kill pour la tuer. Un ^Z s'applique immédiatement et a pour effet de bord d'éliminer les sorties et saisies en attente.

Plusieurs façons permettent de se rapporter à une tâche. Le caractère % introduit une spécification de tâche (jobspec). Il est possible de se rapporter à la tâche numéro n avec %n. Il est également possible de se rapporter à une tâche en utilisant un préfixe du nom utilisé pour le lancer ou une sous-chaîne qui apparaît dans sa ligne de commande. Par exemple, %ce se rapporte à une tâche suspendue nommée ce. Si ce préfixe correspond à plusieurs tâches, bash signale une erreur. Utiliser %?ce, d'un autre côté, se rapporte à toute tâche contenant la chaîne ce dans sa ligne de commande. Si la sous-chaîne correspond à plusieurs tâches, bash signale une erreur. Les symboles %% et %+ se rapportent à la notion de tâche actuelle de l'interpréteur, c'est-à-dire la dernière tâche suspendue alors qu'elle était au premier plan ou démarrée en arrière-plan. La tâche précédente peut être désignée en utilisant %-. Si une seule tâche existe, %+ et %- peuvent tous deux être utilisés pour se rapporter à cette tâche. Dans les affichages se rapportant aux tâches (par exemple la sortie de la commande jobs), la tâche actuelle est toujours annotée d'un + et la tâche précédente d'un -. Un simple % (non accompagné de spécification de tâche) se rapporte également à la tâche actuelle.

Il suffit de nommer une tâche pour la ramener au premier plan : %1 est synonyme de « fg %1 » et ramène la tâche 1 de l'arrière-plan vers le premier plan. De même, « %1 & » reprend la tâche 1 en arrière-plan, de façon équivalente à « bg %1 ».

L'interpréteur est immédiatement prévenu lorsqu'une tâche change d'état. Normalement bash attend d'être prêt à afficher son interpréteur avant de signaler des changements dans l'état des tâches, afin de ne pas interrompre toute autre sortie. Si l'option -b de la commande interne set est activée, bash signalera de telles modifications immédiatement. Toute capture sur SIGCHLD est exécutée pour chaque enfant qui termine.

Si une tentative visant à terminer bash est réalisée alors que des tâches sont suspendues (ou, si l'option d'interpréteur checkjobs a été activée par la commande interne shopt, en cours d'exécution), l'interpréteur affiche un message d'avertissement, et, si l'option d'interpréteur checkjobs est activée, affiche la liste les tâches et leurs états. La commande jobs peut alors être utilisée pour examiner leur état. Si une deuxième tentative est faite pour terminer sans commande intercalaire, l'interpréteur n'affiche aucun autre avertissement et les tâches suspendues sont terminées.

Quand il est exécuté de façon interactive, bash affiche l'invite de base PS1 dès qu'il est prêt à lire une commande et l'invite secondaire PS2 quand il a besoin de plus de saisies pour exécuter une commande. Bash permet de personnaliser ces chaînes d'invite, en insérant un certain nombre de caractères spéciaux protégés par des contre-obliques qui sont décodés comme suit :

• \a
      un caractère ASCII d'alarme (07) ;
• \d
      la date au format « Jour_de_la_semaine Mois Quantième » (par exemple : « Tue May 26 ») ;
• \D{format}
      le format est passé à strftime(3) et le résultat est inséré dans la chaîne de l'invite ; un format vide implique une représentation du temps spécifique aux paramètres linguistiques régionaux. Les accolades sont nécessaires ;
• \e
      un caractère d'échappement ASCII (033) ;
• \h
      le nom de la machine, jusqu'au premier point « . » ;
• \H
      le nom de la machine ;
• \j
      le nombre de tâches actuellement gérées par l'interpréteur ;
• \l
      le nom de base du nom de périphérique de terminal de l'interpréteur ;
• \n
      changement de ligne ;
• \r
      retour chariot (« carriage return ») ;
• \s
      le nom de l'interpréteur, c'est-à-dire le nom de base de $0 (la portion suivant la dernière barre oblique) ;
• \t
      l'heure actuelle au format HH:MM:SS sur 24 heures ;
• \T
      l'heure actuelle au format HH:MM:SS sur 12 heures ;
• \@
      l'heure actuelle au format HH:MM sur 12 heures ;
• \A
      l'heure actuelle au format HH:MM sur 24 heures ;
• \u
      le nom de l'utilisateur ;
• \v
      la version de bash (par exemple, 2.00) ;
• \V
      le numéro de version complet (avec niveau de correctifs) de bash, (par exemple, 2.00.0) ;
• \w
      le répertoire de travail actuel, avec $HOME abrégé en tilde « ~ » (utilise la valeur de la variable PROMPT_DIRTRIM) ;
• \W
      le nom de base du répertoire de travail actuel, avec $HOME abrégé en tilde (« ~ ») ;
• \!
      le numéro d'historique de la commande ;
• \#
      le numéro de la commande ;
• \$
      # si l'UID effectif est 0, $ sinon ;
• \nnn
      le caractère de code octal nnn ;
• \\
      une contre-oblique ;
• \[
      débute une suite de caractères non imprimables, qui peuvent être utilisés pour inclure une suite de caractères de contrôle du terminal dans l'interpréteur ;
• \]
      finit une suite de caractères non imprimables.

Le numéro de commande et le numéro d'historique sont généralement différents : le numéro d'historique d'une commande correspond à sa position dans la file d'historique qui peut contenir des commandes relues depuis cette liste (consultez HISTORIQUE ci-dessous), alors que le numéro de commande est simplement une position dans la suite de commandes exécutées depuis le début de la session d'interpréteur actuelle. Après que la chaîne ait été décodée, elle est soumise au développement des paramètres, à la substitution de commande, au développement arithmétique, au découpage des mots et à la suppression des protections, selon la valeur de l'option d'interpréteur promptvars (consultez la description de shopt dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

C'est la bibliothèque qui gère la lecture des saisies lors des sessions interactives de l'interpréteur, à moins que l'option --noediting ne soit indiquée à l'appel de l'interpréteur. Par défaut les commandes d'édition de ligne sont similaires à celles d'Emacs. Une interface d'édition de ligne dans le style vi est aussi disponible. Pour arrêter l'édition de ligne après le démarrage de l'interpréteur, utiliser l'option +o emacs ou +o vi de la commande interne set (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

28.1. Notation readline ▲

28.2. Initialisation de readline ▲

28.3. Raccourcis clavier readline ▲

28.4. Variables de readline ▲

28.5. Constructions conditionnelles de readline ▲

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

$include  /etc/inputrc

28.6. Recherche ▲

28.7. Noms des commandes readline ▲

28.8. Commandes de déplacement ▲

28.9. Commandes de manipulation de l'historique ▲

28.10. Commande d'édition de texte ▲

28.11. Effacement et récupération ▲

28.12. Arguments numériques ▲

28.13. Complètement ▲

28.14. Macros clavier ▲

28.15. Divers ▲

28.16. Complètement programmable ▲

_completion_loader()

{

	. "/etc/bash_completion.d/$1.sh" >/dev/null 2>&1 && return 124

}

complete -D -F _completion_loader

Quand l'option -o history de la commande interne set est activée, l'interpréteur donne accès à un historique des commandes, c'est-à-dire la liste des commandes précédemment utilisées. La valeur de la variable HISTSIZE est utilisée comme nombre de commandes à sauvegarder dans la file d'historique. Le texte des HISTSIZE dernières commandes (par défaut 500) est sauvegardé. L'interpréteur conserve chaque commande dans la file d'historique avant le développement des paramètres et des variables (consultez DÉVELOPPEMENTS ci-dessus) mais après avoir effectué le développement de l'historique, selon les valeurs des variables de l'interpréteur HISTIGNORE et HISTCONTROL.

Au démarrage, l'historique est initialisé avec le fichier dont le nom est contenu dans la variable HISTFILE (par défaut ~/.bash_history). Le fichier désigné par la valeur de HISTFILE est tronqué si nécessaire, pour ne pas contenir plus de lignes que le nombre précisé par HISTFILESIZE. Quand le fichier d'historique est lu, les lignes commençant par le caractère de commentaire d'historique suivi immédiatement par un chiffre sont considérées comme des horodatages de la ligne d'historique précédente. Ces horodatages sont facultativement affichés en fonction de la valeur de la variable HISTTIMEFORMAT. Lorsqu'un interpréteur interactif termine, les HISTSIZE dernières lignes de la file d'historique sont copiées dans le fichier HISTFILE. Si l'option d'interpréteur histappend est activée (consultez la description de shopt dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous), les lignes sont ajoutées au fichier d'historique, sinon le fichier est écrasé. Si HISTFILE est inexistante ou si le fichier d'historique n'est pas accessible en écriture, l'historique n'est pas sauvegardé. Si la variable HISTTIMEFORMAT est configurée, les horodatages sont écrits dans le fichier d'historique, repérés par le caractère de commentaire d'historique, afin d'être conservés au fur et à mesure des sessions de l'interpréteur. Le caractère de commentaire d'historique est utilisé pour distinguer l'horodatage des autres lignes de l'historique. Après la sauvegarde de l'historique, le fichier d'historique est tronqué pour ne pas contenir plus de HISTFILESIZE lignes. Si HISTFILESIZE n'existe pas, aucune troncature n'est effectuée.

La commande interne fc (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) permet d'afficher, d'éditer ou de ré-exécuter une partie de la file d'historique. La commande interne history permet d'afficher la file d'historique et de manipuler le fichier d'historique. Quelque soit le mode d'édition en ligne de commande, des commandes de recherche donnent accès à la file d'historique.

L'interpréteur permet de configurer quelles commandes seront sauvegardées dans la file d'historique. Les variables HISTCONTROL et HISTIGNORE peuvent être configurées pour conduire l'interpréteur à ne sauvegarder qu'un sous-ensemble des commandes saisies. L'option d'interpréteur cmdhist, si activée, conduit l'interpréteur à essayer de sauvegarder chaque ligne d'une commande multiligne dans le même élément de l'historique, en ajoutant des points-virgules si nécessaire pour préserver l'exactitude de la syntaxe. L'option d'interpréteur lithist conduit l'interpréteur à sauvegarder les commandes avec des changements de ligne incorporés plutôt que des points-virgules. Consultez ci-dessous la description de la commande interne shopt dans COMMANDES INTERNES DE L'INTERPRÉTEUR pour des détails sur la création et la destruction des options d'interpréteur.

L'interpréteur propose des possibilités de développement de l'historique qui sont semblables à celles de csh. Ce paragraphe décrit quelles syntaxes sont disponibles. Cette fonctionnalité est activée par défaut dans les interpréteurs interactifs et peut être désactivée en utilisant l'option \+H de la commande interne set (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les interpréteurs non interactifs n'effectuent pas de développement d'historique par défaut.

Le développement de l'historique permet d'insérer des mots de la file d'historique dans le flux de saisie, facilitant la répétition de commandes, l'insertion des arguments d'une ligne antérieure dans la saisie en cours ou la correction rapide d'erreurs dans les commandes précédentes.

Le développement de l'historique est effectué immédiatement après la lecture d'une ligne complète, avant que l'interpréteur ne la décompose en mots. Il se déroule en deux parties. La première consiste à déterminer la ligne de la file d'historique à utiliser pour les substitutions, la seconde permet de sélectionner les parties de la ligne à inclure dans la nouvelle ligne. La ligne sélectionnée dans l'historique est l'événement et les parties de cette ligne à réutiliser sont des mots. Plusieurs modificateurs permettent de manipuler les mots sélectionnés. La ligne est découpée en mots de la même façon que lors de la lecture d'une saisie, ainsi plusieurs mots séparés par des métacaractères et encadrés par des guillemets simples sont considérés comme un unique mot. Le développement de l'historique est introduit par l'apparition du caractère de développement, qui est ! par défaut. Seule la contre-oblique (\) et les guillemets simples permettent de protéger le caractère de développement de l'historique.

Plusieurs caractères empêchent le développement de l'historique s'ils se trouvent immédiatement après le caractère de développement de l'historique, même s'il n'est pas protégé : espace, tabulation, changement de ligne, retour chariot et =. Si l'option d'interpréteur extglob est activée, ( empêchera aussi le développement.

Plusieurs options d'interpréteur, configurables avec la commande interne shopt, permettent d'ajuster le comportement du développement de l'historique. Si l'option d'interpréteur histverify est activée (consultez la description de la commande interne shopt ci-dessous) et si readline est utilisée, les substitutions d'historique ne sont pas transmises tout de suite à l'analyseur de l'interpréteur. À la place, la ligne développée est rechargée dans le tampon d'édition de readline pour permettre des modifications ultérieures. Si readline est utilisée et si l'option histreedit est activée, une substitution d'historique qui échoue est rechargée dans la mémoire tampon de readline pour correction. L'option -p de la commande interne history peut servir à examiner ce qu'une substitution donnera avant de l'employer réellement. L'option -s de la commande interne history permet d'ajouter des commandes à la fin de la file d'historique sans les avoir effectivement exécutées, afin qu'elles soient disponibles pour des rappels ultérieurs.

L'interpréteur offre le contrôle des divers caractères utilisés par le mécanisme de développement de l'historique (consultez la description de histchars ci-dessus dans Variables de l'interpréteur). L'interpréteur utilise le caractère de commentaire d'historique pour repérer l'horodatage lors de l'écriture du fichier d'historique.

30.1. Indicateur d'événement ▲

30.2. Indicateurs de mots ▲

30.3. Modificateurs ▲

Sauf indication contraire, chaque commande interne décrite dans ce paragraphe comme acceptant des options précédées par - accepte également la notation -- pour signaler la fin des options. Les commandes internes :, true, false et test n'acceptent aucune option et -- est ignoré. Les commandes internes exit, logout, break, continue, let et shift acceptent et traitent les arguments commençant par - sans avoir besoin de --. Les autres commandes internes qui acceptent les arguments mais qui ne sont pas déclarés explicitement comme acceptant des options considèrent les arguments commençant par - comme des options non valides, donc -- est obligatoire pour éviter cette interprétation.

• : [arguments] Sans effet ; cette commande ne fait rien d'autre que développer les arguments et effectuer toute redirection indiquée. Un code final de zéro est renvoyé.
• .  fichier [arguments]
• source fichier [arguments] Lit et exécute les commandes contenues dans fichier avec l'environnement de l'interpréteur actuel, puis renvoie l'état final de la dernière commande exécutée dans 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. Lorsqu'il est recherché dans PATH le fichier n'a pas besoin d'être exécutable. Lorsque bash n'est pas en mode posix, le répertoire de travail actuel est finalement examiné 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. 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 chacun des noms pour lesquels aucune valeur n'est 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 ...]
      Reprend 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] [-lpsvPSV]
• 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 commande_readline Affiche les associations de touches readline actuelles et les raccourcis de fonctions, associe une suite de touches à une fonction ou une macro readline ou crée une variable readline. Chaque argument qui n'est pas une option est une commande comme elle devrait apparaître dans .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 :

• -m jeu_de_raccourcis
      Utiliser le jeu_de_raccourcis comme jeu de raccourcis devant être concerné par les raccourcis ultérieurs. Les noms de jeux_de_raccourcis possibles sont emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-move, vi-command et vi-insert. vi est équivalent à vi-command ; emacs est équivalent à emacs-standard.
• -l
      Afficher la liste des noms de toutes les fonctions readline.
• -p
      Afficher les noms des fonctions readline et leurs raccourcis de façon à pouvoir les relire.
• -P
      Afficher les noms des fonctions readline et leurs raccourcis.
• -s
      Afficher les suites de touches readline associées aux macros et les chaînes correspondantes, de façon à pouvoir les relire.
• -S
      Afficher les suites de touches readline associées aux macros et les chaînes correspondantes.
• -v
      Afficher les noms des variables readline et leurs valeurs de façon à pouvoir les relire.
• -V
      Afficher les noms des variables readline et leurs valeurs.
• -f fichier
      Lire les raccourcis clavier dans fichier.
• -q fonction
      Rechercher les touches permettant d'appeler la fonction indiquée.
• -u fonction
      Dissocier toutes les touches associées à fonction.
• -r suite_de_touches
      Supprimer tout raccourci actuel pour la suite_de_touches.
• -x suite_de_touches:commande_de_l'interpréteur
      Conduire la commande_de_l'interpréteur à être exécutée chaque fois que la suite_de_touches est saisie. Quand la commande_de_l'interpréteur est exécutée, l'interpréteur configure la variable READLINE_LINE au contenu du tampon de ligne de readline et la variable READLINE_POINT à la position actuelle du curseur d'insertion. Si la commande exécutée modifie les valeurs de READLINE_LINE ou READLINE_POINT, ces nouvelles valeurs seront prises en considération dans l'état d'édition.

La valeur renvoyée est 0, à moins qu'une option inconnue ne soit indiquée ou qu'une erreur ne se soit produite.

• break [n]
      Sort d'une boucle for, while, until ou select. Si n est indiqué, sort de n niveaux de boucles. n doit être (>= 1. Si n est supérieur au nombre de boucles imbriquées, on sort de l'ensemble d'entre elles. La valeur renvoyée est 0, à moins que n ne soit pas plus grand ou égal à 1.
• builtin commande_interne [arguments]
      Exécute la commande interne de l'interpréteur indiquée, en lui passant les arguments, puis renvoie 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]
      Renvoie 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]
      Remplace le répertoire de travail actuel par rép. La variable HOME est la valeur par défaut de rép. La variable CDPATH définit des chemins de recherche pour trouver le répertoire contenant rép. Les répertoires possibles y sont fournis dans une liste séparées par des deux-points « : ». Un nom de répertoire vide 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 indique de n'employer que la structure de répertoires physiques au lieu de suivre les liens symboliques (consultez aussi l'option -P de la commande interne set) l'option -L force à suivre les liens symboliques. 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 reverra un état d'échec. Un argument - est équivalent à $OLDPWD. 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. La valeur renvoyée est vrai si le changement de répertoire a réussi, faux sinon.
• command [-pVv] commande [arguments ...]
      Lance la commande avec les arguments indiqués, mais en simplifiant le processus habituel de recherche des commandes. Seules les commandes internes et 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 commande interne est l'état final de commande.
• compgen [option] [mot]
      Produit 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] [-DE] [-A action] [-G globpat] [-W liste_de_mots] [-F fonction] [-C commande]
      
  [-X motif_filtre] [-P préfixe] [-S suffixe] nom [nom ...]
• complete -pr [-DE] [nom ...] Indique comment les arguments de chaque nom doivent être complétés. 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 à 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 restantes et les actions devraient s'appliquer à la commande de complètement « vide », c'est-à-dire le complètement essayé sur une ligne vide.
  
  Le processus d'application de ces spécifications de complètement, lorsqu'un complètement de mot est tenté, est décrit ci-dessus dans Complètement programmable.
  
  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.

• -o option-complètement
          L'option-complètement commande plusieurs aspects du comportement des spécifications de complètement au-delà de la simple production de complètement. option-complètement peut être l'une des suivantes :

• bashdefault
          Effectuer le reste des complètements par défaut de bash si la spécification de complètement ne produit aucune correspondance.
• default
          Utiliser le complètement de nom de fichier par défaut de readline si la spécification de complètement ne produit aucune correspondance.
• dirnames
          Effectuer le complètement de nom de répertoire si la spécification de complètement ne produit aucune correspondance.
• filenames
          Indiquer à readline que la spécification de complètement produit des noms de fichiers, ainsi il peut effectuer tout traitement spécifique aux noms de fichiers (comme ajouter une barre oblique aux noms de répertoires, protéger les caractères spéciaux ou supprimer les espaces de fin de ligne). Destinée à être utilisée avec les fonctions de l'interpréteur.
• nospace
          Indiquer à readline de ne pas ajouter une espace (comportement par défaut) aux mots complétés en fin de ligne.
• plusdirs
          Après création de toutes les correspondances définies par la spécification de complètement, une tentative de complètement de nom de répertoire est effectuée et toutes les correspondances sont ajoutées aux résultats des autres actions.
• -A action
          L'action peut être l'une des suivantes pour produire une liste des complètements possibles :

• alias
          Noms d'alias. Peut également être indiquée avec -a.
• arrayvar
          Noms de variable de type tableau.
• binding
          Noms de raccourci clavier readline.
• builtin
          Noms de commandes internes de l'interpréteur. Peut également être indiquée avec -b.
• command
          Noms de commande. Peut également être indiquée avec -c.
• directory
          Noms de répertoire. Peut également être indiquée avec -d.
• disabled
          Noms de commandes internes de l'interpréteur désactivées.
• enabled
          Noms de commandes internes de l'interpréteur activées.
• export
          Noms de variables de l'interpréteur exportées. Peut également être indiquée avec -e.
• file
          Noms de fichier. Peut également être indiquée avec -f.
• function
          Noms de fonctions de l'interpréteur.
• group
          Noms de groupe. Peut également être indiquée avec -g.
• helptopic
          Sujets de l'aide acceptés par la commande interne help.
• hostname
          Noms de machine tels qu'ils sont extraits du fichier indiqué par la variable de l'interpréteur HOSTFILE.
• job
          Noms de tâche si le contrôle des tâches est actif. Peut également être indiquée avec -j.
• keyword
          Mots réservés de l'interpréteur. Peut également être indiquée avec -k.
• running
          Noms de tâches en cours d'exécution si le contrôle des tâches est actif.
• service
          Noms de service. Peut également être indiquée avec -s.
• setopt
          Arguments corrects de l'option -o de la commande interne set.
• shopt
          Noms des options d'interpréteur acceptées par la commande interne shopt.
• signal
          Noms de signaux.
• stopped
          Noms de tâches suspendues si le contrôle des tâches est actif.
• user
          Noms d'utilisateur. Peut également être indiquée avec -u.
• variable
          Noms de toutes les variables de l'interpréteur. Peut également être indiquée avec -v.
• -C commande
          La commande est exécutée dans un environnement de sous-interpréteur et sa sortie est utilisée comme complètements possibles.
• -F fonction
          La fonction de l'interpréteur est exécutée dans l'interpréteur actuel. Lorsqu'elle finit, les complètements possibles sont récupérés à partir de la valeur de la variable de type tableau COMPREPLY.
• -G globpat
          Le motif de développement des chemins globpat est développé pour produire les complètements possibles.
• -P préfixe
          préfixe est ajouté au début de chaque complètement possible après application de toutes les autres options.
• -S suffixe
          suffixe est ajouté à chaque complètement possible après application de toutes les autres options.
• -W liste_de_mots
          La liste_de_mots est découpée en utilisant les caractères de la variable spéciale IFS comme délimiteurs et chaque mot résultant est développé. Les complètements possibles sont les éléments de la liste résultante qui correspondent au mot en cours de complètement.
• -X motif_filtre
          motif_filtre est un motif utilisé pour le développement des chemins. Il est appliqué à la liste des complètements possibles produite par les options et arguments précédents et chaque complètement correspondant à motif_filtre est supprimé de la liste. Un ! au début du motif_filtre inverse le motif ; dans ce cas, tout complètement qui ne correspond pas à motif_filtre est supprimé.

La valeur renvoyée est vrai, sauf si une option incorrecte a été fournie, si une option comme -p ou -r a été fournie sans un nom d'argument, si une tentative a été faite pour supprimer une spécification de complètement pour un nom pour lequel il n'existe pas de spécification, ou si une erreur est survenue lors de l'ajout d'une spécification de complètement.

• compopt [-o option] [-DE] [+o option] [nom]
      Modifie les options de complétion 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, affiche les options de complétion pour chaque nom ou pour le complètement actuel. Les valeurs possible d'option sont les options valables décrites ci-dessus pour la commande interne complete. L'option -D indique que les options restantes et les actions 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 restantes et les actions devraient s'appliquer à la commande de complètement par « vide » ; c'est-à-dire le complètement essayé sur une ligne vide.
  
  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]
      Reprend l'exécution à l'itération suivante d'une boucle for, while, until ou encore select. Si n est indiqué, reprend 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 plus grand ou égal à 1.
• declare [-aAfFgilrtux] [-p] [nom[=valeur] ...]
• typeset [-aAfFgilrtux] [-p] [nom[=valeur] ...] Déclare des variables ou leur fournit des attributs. Si aucun nom n'est indiqué, affiche 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 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ù la fonction est définie 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. Les options suivantes permettent de restreindre l'affichage aux variables dotées de certains attributs ou de configurer les attributs des variables :

• -a
      Chaque nom est une variable de type tableau indicé (consultez Tableaux ci-dessus).
• -A
      Chaque nom est une variable de type tableau associatif (consultez Tableaux ci-dessus).
• -f
      Utiliser seulement les noms de fonctions.
• -i
      La variable est traitée comme un entier ; l'évaluation arithmétique (consultez ÉVALUATION ARITHMÉTIQUE ci-dessus) est effectuée lorsqu'une valeur est affectée à la variable.
• -l
      Quand cette variable contient une valeur, toutes les majuscules seront converties en minuscules. L'attribut majuscule est désactivé.
• -r
      Rendre les noms accessibles en lecture seule. Plus aucune valeur ne pourra leur être affectée et ils ne pourront plus être détruits.
• -t
      Donner à chaque nom l'attribut trace. Les fonctions tracées héritent des captures de DEBUG et RETURN de l'interpréteur appelant. L'attribut trace n'a pas de signification spéciale pour les variables.
• -u
      Quand cette variable contient une valeur, toutes les minuscules seront converties en majuscules. L'attribut minuscule est désactivé.
• -x
      Marquer les noms pour qu'ils soit exportés dans l'environnement des commandes ultérieures.

En utilisant « + » à la place de « - », l'attribut correspondant est désactivé, aux exceptions que +a ne peut pas être utilisé pour détruire une variable tableau et que +r n'enlèvera pas l'attribut lecture seule. Quand utilisé dans une fonction, chaque nom devient local, comme avec la commande local sauf si l'option -g est fournie. Si un nom de variable est suivi par =valeur, la valeur de cette variable est configurée à valeur. La valeur renvoyée est 0, sauf si une option incorrecte est rencontrée, si une tentative est faite de définir une fonction en utilisant

-f truc=bidule, si une tentative est faite d'affecter une valeur à une variable en lecture seule, si une tentative est faite d'affecter une valeur à une variable tableau sans employer la syntaxe d'affectation composée (consultez Tableaux ci-dessus), si un des noms n'est pas un nom correct pour une variable de l'interpréteur, si une tentative est faite de supprimer l'attribut lecture-seule d'une variable en lecture seule, si une tentative est faite de supprimer l'attribut tableau d'une variable tableau, ou si une tentative est faite avec -f d'afficher une fonction inexistante.

• dirs [+n] [-n] [-clpv]
      Sans option, affiche 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.

• +n
      Afficher le n-ième élément de la liste fournie par dirs, lorsqu'appelé sans options, en comptant à partir de la gauche en commençant à zéro.
• -n
      Afficher le n-ième élément de la liste fournie par dirs, lorsqu'appelé sans options, en comptant à partir de la droite en commençant à zéro.
• -c
      Effacer la liste des répertoires en les supprimant tous.
• -l
      Produire une liste plus longue ; le format d'affichage par défaut utilise le tilde pour représenter le répertoire d'accueil.
• -p
      Afficher la pile des répertoires avec un élément par ligne.
• -v
      Afficher la pile des répertoires avec un élément par ligne, en préfixant chaque entrée avec son numéro d'indice dans la pile.

La valeur renvoyée est 0, sauf si une option incorrecte a été fournie ou si l'indice n dépasse la longueur de la pile des répertoires.

• disown [-ar] [-h] [tâche ...]
      Sans options, chaque tâche est supprimée de la table des tâches actives. Si aucune tâche n'est précisée, et que ni -a ni -r n'est fournie, la notion d'interpréteur de 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 indiquée et que ni l'option -a ni l'option -r n'est fournie, la tâche actuelle est concernée. 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 ...]
      Affiche les arguments, séparés par des espaces, suivis par un saut de ligne. La valeur renvoyée est toujours 0. Si -n est indiqué, le changement de ligne final est supprimé. Si l'option -e est indiquée, l'interprétation des caractères suivants d'échappement par une contre-oblique est activée. L'option -E désactive l'interprétation de ces caractères d'échappement, 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 d'échappement. echo n'interprète pas -- comme signifiant la fin des options. echo reconnaît les suites de caractères d'échappement suivantes :

• \a
      alerte (alarme) ;
• \b
      effacement arrière (« backspace ») ;
• \c
      supprime tout affichage suivant ;
• \e
• \E
      caractère d'échappement ;
• \f
      saut de page (« form feed ») ;
• \n
      saut de ligne (« new line ») ;
• \r
      retour chariot (« carriage return ») ;
• \t
      tabulation horizontale ;
• \v
      tabulation verticale ;
• \\
      contre-oblique ;
• \0nnn
      le caractère 8 bits dont la valeur en octal est nnn (zéro à trois chiffres octaux) ;
• \xHH
      le caractère 8 bits dont la valeur hexadécimale est HH (un ou deux chiffres hexadécimaux) ;
• \uHHHH
      le caractère Unicode (ISO/IEC 10646) dont la valeur hexadécimale est HHHH (un à quatre chiffres hexadécimaux) ;
• \UHHHHHHHH
      le caractère Unicode (ISO/IEC 10646) dont la valeur hexadécimale est HHHHHHHH (un à huit chiffres hexadécimaux) ;
• enable [-a] [-dnps] [-f fichier] [nom ...]
      Active ou désactive 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. 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. La valeur renvoyée est 0, sauf si nom n'est pas une commande interne ou qu'il y a 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 vides, 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éro-ième argument fourni a 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éro-iè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, auquel cas une erreur est renvoyée. Un interpréteur interactif renvoie une erreur si le fichier ne peut pas être exécuté. 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 est affichée indiquant l'ensemble des noms exportés dans cet interpréteur. L'option -n conduit à supprimer l'attribut d'exportation de chacune des 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] Commande épinglée (« fix command »). Dans la première forme, une plage de commandes, entre la première et la dernière, est sélectionné dans la file d'historique. 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). 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 ou 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. 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]
      Reprend 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, 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]
      Affiche 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.

• -d
      Afficher une courte description de chaque motif.
• -m
      Afficher la description de chaque motif dans un format du type pages de manuel.
• -s
      Afficher seulement un court synopsis d'utilisation de chaque motif.

L'état renvoyé est 0, sauf si aucune commande ne correspond au motif.

• history [n]
• history -c
• history -d nombre
• history -anrw [fichier]
• history -p argument [argument ...]
• history -s argument [argument ...] Sans options, affiche 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 vide, 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 :

• -c
      Effacer la file de l'historique en supprimant tous les éléments.
• -d nombre
      Détruire l'élément de l'historique à la position nombre.
• -a
      Ajouter les « nouvelles » lignes d'historiques (celles créées depuis le début de la session actuelle de bash) dans le fichier d'historique.
• -n
      Lire dans le fichier d'historique les lignes non encore lues et les ajouter à la file d'historique actuelle. Il s'agit des lignes qui ont été ajoutées dans le fichier d'historique depuis le début de la session bash.
• -r
      Lire le contenu du fichier et l'utiliser comme historique actuel.
• -w
      Écrire dans le fichier l'historique actuel, en écrasant le contenu précédent.
• -p
      Effectuer la substitution d'historique sur les arguments suivants et afficher le résultat sur la sortie standard. Ne pas mémoriser les résultats dans la file d'historique. Chaque argument doit être protégé pour désactiver le développement normal de l'historique.
• -s
      Conserver les arguments dans la file d'historique comme un unique élément. La dernière commande de la file d'historique est supprimée avant que les arguments ne soient ajoutés.

Si la variable HISTTIMEFORMAT existe, les informations d'horodatage associées à chaque élément de l'historique sont écrites dans le fichier d'historique, repérés par le caractère de commentaire d'historique. Quand le fichier d'historique est lu, les lignes commençant par le caractère de commentaire d'historique suivi immédiatement par un chiffre sont considérés comme des horodatages de la ligne d'historique précédente. La valeur renvoyée est 0, sauf si une option incorrecte est fournie, si une erreur se produit durant la lecture ou l'écriture du fichier, si un nombre incorrect est fourni comme argument à -d ou si le développement de l'historique fourni en argument à -p échoue.

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

• -l
      Afficher les PID, en plus des informations normales.
• -n
      Afficher uniquement des informations sur les tâches dont l'état a changé depuis la dernière notification de leur état à l'utilisateur.
• -p
      Afficher uniquement le PID du meneur du groupe de processus de la tâche.
• -r
      Restreindre l'affichage aux tâches en cours d'exécution.
• -s
      Restreindre l'affichage aux tâches suspendues.

Si une tâche est indiquée, l'affichage est restreint aux informations relatives à cette tâche. L'état renvoyé est 0, sauf si une option incorrecte est rencontrée ou si une tâche incorrecte est fournie.

Si l'option -x est fournie, jobs remplace toute tâche trouvée dans la commande ou dans ses arguments avec les Process Group ID correspondant, puis il exécute la commande en lui transmettant les arguments et en renvoyant son état final.

• kill [-s signal | -n num-signal | -signal] [pid | tâche] ...
• kill -l [signal | état_final] Envoie 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. 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 ci-dessus). 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. 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
      Termine un interpréteur de connexion.
• mapfile [-n nombre] [-O origine] [-s nombre] [-t] [-u fd] [-C rappel] [-c quantum] [tableau]
• readarray [-n nombre] [-O origine] [-s nombre] [-t] [-u fd] [-C rappel] [-c quantum] [tableau] Lit les lignes depuis l'entrée standard vers la variable de type tableau indicé tableau, ou depuis le descripteur de fichier fd si l'option -u est fournie. La variable MAPFILE est le tableau par défaut. Les options, si fournies, ont les significations suivantes :

• -n
      Copier au plus nombre lignes. Si nombre est 0, toutes les lignes sont copiées.
• -O
      Commencer l'affectation de tableau à l'indice origine. L'indice par défaut est 0.
• -s
      Supprimer les nombre premières lignes lues.
• -t
      Éliminer le changement de ligne de chaque ligne lue.
• -u
      Lire les lignes à partir du descripteur de fichier fd plutôt que depuis l'entrée standard.
• -C
      Évaluer rappel à chaque fois que quantum lignes sont lues. L'option -c précise le quantum.
• -c
      Préciser le nombre de lignes entre chaque appel à rappel.

Si -C est précisé sans -c, le quantum par défaut est 5000. Quand rappel est évalué, l'indice du prochain élément de tableau à affecter et la ligne à affecter à cet élément sont fournis en arguments supplémentaires. rappel est évalué après la lecture de la ligne, mais avant l'affectation de l'élément de tableau.

Si aucune origine explicite n'est fournie, mapfile effacera tableau avant de lui affecter des valeurs.

mapfile termine avec succès sauf si une option ou un de ses arguments n'est pas valable, ou si tableau n'est pas valable, n'est pas un tableau indicé ou si son affectation est impossible.

• popd [-n] [+n] [-n]
      Enlève des éléments de la pile des répertoires. Sans arguments, seul le répertoire du sommet de la pile est éliminé et un cd est effectué en direction du nouveau répertoire au sommet. Les argument, si fournis, ont les significations suivantes :

• -n
      Empêcher le changement normal de répertoire lors de la suppression d'un répertoire de la pile. Seule la pile est manipulée.
• +n
      Supprimer le n-ième élément de la liste affichée par dirs, en comptant depuis la gauche à partir de zéro. Par exemple :

popd +0 enlève le premier répertoire,

popd +1 le second.

• -n
      Supprimer le n-ième élément de la liste affichée par dirs, en comptant depuis la droite à partir de zéro. Par exemple :

popd -0 supprime le dernier répertoire et

popd -1 l'avant-dernier.

Si la commande popd réussit, un dirs est effectué et l'état renvoyé est 0. popd renvoie faux si une option incorrecte est trouvée, si la pile de répertoires est vide, si le répertoire indiqué est absent de la pile ou si le changement de répertoire a échoué.

• printf [-v var] format [arguments]
      Écrit 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 contenant trois types de caractères : normaux, qui sont simplement copiés sur la sortie standard, les caractères d'échappement qui sont convertis puis copiés sur la sortie standard et les spécifications de format qui conduisent chacune à l'affichage des arguments successifs. En plus des spécifications de format standard de printf(1), printf interprète les extensions suivantes :

• %b
      conduit printf à développer les suites de caractères d'échappement par contre-oblique se trouvant dans l'argument correspondant (à l'exception de \c qui termine la sortie, des contre-obliques dans \, \" et \? qui ne sont pas supprimées et des suites de caractères d'échappement pour les nombres en octal commençant par \0 qui peuvent contenir jusqu'à quatre chiffres) ;
• %q
      conduit printf à afficher l'argument correspondant dans un format réutilisable en entrée de l'interpréteur ;
• %(formatdate)T
      conduit printf à afficher la chaîne date-heure résultant de l'utilisation de formatdate en tant que chaîne de format pour strftime(3). L'argument correspondant est un entier représentant le temps en seconde écoulé depuis epoch. Deux valeur particulières d'argument peuvent être utilisées : -1 représente l'heure actuelle et -2 l'heure à laquelle l'interpréteur a été invoqué.

Les arguments des spécificateurs de format qui ne sont pas des chaînes sont traités comme des constantes C, sauf qu'un signe plus ou moins est permis au début, et que si le premier caractère est un guillemet simple ou double, la valeur est la valeur ASCII du caractère suivant.

Le format est réutilisé jusqu'à consommer tous les arguments. Si le format demande plus d'arguments que fournis, les spécifications supplémentaires se comportent comme si des valeurs zéro ou des chaînes vides, suivant le besoin, avaient été fournies. La valeur renvoyée est zéro en cas de succès, différente de zéro en cas d'échec.

• pushd [-n] [+n] [-n]
• pushd [-n] [rép] Ajoute un répertoire au sommet de la pile des répertoires ou effectue une rotation dans la pile, en ramenant le répertoire actuel au sommet. Sans argument, cette commande échange les deux répertoires au sommet et renvoie 0, sauf si la pile est vide. Les arguments, si fournis, ont les significations suivantes :

• -n
      Empêcher le changement normal de répertoire lors d'un ajout dans la pile. Seule la pile est manipulée.
• +n
      Effectuer une rotation dans la pile, de façon à amener au sommet le n-ième répertoire (de la liste affichée par dirs, en comptant depuis la gauche à partir de zéro).
• -n
      Effectuer une rotation dans la pile, de façon à amener au sommet le n-ième répertoire (de la liste affichée par dirs, en comptant depuis la gauche à partir de zéro).
• rép
      Ajouter le répertoire rép au sommet de la pile de répertoires en faisant le nouveau répertoire de travail actuel.

Si la commande pushd réussit, un dirs est aussi effectué. Avec la première forme, pushd renvoie 0 sauf si le déplacement vers rép échoue. Avec la seconde forme, pushd renvoie 0, sauf si la pile est vide, si un élément inexistant dans la pile est indiqué ou si le changement de répertoire vers le nouveau répertoire indiqué échoue.

• pwd [-LP]
      Affiche 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 fd] [nom ...]
      Une ligne est lue depuis l'entrée standard ou à partir du descripteur de fichier fd fourni en argument à l'option -u, puis le premier mot de cette ligne est affecté au premier nom, le second mot au second nom, et ainsi de suite avec les mots restants et leurs séparateurs 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. Le caractère contre-oblique (\) permet de supprimer toute signification spéciale pour le caractère suivant et autorise la continuation de lignes. Les options, si fournies, ont les significations suivantes :

• -a tableau
      Les mots sont affectés aux indices successifs d'une variable tableau de nom tableau, en commençant à 0. tableau est détruit avant que de nouvelles valeurs ne soient affectées. Les autres arguments nom sont ignorés.
• -d délimiteur
      Le premier caractère de délimiteur est utilisé pour terminer la ligne de saisie, plutôt qu'un changement de ligne.
• -e
      Si l'entrée standard provient d'un terminal, la bibliothèque readline (consultez READLINE ci-dessus) est utilisée pour obtenir la ligne. Readline utilise les configurations d'édition en cours (ou par défaut, si l'édition de ligne n'était pas préalablement active).
• -i texte
      Si readline est utilisée pour lire la ligne, texte est placé dans le tampon d'édition avant le début de l'édition.
• -n nb_car
      read s'arrête après avoir lu nb_car caractères plutôt que d'attendre une ligne complète en entrée, mais un délimiteur est respecté si moins de nb_car caractères ont été lus avant le délimiteur.
• -N nb_car
      read s'arrête après avoir lu exactement nb_car caractères plutôt que d'attendre une ligne complète en entrée, sauf si une fin de fichier (EOF) est rencontrée ou si read dépasse son délai de réponse. Les délimiteurs rencontrés en entrée ne sont pas pris en compte et n'entraînent pas la fin de read avant que nb_car caractères n'aient été lus.
• -p invite
      Afficher invite sur la sortie d'erreur standard, sans caractère final de changement de ligne, avant d'essayer de lire toute nouvelle saisie. L'invite est affichée seulement si l'entrée vient d'un terminal.
• -r
      La contre-oblique n'agit pas comme un caractère d'échappement. La contre-oblique est considérée comme faisant partie de la ligne. En particulier une contre-oblique suivie d'un changement de ligne n'est pas considérée comme une continuation de ligne.
• -s
      Mode silencieux. Si une entrée arrive à partir d'un terminal, les caractères ne sont pas affichés.
• -t délai
      Conduire read à expirer et renvoyer un échec si une ligne complète en entrée n'a pas été lue dans le délai en secondes. délai est un nombre décimal avec éventuellement des chiffres après la virgule (NdT : point en l'occurrence). Cette option n'est effective que si read lit l'entrée à partir d'un terminal, d'un tube, ou depuis un autre fichier spécial ; elle n'a aucun effet lors de la lecture d'un fichier normal. Si délai est nul, read termine avec succès si une entrée est disponible pour le descripteur de fichier indiqué, en échec sinon. L'état final est supérieur à 128 si le délai est dépassé.
• -u fd
      Lire l'entrée à partir du descripteur de fichier fd.

Si aucun nom n'est fourni, la ligne lue est affectée entièrement à la variable REPLY. Le code renvoyé est zéro, sauf si une fin de fichier (EOF) est rencontrée, si read dépasse son délai de réponse (auquel cas le code renvoyé est plus grand que 128) ou si un descripteur de fichier incorrect est fourni en argument de -u.

• 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]
      Termine une fonction en renvoyant la valeur indiquée par n. Si n est omis, la valeur renvoyée est celle de la dernière commande exécutée dans le corps de la fonction. Si utilisée hors d'une fonction, mais durant 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 utilisée hors d'une fonction ou d'un script exécuté par ., l'état renvoyé est faux. 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, le nom et la valeur de chacune des variables de l'interpréteur sont affichés 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. Dans le 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 :

• -a
          Marquer automatiquement des variables et fonctions modifiées ou créées pour qu'elles soient exportées dans l'environnement des commandes exécutées ultérieurement.
• -b
          Signaler l'état des tâches terminées en arrière-plan immédiatement, plutôt que d'attendre l'affichage de la prochaine invite de base. N'est effectif que si le contrôle des tâches est activé.
• -e
          Terminer immédiatement si une conduite (qui peut être réduite à une unique commande simple), une commande de sous-interpréteur entre parenthèses, ou une liste de commandes entre accolades (consultez GRAMMAIRE DE L'INTERPRÉTEUR ci-dessus) termine avec un état différent de zéro. L'interpréteur ne termine pas si la commande qui échoue fait partie d'une liste de commandes immédiatement suivie par un mot-clef while ou until, d'un test suivant les mots réservés if ou elif, d'une commande exécuté dans une liste && ou || sauf si la commande est située après le dernier && ou ||, d'une commande de conduite à l'exception de la dernière, ou si la valeur renvoyée par la commande est inversée par !. Une capture sur ERR, si existante, est exécutée avant que l'interpréteur ne se termine. Cette option s'applique à l'environnement de l'interpréteur ainsi qu'à l'environnement de chaque sous-interpréteur individuellement (consultez ENVIRONNEMENT D'EXÉCUTION DES COMMANDES ci-dessus), et peut conduire des sous-interpréteurs à se terminer avant d'y avoir exécuté toutes les commandes.
• -f
          Désactiver le développement des chemins.
• -h
          Mémoriser l'emplacement des commandes lors de leur exécution. Activée par défaut.
• -k
          Tous les arguments sous la forme d'affectations sont placés dans l'environnement d'une commande, et non pas seulement ceux qui précèdent le nom de la commande.
• -m
          Mode supervision. Le contrôle des tâches est activé. Cette option est activée par défaut pour les interpréteurs interactifs sur les systèmes qui le permettent (consultez CONTRÔLE DES TÂCHES ci-dessus). Les processus en arrière-plan sont exécutés dans un groupe de processus séparé et une ligne contenant leurs états finaux est affichée lorsqu'ils terminent.
• -n
          Lecture de commandes sans exécution. Cela peut être utilisé pour rechercher les erreurs de syntaxe dans un script. Cette option est ignorée par les interpréteurs interactifs.
• -o nom_d_option
          Le nom_d_option est l'un des suivants :

• allexport
          Identique à -a.
• braceexpand
          Identique à -B.
• emacs
          Utiliser une interface d'édition des lignes de commande « à la Emacs ». C'est le comportement activé par défaut quand l'interpréteur est interactif, sauf si l'interpréteur est démarré avec l'option --noediting. L'interface d'édition utilisée par read -e est modifiée également.
• errexit
          Identique à -e.
• errtrace
          Identique à -E.
• functrace
          Identique à -T.
• hashall
          Identique à -h.
• histexpand
          Identique à -H.
• history
          Activer l'historique des commandes, comme décrit ci-dessus dans HISTORY. Cette option est activée par défaut dans les interpréteurs interactifs.
• ignoreeof
          Identique à l'exécution de la commande d'interpréteur

IGNOREEOF=10 (consultez Variables de l'interpréteur ci-dessus).

• keyword
          Identique à -k.
• monitor
          Identique à -m.
• noclobber
          Identique à -C.
• noexec
          Identique à -n.
• noglob
          Identique à -f.
• nolog
          Actuellement ignorée.
• notify
          Identique à -b.
• nounset
          Identique à -u.
• onecmd
          Identique à -t.
• physical
          Identique à -P.
• pipefail
          Si existante, la valeur renvoyée par une conduite est la valeur de la dernière commande (la plus à droite) à terminer avec un état final différent de zéro ou zéro si toutes les commandes de la conduite terminent avec succès. Désactivée par défaut.
• posix
          Aligner le comportement de bash sur le standard POSIX, en ce qui concerne les options dont l'action par défaut diffère de ce standard (mode posix).
• privileged
          Identique à -p.
• verbose
          Identique à -v.
• vi
          Utiliser une interface d'édition des lignes de commande « à la vi ». L'interface d'édition utilisée par read -e est modifiée également.
• xtrace
          Identique à -x.
  
  

Si -o est fournie sans nom_d_option, les valeurs actuelles des options sont affichées. Si +o est fournie sans nom_d_option, la série de commandes set permettant de recréer la configuration actuelle d'options est affichée sur la sortie standard.

• -p
          Basculer en mode privilégié. Dans ce mode, les fichiers $ENV et $BASH_ENV ne sont pas traités, les fonctions de l'interpréteur ne sont pas héritées de l'environnement, et les variables SHELLOPTS, BASHOPTS, CDPATH, et GLOBIGNORE, si présentes dans l'environnement, sont ignorées. Si l'interpréteur démarre avec un UID (ou respectivement un GID) effectif différent de son UID (GID) réel et si l'option -p n'est pas fournie, ce comportement est appliqué et l'UID (GID) effectif est positionné à l'UID (GID) réel. Si l'option -p est fournie au démarrage, l'UID (GID) effectif n'est pas modifié. Désactiver cette option conduit à la configuration des UID et GID effectifs à la valeur des UID et GID réels.
• -t
          Terminer après lecture et exécution d'une commande.
• -u
          Considérer les variables inexistantes et les paramètres différents des paramètres spéciaux « @ » et « * » comme des erreurs lors du développement des paramètres. Si un développement de variable inexistante ou de paramètre est tenté, l'interpréteur affiche un message d'erreur et, s'il n'est pas interactif, termine avec un état différent de zéro.
• -v
          Afficher les lignes en entrée de l'interpréteur lorsqu'elles sont lues.
• -x
          Après le développement de chaque commande simple, commande for, commande case, commande select ou commande for arithmétique, afficher la valeur développée de PS4, suivie de la commande et ses arguments développés ou la liste de mots associés.
• -B
          L'interpréteur effectue le développement des accolades (consultez Développement des accolades ci-dessus). Activée par défaut.
• -C
          Si configurée, bash n'écrasera pas un fichier existant avec les opérateurs >, >& et <>. Ce comportement peut être surpassé lors de la création d'un fichier de sortie en utilisant l'opérateur de redirection >| à la place de >.
• -E
          Si configurée, toute capture sur ERR est héritée par les fonctions d'interpréteur, les substitutions de commandes et les commandes exécutées dans un sous-interpréteur. La capture de ERR n'est normalement pas héritée dans de tels cas.
• -H
          Activer le style ! de substitution d'historique. C'est le comportement par défaut lorsque l'interpréteur est interactif.
• -P
          Si configurée, l'interpréteur ne doit pas suivre les liens symboliques en exécutant des commandes comme cd qui modifient le répertoire de travail. Il utilise à la place le répertoire physique. Par défaut bash suit la chaîne logique des répertoires lors des commandes qui modifient le répertoire actuel.
• -T
          Si configurée, toutes les captures de DEBUG et RETURN sont héritées par les fonctions de l'interpréteur, les substitutions de commande et les commandes exécutées dans un sous-interpréteur. Les captures de DEBUG et RETURN ne sont normalement pas héritées dans de tels cas.
• --
          Si aucun argument ne suit cet option, alors les paramètres positionnels sont détruits. Sinon, les paramètres positionnels sont configurés aux arguments, même si certains d'entre eux commencent par un -.
• -
          Marquer la fin des options, tous les arguments restants sont alors affectés aux paramètres positionnels. Les options -x et -v sont désactivées. S'il n'y a pas d'arguments, les paramètres positionnels ne sont pas modifiés.

Par défaut les attributs sont désactivés, sauf indication contraire. En utilisant « + » à la place de « - », les options sont désactivées. Les options peuvent également être fournies en argument lors de l'appel de l'interpréteur. Le jeu actuel des options peut être trouvé dans $-. La valeur renvoyée est toujours vrai, sauf si une option incorrecte est rencontrée.

• shift [n]
      Les paramètres positionnels à partir de n+1 ... sont renommés en $1 .... Les paramètres représentés par les nombres $# jusqu'à $#-n+1 sont détruits. n doit être un entier positif inférieur ou égal à $#. Si n vaut 0, aucun paramètres n'est modifié. Si n est omis, on suppose qu'il vaut 1. Si n est supérieur à $#, les paramètres positionnels ne sont pas modifiés. L'état renvoyé est strictement positif si n est supérieur à $# ou strictement négatif, sinon 0 est renvoyé.
• shopt [-pqsu] [-o] [nom_opt ...]
      Bascule la valeur des variables contrôlant le comportement facultatif de l'interpréteur. Sans option ou avec l'option -p, une liste de toutes les options configurables est affichée, avec l'indication de l'état de chacune d'entre elles. L'option -p conduit à un affichage de la sortie sous une forme susceptible d'être réutilisée en entrée. Les autres options ont les significations suivantes :

• -s
      Activer (créer) chaque nom_opt.
• -u
      Désactiver (détruire) chaque nom_opt.
• -q
      Supprimer la sortie normale (mode silencieux) ; l'état renvoyé indique si nom_opt est existante ou non. Si plusieurs arguments nom_opt sont indiqués avec -q, l'état renvoyé est zéro si tous les nom_opt sont activés ; différent de zéro sinon.
• -o
      Restreindre les valeurs de nom_opt à celles définies pour l'option -o de la commande interne set.

Si l'option -s ou -u est utilisée sans argument nom_opt, l'affichage est limité aux options qui sont respectivement existantes ou non. Sauf indication contraire, les options shopt sont désactivées (détruites) par défaut.

L'état renvoyé lors d'un affichage des options est zéro si tous les nom_opt sont activés, différent de zéro sinon. Lors de la création ou de la destruction d'options, l'état renvoyé est zéro, à moins que nom_opt ne soit pas une option correcte de l'interpréteur.

La liste des options shopt est :

.5v

• autocd
          Si existante, un nom de commande qui est le nom d'un répertoire est exécuté comme s'il était l'argument de la commande interne cd. Cette option n'est utilisée que par les interpréteurs interactifs.
• cdable_vars
          Si existante, un argument de la commande interne cd qui n'est pas un répertoire est supposé être un nom de variable dont la valeur est le répertoire visé.
• cdspell
          Si existante, les erreurs minimes de frappe dans un composant du répertoire en argument de la commande cd seront corrigées. Les erreurs corrigées sont les inversions d'un caractère, un caractère manquant et un caractère en trop. Si une correction est possible, le nom de répertoire corrigé est affiché et la commande est exécuté. Cette option n'est utilisée que par les interpréteurs interactifs.
• checkhash
          Si existante, bash vérifie si une commande trouvée dans la table de hachage existe avant d'essayer de l'exécuter. Si une commande hachée n'existe plus, une recherche normale de chemin est effectuée.
• checkjobs
          Si existante, bash affiche la liste des états de toutes les tâches en cours et arrêtées avant de terminer un interpréteur interactif. Si des tâches sont en cours, la sortie est différée jusqu'à ce qu'une nouvelle sortie soit tentée sans commande intermédiaire (consultez CONTRÔLE DES TÂCHES ci-dessus). L'interpréteur repousse toujours la sortie si des tâches sont arrêtées.
• checkwinsize
          Si existante, bash vérifie la taille de la fenêtre après chaque commande et, au besoin, met à jour les valeurs des variables LINES et COLUMNS.
• cmdhist
          Si existante, bash essaie de sauvegarder les commandes s'étendant sur plusieurs lignes en un seul élément d'historique. Cela facilite l'édition ultérieure de commandes multilignes.
• compat31
          Si existante, bash modifie son comportement de manière compatible à la version 3.1 en respectant les arguments protégés de l'opérateur =~ de commande conditionnelle [[.
• compat32
          Si existante, bash modifie son comportement de manière compatible à la version 3.2 en respectant les comparaisons de chaînes spécifiques aux paramètres linguistiques régionaux lors de l'utilisation des opérateurs < et > de commande conditionnelle [[. Les versions de bash antérieure à 4.1 utilisent la collation ASCII et strcmp(3). bash à partir de la version 4.1 la suite de collation de des paramètres linguistiques régionaux et strcoll(3).
• compat40
          Si existante, bash modifie son comportement de manière compatible à la version 4.0 en respectant les comparaisons de chaînes spécifiques aux paramètres linguistiques régionaux lors de l'utilisation des opérateurs < et > de commande conditionnelle [[ (consultez l'entrée précédente) et l'effet d'interruption de liste de commandes.
• compat41
          Si existante, bash, lorsqu'il est en mode posix, traite le guillemet simple dans l'expansion de paramètre entre guillemets doubles comme un caractère spécial. Les guillemets simples doivent correspondre (et même s'appairer) et les caractères entre guillemets simples sont considérés protégés. C'est le comportement du mode posix de la version 4.1. le comportement par défaut de bash reste le même que dans les versions précédentes.
• direxpand
          Si existante, bash remplace les noms de répertoire par les résultats de développement de mots lors du complètement des noms de fichier. Cela modifie le contenu du tampon d'édition de readline. Sinon, bash essaye de conserver ce que l'utilisateur a tapé.
• dirspell
          Si existante, bash essaie de corriger les erreurs de frappe sur les noms de répertoire lors du complètement de mot si le nom de répertoire initialement fourni n'existe pas.
• dotglob
          Si existante, bash inclut les noms de fichiers commençant par un « . » dans les résultats des développements de chemins.
• execfail
          Si existante, un interpréteur non interactif ne terminera pas s'il ne peut exécuter un fichier indiqué en argument de la commande interne exec. Un interpréteur interactif ne termine pas si exec échoue.
• expand_aliases
          Si existante, les alias sont développés comme décrit ci-dessus, dans ALIAS. Cette option est activée par défaut pour les interpréteurs interactifs.
• extdebug
          Si existante, le comportement attendu par les traceurs est activé :

• 1.
      L'option -F de la commande interne declare affiche le nom du fichier source et le numéro de ligne correspondant à chaque nom de fonction fourni comme argument.
• 2.
      Si la commande lancée par la capture de DEBUG renvoie une valeur différente de zéro, la commande suivante est sautée et n'est pas exécutée.
• 3.
      Si la commande lancée par la capture de DEBUG renvoie la valeur 2 et si l'interpréteur s'exécute dans un sous-programme (une fonction de l'interpréteur ou un script exécuté par les commandes internes . ou source), un appel à return est simulé.
• 4.
      .SM BASH_ARGC et BASH_ARGV sont mises à jour comme expliqué dans leurs descriptions ci-dessus.
• 5.
      Le traçage des fonctions est activé : la substitution de commande, les fonctions de l'interpréteur et les sous-interpréteurs appelés avec ( command ) héritent des captures de DEBUG et RETURN.
• 6.
      Le traçage d'erreur est activé : la substitution de commande, les fonctions de l'interpréteur et les sous-interpréteurs appelés avec ( command ) héritent de la capture de ERR.
• extglob
          Si existante, les fonctionnalités étendues de mise en correspondance décrites ci-dessus dans Développement des chemins sont activées.
• extquote
          Si existante, la protection par $chaîne et $"chaîne" est effectuée à l'intérieur des développements de ${paramètres} entre guillemets doubles. Cette option est activée par défaut.
• failglob
          Si existante, les motifs qui échouent à faire correspondre les noms de fichiers pendant le développement des chemins font qu'ils provoqueront une erreur de développement.
• force_fignore
          Si existante, les suffixes indiqués par la variable de l'interpréteur FIGNORE conduiront des mots à être ignorés lors du complètement de mot, même si les mots ignorés sont les seuls complètements possibles. Consultez VARIABLES DE L'INTERPRÉTEUR ci-dessus pour une description de FIGNORE. Cette option est activée par défaut.
• globstar
          Si existante, le motif ** utilisé dans un contexte de développement des chemins correspondra à tous les fichiers et zéro ou plusieurs répertoires et sous-répertoires. Si le motif est suivi de /, seuls les répertoires et sous-répertoires correspondent.
• gnu_errfmt
          Si existante, les messages d'erreur de l'interpréteur seront écrits dans le format standard GNU des messages d'erreurs.
• histappend
          Si existante, la file d'historique est ajoutée au fichier désigné par la valeur de la variable HISTFILE lorsque l'interpréteur termine, plutôt que d'écraser ce fichier.
• histreedit
          Si existante et si readline est utilisée, un utilisateur peut rééditer une substitution d'historique qui a échoué.
• histverify
          Si existante et si readline est utilisée, le résultat de la substitution d'historique n'est pas transmise immédiatement à l'analyseur de l'interpréteur. À la place, la ligne résultante est chargée dans le tampon d'édition de readline, permettant des modifications ultérieures.
• hostcomplete
          Si existante et si readline est utilisée, bash essayera d'effectuer le complètement des noms de machines lorsqu'un mot contient un @ (consultez Complètement dans READLINE ci-dessus). Cette option est activée par défaut.
• huponexit
          Si existante, bash enverra un signal SIGHUP à toutes les tâches lorsqu'un interpréteur de connexion interactif termine.
• interactive_comments
          Si existante, un mot commençant par un # conduira ce mot et tous les autres caractères restants de la ligne à être ignorés dans un interpréteur interactif (consultez COMMENTAIRES ci-dessus). Cette option est activée par défaut.
• lastpipe
          Si existante, et que le contrôle des tâches n'est pas activé, l'interpréteur exécute la dernière commande d'une conduite non exécutée en arrière-plan dans l'environnement d'interpréteur actuel.
• lithist
          Si existante et si l'option cmdhist est activée, les commandes multilignes sont sauvegardées dans l'historique avec des changements de ligne incorporés comme séparateurs plutôt que des points-virgules là où c'est possible.
• login_shell
          L'interpréteur crée cette option s'il est démarré en tant qu'interpréteur de connexion (consultez APPEL ci-dessus). La valeur ne peut être modifiée.
• mailwarn
          Si existante et s'il a été accédé à un fichier que bash surveille pour les courriers depuis sa dernière vérification, le message « Le courrier dans fichier_de_courrier a été lu. » est affiché.
• no_empty_cmd_completion
          Si existante et si readline est utilisée, bash n'essaiera pas d'utiliser le PATH pour de possibles complètements quand le complètement est tenté sur une ligne vide.
• nocaseglob
          Si existante, bash fait correspondre les noms de fichiers d'une façon insensible à la casse lors du développement des chemins (consultez Développement des chemins ci-dessus).
• nocasematch
          Si existante, bash fait correspondre les motifs d'une façon insensible à la casse lors de la mise en correspondance pendant l'exécution des commandes conditionnelles case ou [[.
• nullglob
          Si existante, bash autorise les motifs ne correspondant à aucun fichier (consultez Développement des chemins ci-dessus) à se développer en une chaîne vide plutôt qu'en une valeur littérale.
• progcomp
          Si existante, les outils de complètement programmables (consultez Complètement programmable ci-dessus) sont activés. Cette option est activée par défaut.
• promptvars
          Si existante, les chaînes d'invite sont sujettes au développement des paramètres, à la substitution de commande, au développement arithmétique et à la suppression des protections après avoir été développées comme décrit ci-dessus dans INVITES. Cette option est activée par défaut.
• restricted_shell
          L'interpréteur crée cette option s'il est démarré en mode restreint (consultez INTERPRÉTEUR RESTREINT ci-dessous). Cette valeur ne peut pas être changée. Elle n'est pas réinitialisée lorsque les fichiers de démarrage sont exécutés, ce qui permet à ces fichiers de découvrir si un interpréteur est restreint ou non.
• shift_verbose
          Si existante, la commande interne shift affiche un message d'erreur lorsque le nombre de décalages dépasse le nombre de paramètres positionnels.
• sourcepath
          Si existante, la commande interne source (.) utilise la valeur de la variable PATH pour trouver le répertoire contenant le fichier fourni en argument. Cette option est activée par défaut.
• xpg_echo
          Si existante, la commande interne echo développe par défaut les suites de caractères d'échappement par contre-oblique.
• suspend [-f]
      Suspend l'exécution de l'interpréteur jusqu'à la réception d'un signal SIGCONT. Un interpréteur de connexion ne peut pas être suspendu ; l'option -f permet de surpasser ce comportement et force sa suspension. L'état renvoyé est 0, sauf si l'interpréteur est un interpréteur de connexion et que l'option -f est absente, ou si le contrôle des tâches n'est pas activé.
• test expr
• [ expr ]
      Renvoie un état de 0 ou 1 selon l'évaluation de la condition expr. Chaque opérateur et opérande doit être représenté par un argument distinct. Les conditions sont composées des primitives décrites ci-dessus dans CONDITIONS. test n'accepte aucune option, n'accepte pas non plus et ignore l'argument -- signifiant la fin des options.

0.5 Les conditions peuvent être combinées avec les opérateurs suivant, décrits par ordre de priorité décroissante. L'évaluation dépend du nombre d'arguments, voir ci-dessous. La priorité des opérateurs est utilisée quand il y a au moins cinq arguments.

• ! expr
      Vrai si expr est fausse.
• ( expr )
      Renvoie la valeur de expr. Peut servir à surpasser la priorité normale des opérateurs.
• expr1 -a expr2
      Vrai si expr1 et expr2 sont toutes deux vraies.
• expr1 -o expr2
      Vrai si expr1 ou expr2 est vraie.

test et [ évaluent les conditions en fonction d'un jeu de règles dépendant du nombre d'arguments.

0.5

• 0 argument
      La condition est fausse.
• 1 argument
      La condition est vraie si et seulement si l'argument n'est pas vide.
• 2 arguments
      Si le premier argument est !, la condition est vraie si et seulement si le second argument est vide. Si le premier argument est l'un des opérateurs conditionnel unaires décrits ci-dessus dans CONDITIONS la condition est vraie si le test unaire est vrai. Si le premier argument n'est pas un opérateur conditionnel unaire correct, la condition est fausse.
• 3 arguments
      Les conditions suivantes sont appliquées dans l'ordre de la liste. Si le second argument est l'un des opérateurs conditionnels binaires décrits ci-dessus dans CONDITIONS, le résultat de la condition est le résultat du test binaire utilisant le premier et le troisième argument en tant qu'opérandes. Les opérateurs -a et -o sont considérés comme des opérateurs binaires quand ils sont avec trois arguments. Si le premier argument est !, la valeur est la négation du test binaire utilisant les deuxième et troisième arguments. Si le premier argument est exactement ( et le troisième argument est exactement ), le résultat est le test unaire du second argument. Sinon la condition est fausse.
• 4 arguments
      Si le premier argument est !, le résultat est la négation de la condition à trois arguments composée des arguments restants. Sinon la condition est analysée et évaluée selon les règles de priorité décrites ci-dessus.
• 5 arguments ou plus
      La condition est analysée et évaluée selon les règles de priorité décrites ci-dessus.

0.5

Lorsqu'ils sont utilisés avec test ou [, les opérateurs < et > ordonnent d'un point de vue lexicographique en utilisant l'ordre ASCII.

• times
      Affiche les durées cumulées utilisateur et système pour l'interpréteur et les processus lancés par cet interpréteur. L'état renvoyé est 0.
• trap [-lp] [[argument] signal ...]
      La commande argument doit être lue et exécutée quand l'interpréteur reçoit au moins un signal. Si argument est absent (et qu'un seul signal est fourni) ou -, chaque signal indiqué est réinitialisé à sa position d'origine (la valeur qu'il avait lors de l'entrée dans l'interpréteur). Si argument est la chaîne vide, chaque signal indiqué est ignoré par l'interpréteur et par les commandes qu'il appelle. Si argument n'est pas présent et que -p est fourni, les commandes capturées associées à chaque signal sont affichées. Si aucun argument n'est fourni, ou si seul -p est donné, trap affiche la liste des commandes associées à chaque signal. L'option -l conduit l'interpréteur a afficher une liste des noms de signal et leur numéro correspondant. Chaque signal est soit un nom de signal défini dans <signal.h>, soit un numéro de signal. Les noms de signal sont insensibles la casse et le préfixe SIG est optionnel.

0.5 Si un signal est EXIT (0), la commande argument est exécutée lors de la sortie de l'interpréteur. Si un signal est DEBUG, la commande argument est exécutée avant toute commande simple, commande for, commande case, commande select, toute commande for arithmétique, et avant que la première commande n'exécute une fonction de l'interpréteur (consultez GRAMMAIRE DE L'INTERPRÉTEUR ci-dessus). Reportez-vous à la description de l'option extdebug de la commande interne shopt pour obtenir des renseignements sur les effets de la capture DEBUG. Si un signal est RETURN, la commande argument est exécutée à chaque fois qu'une fonction de l'interpréteur, ou un script exécuté avec les commandes internes . ou source, termine son exécution.

0.5 Si un signal est ERR, la commande argument est exécutée chaque fois qu'une commande simple renvoie un état final différent de zéro, sujet aux conditions suivantes. La capture ERR n'est pas exécutée si la commande échouée fait partie d'une liste de commandes immédiatement suivie par un mot-clef while ou until, d'un test if, d'une commande exécutée au sein d'une liste de && ou de ||, ou si la valeur renvoyée par la commande est inversée par !. Se sont les mêmes conditions que celles observées par l'option errexit.

0.5 Les signaux ignorés en entrant dans l'interpréteur ne peuvent être capturés ou réinitialisés. Les signaux capturés qui ne sont pas ignorés sont réinitialisés à leur valeur d'origine dans un sous-interpréteur ou un environnement de sous-interpréteur quand il est créé. L'état renvoyé est faux si un signal n'est pas valable, sinon trap renvoie vrai.

• type [-aftpP] nom [nom ...]
      Sans option, indique comment chaque nom doit être interprété si on l'utilise en nom de commande. Si l'attribut -t est utilisé, type affiche une des phrases suivantes alias, keyword, function, builtin ou file selon que le nom est un alias, un mot-clé réservé de l'interpréteur, une fonction, une commande interne ou un fichier sur le disque. Si le nom n'est pas trouvé, rien n'est affiché et un état final à faux est renvoyé. Si l'option -p est utilisée, type renvoie le nom du fichier qui sera exécuté si l'on tape le nom en guise de commande ou rien si

type -t name ne renvoyait pas file. L'option -P force une recherche dans PATH pour chaque nom, même si

type -t name ne renvoyait pas file. Si une commande est disponible dans la table de hachage, -p et -P affichent la valeur de cette table, qui n'est pas nécessairement le fichier apparaissant en premier dans PATH. Si l'option -a est appelée, type affiche tous les emplacements contenant un exécutable du nom indiqué. Cela inclut les alias et les fonctions, sauf si l'option -p est également présente. La table de hachage des commandes n'est pas consultée avec l'option -a. L'option -f supprime la fonction de l'interpréteur de consultation de table, comme avec la commande interne command. type renvoie vrai si tous les arguments sont trouvés et faux si aucun n'a pas été trouvé.

• ulimit [-HSTabcdefilmnpqrstuvx [limitation]]
      Fournit, sur les systèmes qui le permettent, un mécanisme de contrôle des ressources disponibles pour l'interpréteur et pour les processus qu'il lance. Les options -H et -S indiquent si la limitation est stricte (« hard ») ou flexible (« soft ») pour la ressource indiquée. Une limitation stricte ne peut pas être augmentée par un utilisateur non privilégié une fois qu'elle a été configurée ; une limitation flexible peut être augmentée jusqu'à la valeur de la limitation stricte correspondante. Si ni -H ni -S n'est indiqué, les limitations strictes et flexibles sont toutes deux configurées. La valeur de la limitation peut être un nombre (utilisant les unités particulières de la ressource) ou l'une des valeurs spéciales hard, soft ou unlimited, qui signifient, respectivement, la limitation stricte actuelle, la limitation flexible actuelle et l'absence de limitation. Si la limitation est omise, la valeur actuelle de la limitation flexible pour la ressource est affichée, à moins que l'option -H soit indiquée. Quand plusieurs ressources sont indiquées, les noms des limitations et leurs unités sont affichés avant les valeurs. Les autres options sont interprétées comme suit :

• -a
      Toutes les limitations actuelles sont signalées
• -b
      La taille maximum du tampon de « socket »
• -c
      La taille maximum des fichiers core créés
• -d
      La taille maximum du segment de données d'un processus
• -e
      La priorité d'ordonnancement maximum (« nice »)
• -f
      La taille maximum d'un fichier écrit par l'interpréteur et ses enfants
• -i
      Le nombre maximum de signaux en attente
• -l
      La taille maximum qui peut être verrouillée en mémoire
• -m
      La taille maximum de la partie résidente d'un processus (« resident set size » ou RSS, la plupart des systèmes ne respectent pas cette limite)
• -n
      Le nombre maximum de descripteurs de fichiers ouverts (la plupart des systèmes ne permettent pas de modifier cette valeur)
• -p
      La taille d'un tube en blocs de 512 octets (parfois inexistante)
• -q
      Le nombre maximum d'octets dans les files de messages POSIX
• -r
      La priorité d'ordonnancement temps-réel maximale
• -s
      La taille maximum de la pile
• -t
      La durée maximum, en seconde, de temps CPU accordé à un processus
• -u
      Le nombre maximum de processus autorisés pour un seul utilisateur
• -v
      La quantité de mémoire virtuelle disponible pour l'interpréteur et, sur certains systèmes, pour ses enfants
• -x
      Le nombre maximum de verrous de fichiers
• -T
      Le nombre maximum de processus légers (« threads »)

Si une limitation est indiquée, elle sera la nouvelle valeur pour la ressource indiquée (l'option -a correspond à l'affichage seul). Si aucune option n'est indiquée alors -f est supposée. Les valeurs s'expriment par pas de 1024 octets, sauf pour -t qui est en secondes, -p, qui utilise des unités de blocs de 512 octets, ainsi que -T, -b, -n et -u, qui n'ont pas d'unités. L'état renvoyé est 0, sauf si une option ou un argument incorrect a été fourni ou si une erreur se produit en configurant la nouvelle limitation.

• umask [-p] [-S] [mode]
      Le masque de création de fichier de l'utilisateur est configuré à mode. Si mode commence par un chiffre, il est interprété comme un nombre octal, sinon il est considéré comme un masque symbolique, semblable à ceux acceptés par chmod(1). Si mode est omis ou si l'option -S est fournie, la valeur actuelle du masque est affichée. L'option -S conduit à l'affichage du masque sous forme symbolique, l'affichage par défaut étant en octal. Si l'option -p est fournie et si le mode est omis, la sortie a lieu dans un format réutilisable en entrée. L'état renvoyé est 0 si le mode a pu être changé correctement ou si aucun argument mode n'a été fourni, et faux sinon.
• unalias [-a] [nom ...]
      Supprime le nom de la liste des alias définis. Si l'option -a est fournie, toutes les définitions d'alias sont supprimées. La valeur renvoyée est vrai, sauf si un nom fourni n'est pas un alias défini.
• unset [-fv] [nom ...]
      Pour chaque nom indiqué, supprime la variable ou la fonction correspondante. Si aucune option n'est fournie ou si l'option -v est indiquée, chaque nom se rapporte à une variable de l'interpréteur. Les variables en lecture seule ne peuvent pas être détruites. Si l'option -f est indiquée, chaque nom se rapporte à une fonction de l'interpréteur et la définition de la fonction est supprimée. Chaque variable ou fonction détruite est supprimée de l'environnement transmis aux commandes ultérieures. Si l'une des variables COMP_WORDBREAKS, RANDOM, SECONDS, LINENO, HISTCMD, FUNCNAME, GROUPS ou DIRSTACK est détruite, elle perd ses propriétés spécifiques, même s'il elle est recréée ultérieurement. L'état final est vrai sauf si un des noms est en lecture seule.
• wait [n ...]
      Attend que chaque processus indiqué termine et renvoie son état final. Chaque n peut être un PID ou une spécification de tâche ; si une spécification de tâche est indiquée, la fin de tous les processus de la conduite de cette tâche sera attendue. Si n est omis, la fin de tous les processus enfants actuellement actifs sera attendue et l'état renvoyé est zéro. Si n indique un processus ou une tâche inexistants, l'état renvoyé est 127. Sinon, l'état renvoyé est l'état final du dernier processus ou tâche attendu.

Si bash démarre sous le nom rbash ou si l'option -r est fournie lors de son appel, l'interpréteur devient restreint. Un interpréteur restreint permet de créer un environnement plus contrôlé qu'un interpréteur standard. Il se comporte de même façon que bash à la différence des actions suivantes qui sont interdites ou non effectuées :

changer de répertoire avec cd ;

créer ou détruire les valeurs de SHELL, PATH, ENV ou BASH_ENV ;

indiquer des noms de commandes contenant un / ;

indiquer un nom de fichier contenant un / comme argument de la commande interne . ;

indiquer un nom de fichier contenant une barre oblique comme argument de l'option -p de la commande interne hash ;

importer une définition de fonction dans l'environnement au démarrage ;

analyser les valeurs de SHELLOPTS au démarrage ;

rediriger la sortie en utilisant les opérateurs de redirection >, >|, <>, >&, &> et >> ;

utiliser la commande interne exec pour remplacer l'interpréteur par une autre commande ;

ajouter ou supprimer des commandes internes avec les options -f et -d de la commande interne enable ;

utiliser la commande interne enable pour activer les commandes internes de l'interpréteur désactivées ;

indiquer l'option -p à la commande interne commande ;

supprimer le mode restreint avec set +r ou set +o restricted.

Ces restrictions sont mises en place après la lecture de n'importe quel fichier de démarrage.

.ie Quand une commande exécutée se trouve être un script shell, (consultez

EXÉCUTION DES COMMANDES ci-dessus), rbash supprime toute restriction dans l'interpréteur créé pour exécuter le script.

• Manuel de référence de Bash, Brian Fox et Chet Ramey
• The GNU Readline Library, Brian Fox et Chet Ramey
• The GNU History Library, Brian Fox et Chet Ramey
• Portable Operating System Interface (POSIX) Part 2: Shell and Utilities, IEEE
• sh(1), ksh(1), csh(1)
• emacs(1), vi(1)
• readline(3)

• /bin/bash
      L'exécutable bash
• /etc/profile
      Le fichier d'initialisation commun à tout le système, exécuté pour les interpréteurs de commandes de connexion
• /etc/bash.bashrc
      Le fichier de démarrage commun à tout le système pour chacun des interpréteurs interactifs
• /etc/bash.bash.logout
      Le fichier de nettoyage des interpréteurs de connexion commun à tout le système, exécuté lorsqu'un interpréteur de connexion termine
• ~/.bash_profile
      Le fichier d'initialisation personnel exécuté pour les interpréteurs de commandes de connexion
• ~/.bashrc
      Le fichier de démarrage personnel, pour chacun des interpréteurs interactifs
• ~/.bash_logout
      Le fichier de nettoyage personnel des interpréteurs de commandes de connexion, exécuté lorsqu'un interpréteur de commandes de connexion termine
• ~/.inputrc
      Le fichier d'initialisation personnalisée de readline

Brian Fox, Free Software Foundation

Chet Ramey, Case Western Reserve University

Si vous trouvez une anomalie dans bash, vous devriez la signaler. Tout d'abord vous devez vous assurer qu'il s'agit réellement d'une anomalie et qu'elle apparaît bien dans la dernière version de bash disponible. La dernière version est toujours disponible à partir de ftp://ftp.gnu.org/pub/gnu/bash/.

Une fois que vous avez déterminé qu'une anomalie existe effectivement, utilisez la commande bashbug pour envoyer un signalement d'anomalie. Si vous avez un correctif, vous êtes encouragé à l'envoyer en même temps ! Les suggestions ou les signalements d'anomalies de nature « philosophique » peuvent être envoyés (en anglais) à ou postés dans le groupe Usenet gnu.bash.bug.

TOUS les signalements d'anomalie doivent contenir :

• Le numéro de version de bash
• Le matériel et le système d'exploitation utilisés
• Le compilateur utilisé pour compiler
• Une description (en anglais) de l'anomalie
• Un petit script ou une « recette » qui démontre l'anomalie

bashbug insère automatiquement les trois premiers éléments de cette liste dans le formulaire qu'il fournit pour remplir un signalement d'anomalie.

Les commentaires et signalement d'anomalies concernant la version originale de cette page de manuel (en anglais) doivent être transmis à . Ceux concernant cette version française peuvent être envoyés à .

Cet interpréteur de commandes est trop gros et trop lent.

Il y a quelques différences subtiles de comportement entre bash et les versions traditionnelles de sh, principalement à cause des spécifications POSIX.

L'utilisation des alias peut avoir des conséquences inattendues.

Les commandes internes et les fonctions de l'interpréteur ne peuvent pas être suspendues/relancées.

Les commandes composées et les suites de commandes de la forme « a ; b ; c » ne sont pas gérées élégamment lors d'une interruption de processus. En cas de suspension d'un processus, l'interpréteur exécute immédiatement la commande suivante. Il suffit de placer cette suite de commandes entre parenthèses pour la forcer à créer un sous-interpréteur, qui, lui, pourra être suspendu en bloc.

Les variables de type tableau ne peuvent pas (encore) être exportées.

Il ne peut exister qu'un seul coprocessus actif à la fois.

Ce document est une traduction réalisée par Christophe Blaess et Thierry Vignaud en 1997, et mise à jour par Alain Portal <aportal AT univ-montp2 DOT fr> en 2006. La version présente dans Debian a été entièrement retravaillée par Frédéric Lehobey <Frederic AT Lehobey DOT net> et est dorénavant maintenue par David Prévot et les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.