Órdenes simples¶

Una orden simple es una secuencia de asignaciones opcionales de variables seguida por palabras separadas por blancos y redirecciones, y terminadas por un operador de control. La primera palabra especifica la orden a ser ejecutada, se pasa como argumento cero. Las palabras restantes se pasan como argumentos a la orden invocada.

El valor devuelto de una orden simple es su estado de salida, ó 128+n si la orden ha terminado debido a la señal n.

Tuberías¶

Una tubería es una secuencia de una o más órdenes separadas por uno de los operadores de control | o |&. El formato de una tubería es:

La salida estándar de orden1 está conectada mediante una tubería a la entrada estándar de orden2. Dicha conexión se reliza antes de cualquier redirección que defina la orden1 (consulte REDIRECCIÓN más adelante). Si se emplea |& la salida de error estándar de orden1 también se conectará a la entrada estándar de orden2 junto con su salida estándar a través de la tubería; esto es una abreviatura de 2>&1 |. Esta redirección implícita de la salida de error estándar hacia la salida estándar se realiza después de cualquier redirección definida mediante orden1.

El estado de salida de una tubería será el de la última orden salvo que la opción pipefail esté activada, en cuyo caso el estado de salida será el de la última (más a la derecha) orden que conforme la tubería. Si se precede la tubería de la palabra reservada !, su estado de salida será la negación lógica del estado de salida descrito para los casos anteriores. La shell esperará que finalice la ejecución de la última orden para devolver un estado de salida.

Si la palabra reservada time precede una tubería, se informa del tiempo transcurrido, así como del de usuario y sistema, consumido en la ejecución de la tubería, cuando ésta termina. La opción -p cambia el formato de salida al especificado por POSIX. Cuando la shell está en modo posix, no reconoce time como palabra reservada si el siguiente conjunto de opciones comienza por "-". La variable TIMEFORMAT puede definir la forma en que se muestran las temporizaciones. Consulte TIMEFORMAT en el apartado Variables de la Shell.

Cuando la shell está en modo posix, time puede ir seguido de un salto de línea. En cuyo caso, se muestra la totalidad del tiempo de usuario y sistema consumido por la shell y sus descendientes. Puede usarse la variable TIMEFORMAT para definir el formato de la información de tiempo.

Cada orden que forme parte de una tubería se ejecuta en un proceso separado, es decir, en una subshell. Consulte ENTORNO DE EJECUCIÓN DE ÓRDENES si precisa información acerca del entorno en una subshell. Si la opción lastpipe está activada mediante la orden nativa shopt (vea la descripción de shopt a continuación), el último elemento de una tubería puede ser ejecutado por la propia shell cuando no está activado el control de tareas.

Listas¶

Una lista es una secuencia de una o más tuberías separadas por uno de los operadores ;, &, &&, o ||, y terminada opcionalmente por uno de ;, &, o <nueva-línea>.

De estos operadores de listas, && y || tienen igual precedencia. Le siguen ; y &, que también tienen igual precedencia.

Puede aparece uno o varios saltos de línea en lugar de un punto y coma para delimitar órdenes en una lista

Si una orden se termina mediante el operador de control &, la shell ejecuta la orden en segundo plano en una subshell. La shell no espera que la orden acabe, y el estado de salida será 0. Esto es lo que se denomina órdenes asíncronas. Las órdenes separadas por un ; se ejecutan secuencialmente; la shell espera que cada orden termine, por orden. En este caso, el estado de salida será el de la última orden ejecutada.

Las listas AND y OR son secuencias formadas por una o más tuberías separadas por los operadores de control && y ||, respectivamente. Se comienzan a interpretar por la izquierda. Una lista AND tiene el siguiente formato:

orden2 se ejecuta si y solo si orden1 devuelve un estado de salida 0.

Una lista O tiene el siguiente formato

orden2 se ejecuta si y solo si orden1 devuelve un estado de salida distinto de cero. El estado de salida de las listas Y y O es el de la última orden ejecutada en la lista.

Órdenes Compuestas¶

Una orden compuesta es una de las siguientes. En la mayoría de los casos, una lista en la descripción de una orden puede ir separada del resto de la orden por uno o más saltos de línea y puede ir seguido de un salto de línea en lugar de un punto y coma.

(lista)

lista se ejecuta en una subshell (consulte ENTORNO DE EJECUCIÓN DE ÓRDENES más adelante). Después de que la orden finaliza su ejecución, las asignaciones a variables y órdenes nativas que afectaran al entorno de la shell no siguen vigentes. El estado de retorno es el de salida de lista.

{ lista; }

lista se ejecuta en el entorno actual de la shell, deberá finalizar con un salto de línea o un punto y coma. Esto se conoce como un grupo de órdenes. El estado de salida es el de lista. Observe que a diferencia de los metacaracteres ( y ), los metacaracteres { y } son palabras reservadas y solo deberían utilizarse donde dichas palabras se reconozcan como tales. Como no pueden causar una división de palabra, deben separarse de la lista mediante espacio o mediante otro metacarácter de la shell.

((expresión))

La expresión se evalúa de acuerdo a las reglas descritas más adelante bajo la sección EVALUACIÓN ARITMÉTICA. Si el valor de la expresión es distinto de cero, el estado de retorno es 0; de otro modo el estado de retorno es 1. La expresión está sujeta a la misma expansión que tendria estnado entre comillas dobles, salvo que dichas comillas no seria tratadas como caracteres especiales y se eliminarían.

[[ expresión ]]

Devuelve un estado de 0 o 1 dependiendo de la evaluación de la expresión condicional expresión. Las expresiones se componen de las primarias descritas más adelante en el apartado EXPRESIONES CONDICIONALES. No tienen lugar división de palabras ni expansión de nombres de ruta en las palabras entre el [[ y el ]]; sí se realizan la expansión de tilde, expansión de parámetros y variables, expansión aritmética, sustitución de orden, sustitución de proceso y eliminación de comillas en dichas palabras (la expansión que ocurriría si las palabras estuviesen entre comillas dobles). Deben eliminarse las comillas de los operadores condicionales como -f para que sean reconocidos como primarios.

Cuando se emplean con [[, los operadores < y > ordenan lexicográficamente en base a la configuración del idioma actual.

Cuando se emplean los operadores == y !=, la cadena a la derecha del operador se considera un patrón y se hace concordar de acuerdo a las reglas descritas más adelante bajo el epígrafe Concordancia de patrones, tal como si estuviese activa la opción extglob de la shell. El operador == equivale a =. Si está activada la opción nocasematch de la shell, se buscará la concordancia sin diferenciar entre mayúsculas y minúsculas. El valor devuelto es 0 si la cadena concuerda (==) o no concuerda (=0 )con el patrón, respectivamente, y 1 en otro caso. Cualquier parte del patrón puede entrecomillarse para forzar la concordancia como una cadena de caracteres pura.

Dispone de otro operador binario: =~. Tiene la misma prevalencia que == y !=. Al usarlo, la cadena a la derecha se considerará una expresión regular ampliada POSIX y concordada adecuadamente (mediante las interfaces POSIX regcomp y regexec generalmente descritas en regex(3). El valor devuelto será 0 si la cadena concuerda con el patrón y 1 en caso contrario. Si la expresión regular contiene algún error de sintaxis se devolverá el valor 2. Si la opción nocasematch está activa, se buscará la concordancia sin distinguir entre mayúsculas y minúsculas. Si se entrecomilla una parte del patrón, dicha parte concordará literalmente. Debe tenerse especial cuidado con el uso de corchetes ya que las comillas normales pierden su especial significado entre ellos.

El patrón concordará si lo hace cualquier parte de la cadena. Para hacer que concuerde la cadena completa, puede rodear el patrón con los operadores de expresiones regulares ^ y $. La variable vectorial BASH_REMATCH registra la parte de la cadena que concordó con el patrón. El elemento de BASH_REMATCH con índice 0 contendrá el fragemento de la cadena que concuerda con toda la expresión regular. Las subcadenas que concuerdan con subexpresiones entre paréntesis se guardan en los índices de BASH_REMATCH donde el índice n es la parte de la cadena que concuerda con la nésima subexpresión entre paréntesis. Bash define BASH_REMATCH con un alcance general, declararla como una variable local puede dar lugar a resultados indeseados.

Las expresiones pueden combinarse mediante los siguientes operadores, listados en orden decreciente de precedencia:

for nombre [ [ in palabra ...; ] ] do lista ; done

La lista de palabras que va detrás de in se expande, generando una lista de elementos. La variable nombre se define como cada elemento de la lista en cada iteración, y lista se ejecuta cada vez. Si la palabra de in se omite, la orden for ejecuta lista una vez para cada parámetro posicional que esté definido (consulte PARÁMETROS más adelante). El estado de retorno es el de salida de la última orden que se ejecuta. Si la expansión de los elementos después del in resulta en una lista vacía, no se ejecuta ninguna orden y el estado de salida es 0.

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

Primeramente se evaluará la expresión aritmética expr1 en base a las reglas definidas más adelante en la sección EVALUACIÓN ARITMÉTICA. Después se evalúa la expresión expr2 repetidamente hasta que el resultado sea cero. Cada vez que expr2 se evalúe con un resultado diferente a cero, se ejecutará lista y se evaluará expr3. Si se omite alguna de las expresiones, se considerará el valor 1 como resultado de su evaluación. El valor retornado es el estado de salida de la última orden de lista ejecutada o falso si alguna de las expresiones no es válida.

select nombre [ in palabra ] ; do lista ; done

La lista de palabras que sigue a in se expande, generando una lista de elementos. El conjunto de palabras expandidas se muestra en la salida estándar de errores, cada una precedida por un número. Si la palabra del in se omite, se muestran los parámetros posicionales (consulte PARÁMETROS más adelante). Entonces se muestra el indicador PS3 y se lee una línea desde la entrada estándar. Si la línea consiste en un número correspondiente a una de las palabras mostradas, entonces el valor de nombre se pone a esa palabra. Si la línea está vacía, las palabras y el indicador se muestran de nuevo. Si se lee EOF, la orden select se completa y devuelve 1. Cualquier otro valor leída hace que nombre se defina como un valor vacío. La línea leída se guarda en la variable REPLY. La lista se ejecuta tras cada selección hasta que se ejecute una orden break. El estado de salida de select es el de la última orden ejecutada en lista o cero si no se ha ejecutado ninguna orden.

case palabra in [ [(] patrón [ | patrón ] ... ) lista ;; ] ... esac

Una orden case expandirá primero palabra y buscará si concuerda con cada uno de los patrones en base a las reglas de concordancia descritas más adelante en Concordancia. La palabra se expandirá empleando expansión de tilde, expansión de parámetros y variables, expansión aritmética, sustitución de órdenes, sustitución de procesos y eliminación de comillas. Cada patrón examinado se expande empleando expansión de tilde, expansión de parámetros y variables, expansión aritmética, sustitución de órdenes, sustitución de procesos y eliminación de comillas. Si está activa la opción nocasematch, se buscará la concordancia sin distinguir entre mayúsculas y minúsculas. Cada vez que se encuentre una concordancia, se ejecutará la correspondiente lista. Si se emplea el operador ;;, una vez encontrada una concordancia, no se seguirán buscando más. Si se emplea ;& en lugar de ;;, la ejecución continuará con la lista asociada con el siguiente conjunto de patrones. Si se utiliza ;;& en lugar de ;; hará que la shell pruebe el siguiente conjunto de patrones, si lo hubiese, ejecutando las listas de una concordancia, siguiendo con la ejecución de la estructura 'case' como si no hubiese habido concordancia alguna. El valor de salida será cero si no existen concordancias con ningún patrón. En cualquier otro caso, será el estado de salida correspondiente a la última orden ejecutada en lista.

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

La lista if se ejecuta. Si su estado de salida es cero, se ejecuta la lista then. De otro modo, se ejecuta por turno cada lista elif, y si su estado de salida es cero, se ejecuta la lista then correspondiente y la orden se completa. Si no, se ejecuta la lista then si está presente. El estado de salida es el de la última orden ejecutada, o cero si ninguna condición fue verdadera.

while lista-1; do lista-2; done

until lista-1; do lista-2; done

La orden while ejecuta continuamente la lista lista-2 siempre que la última orden de lista-1 devuelva un estado de salida cero. La orden until es idéntica a la while, salvo que la comprobación es a la inversa: la lista-2 se ejecuta mientras que la última orden en lista-1 devuelva un estado de salida distinto de cero. El estado de salida de las órdenes while y until es el de la última orden de la lista-2 ejecutada, o cero si no se ejecutó ninguna orden.

Coprocesos¶

Un coproceso es una orden de la shell precedida de la palabra reservada coproc. Un coproceso se ejecuta de modo asíncrono en una subshell, de igual modo que si la orden fuese seguida del operador de control &, con una tubería bidireccional entre la shell y el coproceso.

La sintaxis de un coproceso es la siguiente:

Esto creará un coproceso llamado NOMBRE. orden puede ser un orden simple o compuesta. NOMBRE será una variable de la shell. Si no se da ningún NOMBRE, por defecto se asignará el de COPROC.

El formato recomendado de un coproceso es el siguiente:

Esta forma es recomendable porque las ordenes simples harán que el coproceso siempre se llame COPROC, siendo más sencillo su uso y más completo que las otras órdenes compuestas.

Si orden es una orden compuesta, NOMBRE será opcional. La palabra que siga a coproc determinará si dicha palabra debe interpretarse como el nombre de una variable: se considerará como el valor de NOMBRE si no es una palabra reservada que introduzca una orden compuesta. Si orden es una orden simple, NOMBRE no está permitido; esto se hace para evitar confusiones entre NOMBRE y la primera palabra de la orden compuesta.

Cuando se ejecuta un coproceso, la shell crea una variable vectorial (consulte vectores más adelante) llamada NOMBRE dentro de la shell que lo ejecuta. La salida estándar de orden está unida a un descriptor de archivo de la shell mediante una tubería, asignándose éste a NOMBRE[0]. La entrada estándar de la orden también está conectada mediante una tubería a otro descriptor de archivo de la shell asignado a NOMBRE[1]. Esta tubería se define antes de cualquier redirección definida en la orden (consulte REDIRECCIONES más adelante). Estos descriptores de archivo pueden emplearse como argumentos en órdenes y redirecciones mediante epansión de palabra. Salvo aquellos creados durante la ejecución de órdenes y la sustitución de procesos, los descriptores de archivo no están disponibles en subshells.

El identificador de proceso de la shell abierta para ejecutar el coproceso se almacena en el valor de la variable NAME_PID. La orden nativa wait puede emplearse para esperar la finalización del coproceso.

Como el coproceso se creó como una orden asíncrona, la orden coproc siempre tiene una valor de salida de éxito. El valor de salida de un coproceso es el de orden.

Definición de Funciones de la Shell¶

Una función de la shell es un objeto que se invoca de igual manera que las órdenes simples y pero ejecutan una orden compuesta con un conjunto propio de parámetros posicionales. Las funciones de la shell se declaran del siguiente modo:

nombre_función () orden_incluida [redirección]

function nombrefunción [()] orden-compuesta [redirección]

Define una función llama nombrefunción. La palabra reservada function es opcional, si se indica pueden omitirse los paréntesis. El cuerpo de la función será la orden compuesta (consulte Órdenes Compuestas más atrás). Esta orden suele consistir en una lista de órdenes entre { y }, pero puede ser cualquier orden que figure bajo Órdenes Compuestas con una única excepción: si se emplea la palabra reservada function sin paréntesis, son recomendables las llaves. orden-compuesta se ejecutará siempre y cuando nombrefunción se especifique como el nombre de una orden simple. Si estamos en modo posix, nombrefunción deberá ser un nombre de shell válido y no podrá ser una de las órdenes nativas de POSIX. En el modo por defecto, podrá emplearse cualquier palabra de la shell sin entrecomillar como nombre de una función (simpre que no contenga $. Cualquier redirección que se haga cuando se define una función se llevará a cabo cuando se ejecute la función. El estado de salida al definir una función será cero salvo que se incurra en un error de sintaxis o ya exista una función de sólo-lectura con el mismo nombre. El estado de salida de la ejecución de una función viene dado por el de la última orden ejecutada. Consulte FUNCIONES más adelante.

Parámetros Posicionales¶

Un parámetro posicional es un parámetro denotado por uno o más dígitos, distintos del simple 0. Los parámetros posicionales se asignan a partir de los argumentos de la shell cuando éste es llamado, y pueden ser reasignados mediante la orden nativa set. Los parámetros posicionales no pueden ser asignados con sentencias de asignación. Los parámetros posicionales se reemplazan temporalmente cuando se ejecuta una función de la shell (consulte FUNCIONES más adelente).

Cuando un parámetro posicional consistente en más de un solo dígito se expande, debe rodearse por llaves (consulte EXPANSIÓN más adelante).

Parámetros Especiales¶

la shell trata de forma especial a ciertos parámetros. Éstos solo pueden referenciarse; no se permite asignarles nada.

*

Se expande a los parámetros posicionales, empezando por 1. Cuando la expansión no ocurre entre comillas dobles, cada parámetro posicional se expande a una palabra separada. En los contextos en los que se realiza, estas palabras pueden ser objeto de separación y de expansión del nombre de ruta. Cuando dicha expansión ocurren dentro de un entrecomillado doble, ésta se expande a una sola palabra con el valor de cada parámetro separado por el primer carácter de la variable especial IFS. Esto es, "$*" es equivalente a "$1c$2c...", donde c es el primer carácter del valor de la variable IFS. Si IFS no está definida, los parámetros se separan por espacios. Si IFS es la cadena vacía, los parámetros se juntan sin ningún separador.

@

Se expande a los parámetros posicionales, comenzando desde el uno. En donde se realiza la división de palabras, se expande cada parámetro posicional a una palabra separada; si no están entrecomillada con comillas dobles, estas palabras estarán sujetas a división de palabra. Donde no se realiza la división de palabra, se expande a una sola palabra con cada parámetro posicional separado por un espacio. Cuando la expansión ocurre entre comillas dobles, cada parámetro se expande a una palabra separada. Es decir, "$@" es equivalente a '$1' '$2'... Si la expansión entre comillas dobles ocurre dentro de una palabra, la expansión del primer parámetro se une con la parte inicial de la palabra original y la expansión del último parámetro se une con la última parte de la palabra original. Cuando no hay parámetros posicionales, '$@'y $@ se eliminan (se expande a 'nada').

#

Se expande al número en base 10 de parámetros posicionales.

?

Se expande al estado de salida de la tubería más recientemente ejecutada en primer plano.

-

Se expande a las opciones de la shell activas actualmente según se hayan especificado en la llamada, mediante la orden nativa set, o las que haya puesto el mismo shell (como la opción -i).

$

Se expande al PID de la shell. En una subshell, se expande al PID de la shell actual, no al del subshell.

!

Se expande al PID del proceso más recientemente ejecutado en segundo plano ya fuese ejecutado como una orden asíncrona o mediante la orden nativa bg. Consulte CONTROL DE TAREAS más adelante.

0

Se expande al nombre de la shell o script de la shell. Este parámetro se pone en el inicio de la shell. Si bash se llama con un fichero de órdenes, $0 se pone al nombre de ese fichero. Si bash se inicia con la opción -c, entonces $0 se pone al primer argumento tras la cadena que se va a ejecutar, si hay alguno presente. Si no, se pone al nombre de fichero empleado para llamar a bash, como se da en el argumento cero.

Variables de la Shell¶

la shell define automáticamente las siguientes variables:

_

Al inicio de la shell, adopta el valor de la ruta con la que se inició dicha shell o el script que se ejecute tal como se indicó en el entorno en los argumentos. Por lo tanto se expandirá al último argumento de la anterior orden ejecutada en primer plano después de la expansión. También adopta el valor de la ruta completa empleada para invocar cada orden ejecutada, se pone en el entorno exportado para esa orden. En el caso de la lectura de correo electrónico, esta variable adopta el valor del nombre del archivo de correo leído en cada instante.

BASH

Se expande al nombre completo del fichero empleado para llamar a esta instancia de bash.

BASHOPTS

Una lista, de elementos separados por dos puntos, de opciones activas de la shell. Cada palabra en la lista es un argumento válido para la opción -s de la orden nativa shopt (consulte ÓRDENES NATIVAS DE LA SHELL más adelante). Las opciones que aparecen en BASHOPTS son aquéllas que aparecen como on en shopt. Si esta variable está en el entorno cuando se inicia bash, cada opción de la shell en la lista se activará antes de cargar cualquier archivo de inicio. Es una variable de solo lectura.

BASHPID

Se expande al ID del proceso en ejecución de bash. Esto difiere de $$ en ciertos casos, como las subshells que no requieren una reinicialización de bash. No se consideran las asignaciones de BASHPID. Si se anula el valor definido a BASHPID, ésta pierde sus propiedades especiales aunque se vuelva a definir posteriormente.

BASH_ALIASES

Una variable vectorial asociativa cuyos miembros pertenecen a la lista interna de alias tal como la gestiona la orden nativa alias. Los elementos agregados a este vector aparecen en la lista de los alias; sin embargo, desactivar elementos del vector no hará que los alias se eliminen de dicha lista. Si se desactiva BASH_ALIASES, perderá sus propiedades especiales, incluso si se reactiva posteriormente.

BASH_ARGC

Una variable vectorial formada por el número de parámetros en cada marco de la pila de llamadas de la actual ejecución de bash. El número de parámetros de la subrutina actual (función o script ejecutado mediante . o source) se encuentra en la parte superior de la pila. Cuando se ejecuta una subrutina, se envian los parámetros a BASH_ARGC. La shell activa BASH_ARGC solo cuando está en modo de depuración ampliado (consulte más adelante la descripción de la opción extdebug de la orden nativa shopt). La activación de extdebug después de iniciar la ejecución de un script, o hacer referencia a esta variable cuando no se ha configurado, puede dar lugar a resultados inconsistentes.

BASH_ARGV

Una variable vectorial que contiene todos los parámetros de la pila de llamadas de la ejecución actual de bash. El parámetro final de la última llamada a la subrutina está en la parte superior de la pila; el primer parámetro de la llamada inicial está en la parte inferior. Cuando se ejecuta una subrutina, los parámetros proporcionados se envían a BASH_ARGV. La shell activa BASH_ARGV solo cuando está en modo de depuración ampliado (consulte a continuación la descripción de la opción extdebug de la orden nativa shopt). Activar extdebug después del inicio de la ejecución de un script, o hacer referencia a él cuando no se ha configurado, puede generar valores inconsistentes.

BASH_ARGV0

Esta variable se expande al nombre de la shell o del script (igual que $0, consulte al descripción del parámetro especial 0 anteriormente). Los valores asignados a BASH_ARGV0, también se asignan automáticamente a $0. Si se desactiva BASH_ARGV0, perderá sus propiedades especiales aunque posteriormente sea reactivado.

BASH_CMDS

Variable vectorial asociativa cuyos miembros corresponden al hash de la tabla interna de órdenes tal como la gestiona la orden nativa hash. Los elementos que se añadan a ese vector aparecerán en dicha tabla, sin embargo los elementos que se desactiven sí que seguirán apareciendo. Si se desactiva BASH_CMDS, perderá sus propiedades especiales aunque se vuelva a reactivar posteriormente.

BASH_COMMAND

La orden que está siendo ejecutada en ese instante o que va a serlo, excepto cuando se ejecute una orden marcada en una tramp (trap) e cuyo caso equivaldría a dicha orden. Si se anula la definición de BASH_COMMAND, pierde sus propiedades especiales aunque se vuelva a definir con posterioridad.

BASH_EXECUTION_STRING

La orden dada como argumento al ejecutar con la opción -c.

BASH_LINENO

Variable vectorial cuyos miembros corresponden a los números de línea de código fuente donde se invocó FUNCNAME. ${BASH_LINENO[$i]} será el número de línea en el archivo de código fuente (${BASH_SOURCE[$i+1]}) donde se invocó ${FUNCNAME[$i]} (o bien ${BASH_LINENO[$i-1]} si está referenciado en el seno de otra función de la shell). El número de línea actual puede obtenerse mediante LINENO.

BASH_LOADABLES_PATH

Lista de directorios separados entre si po dos puntos en los cuales la shell busca órdenes nativas cargables dinámicamente definidas por la orden enable.

BASH_REMATCH

Variable vectorial cuyos miembros se asignan mediante el operador =~ a la orden condicional [[. El elemento con índice 0 corresponderá a la parte de la cadena que concuerda con la totalidad de la expresión regular. El elemento con índice n corresponderá a la porción de cadena que concuerda con la nésima subexpresión entre paréntesis.

BASH_SOURCE

Variable vectorial cuyos miembros lo forman los nombres de los archivos de código fuente donde se definen los nombres de las funciones de la shell de la variable vectorial FUNCNAME. La función de la shell ${FUNCNAME[$i]} se define en el archivo ${BASH_SOURCE[$i]} y se invoca desde ${BASH_SOURCE[$i+1]}.

BASH_SUBSHELL

Se incrementa en una unidad dentro de cada subshell o cada entorno de subshell cuando la shell se incia en él. El valor inicial es 0. Si se desactiva BASH_SUBSHELL, ésta perderá su propiedades especiales aunque luego se vuelva a definir.

BASH_VERSINFO

Una variable vector de lectura exclusiva cuyos miembros contienen información de versión para esta instancia de bash. Los valores asignados a los miembros del vector son como sigue:

BASH_VERSION

Se expande a una cadena que describe la versión de esta instancia de bash.

COMP_CWORD

Índice en ${COMP_WORDS} de la palabra que contiene la posición actual del cursos. Esta variable solo está disponible en las funciones de la shell invocadas por las utilidades de autocompletado. Consulte Autocompletado Programable a continuación.

COMP_KEY

La clave (o última clave de una secuencia de claves) empleada para invocar la actual función de autocompletado.

COMP_LINE

Línea de órdenes actual. Esta variable solo estará disponible para las funciones de la shell y órdenes externas invocadas por las utilidades de autocompletado programable. Consulte Autocompletado Programable a continuación.

COMP_POINT

Índice de la posición actual del cursor respecto del comienzo de la orden actual. Si el cursor está al final de dicha orden, el valor de esta variable será igual a ${#COMP_LINE}. Esta variable sólo estará disponible en funciones de la shell y órdenes externas invocadas durante autocompletados. Consulte Autocompletado Programable más adelante.

COMP_TYPE

Definida como un entero según el tipo de completado provocó la llamada a una función de autocompletado: TAB para un autocompletado normal, ? para mostrar autocompletados después de varias tabulaciones, ! para mostrar las alternativas disponibles en autocompletados parciales, @ para mostrar alternativas disponibles cuando se modificó la palabra en cuestión o % para los menus. Esta variable sólo estará disponible en funciones de la shell y órdenes externas invocadas durante autocompletados. Consulte Autocompletado Programable más adelante.

COMP_WORDBREAKS

Conjunto de caracteres que la biblioteca readline considera separadores de palabras durante el autocompletado. Si se desactiva COMP_WORDBREAKS, perderá sus características especiales aunque se reactive de nuevo.

COMP_WORDS

Una variable vectorial (consulte Vectores más adelante) que consta de palabras individuales en la actual línea de órdenes. La línea se divide en palabras como lo haría readline, usando COMP_WORDBREAKS tal como se describe anteriormente. Esta variable está disponible solo en las funciones de la shell invocadas mediante autocompletado (consulte Autocompletado Progamable a continuación).

COPROC

Variable vectorial (consulte Vectores más adelante) creada para contener los descriptores de archivo de entrada/salida de un coproceso cualquiera (consulte Coprocesos anteriormente.

DIRSTACK

Una variable vector (consulte Vectores más adelante) que aloja los contenidos actuales de la pila de directorios. Los directorios aparecen en la pila en el orden en el que se muestran con la orden nativa dirs. La asignación a miembros de este vector puede emplearse para modificar directorios que ya estén en la pila, pero entonces deben utilizarse las órdenes nativas pushd y popd para añadir y quitar directorios. La asignación a esta variable no cambiará el directorio de trabajo. Si DIRSTACK no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

EPOCHREALTIME

Este parámetro se sustituirá por una cifra de coma flotante con el número de segundos desde el Inicio (Epoch) de Unix (consulte time(3)) medidos en microsegundos. No se tienen en cuenta las asignaciones a EPOCHREALTIME. Si EPOCHREALTIME no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

EPOCHSECONDS

Cada vez que este parámetro es referenciado, se devuelve en él el número de segundos transcurridos desde el Inicio (Epoch) de Unix (consulte time(3)). No se tendrá en cuenta ninguna asignación de un valor a EPOCHSECONDS. Si EPOCHSECONDS no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

EUID

Se expande al UID efectivo del usuario actual, puesta en el incio de la shell. Esta variable es de solo lectura.

FUNCNAME

Una matriz variable que contiene todas las funciones de la shell que están en la pila de ejecución en ese instante. El elemento con índice 0 es el nombre de cualquier función de la shell que se esté ejecutando. El último elemento (aquel con el índice más elevado) es "main". Esta variable solo existe cuando se está ejecutando un función de la shell. No se tendrá en cuenta ninguna asignación en a FUNCNAMES. Si FUNCNAMES no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

Esta variable puede emplearse con BASH_LINENO y con BASH_SOURCE. Cada elemento de FUNCNAME se corresponde con otros en BASH_LINENO y BASH_SOURCE para describir la pila de llamadas. Por ejemplo: ${FUNCNAME[$i]} se invoca desde el archivo ${BASH_SOURCE[$i+1]} en el número de línea ${BASH_LINENO[$i]}. La función interna caller muestra la invocación actual en base a esta información.

GROUPS

Una matriz variable que contiene la lista de grupos a los que pertenece el usuario actual. No se tendrá en cuenta ninguna asignación en a GROUPS. Si GROUPS no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

HISTCMD

El número de historial o índice en el historial de la orden actual. No se consideran asignaciones a HISTCMD. Si HISTCMD no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

HOSTNAME

Asignados automáticamente al nombre del anfitrión (equipo) actual.

HOSTTYPE

Asignado automáticamente a una cadena que describe de forma unívoca el tipo de máquina en la que bash se está ejecutando. El valor predefinido depende del sistema.

LINENO

Cada vez que este parámetro es referenciado, la shell sustituye un número en base 10 representando el número de línea secuencial actual (empezando por 1) dentro de un script o función. Si no estamos en un script o función, no se garantiza que el valor sustituido tenga significado. Si LINENO no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

MACHTYPE

Asignado automáticamente a una cadena que describe completamente el tipo de sistema en el que bash se está ejecutando, en el formato estándar de GNU cpu-compañía-sistema. El valor predefinido depende del sistema.

MAPFILE

Una matriz variable (consulte Matrices a continuación) creada para incluir el texto captado por la orden nativa mapfile cuando no se indica ningún nombre de variable.

OLDPWD

El directorio de trabajo anterior como lo puso la orden cd.

OPTARG

El valor del último argumento que es una opción procesado por la orden nativa getopts (consulte ÓRDENES NATIVAS DE LA SHELL a continuación).

OPTIND

El índice del siguiente argumento a ser procesado por la orden nativa getopts (consulte ÓRDENES NATIVAS DE LA SHELL más adelante).

OSTYPE

Asignado automáticamente a una cadena que describe el sistema operativo en el que bash se está ejecutando. El valor predefinido depende del sistema.

PIPESTATUS

Una variable vector (consulte Vectores más adelante) que contiene una lista de valores de estado de salida de los procesos en la tubería en primer plano ejecutada más recientemente (que puede contener una sola orden).

PPID

El PID del proceso padre de la shell. Esta variable es de lectura exclusiva.

PWD

El directorio de trabajo actual como lo pone la orden cd.

RANDOM

Cada vez que este parámetro sea referenciado, se genera un entero aleatorio entre 0 y 32767. Si se asigna un valor a RANDOM se inicia (se 'siembra') la secuencia de números aleatorios. Si RANDOM no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

READLINE_ARGUMENT

Cualquier argumento numérico dado un una orden Readline definido mediante "bind -x" (consulte ÓRDENES NATIVAS DE LA SHELL a continuación) cuando se ha invocado.

READLINE_LINE

Contenido del buffer de línea de readline, para emplear con "bind -x" (consulte ÓRDENES NATIVAS DE LA SHELL a continuación).

READLINE_MARK

Posición de la marca (punto de inserción) en la línea guardad de readline para emplear con "bind -x" (consulte ÓRDENES NATIVAS DE LA SHELL más adelante). Los caracteres situadoes entre el punto de inserción y la marca suelen denominarse región.

READLINE_POINT

Posición del punto de inserción en la línea guardada de readline, para emplear con "bind -x" (consulte ÓRDENES NATIVAS DE LA SHELL a continuación).

REPLY

La línea de entrada leída por la orden nativa read cuando no se le dan argumentos.

SECONDS

Cada vez que este parámetro es referenciado, se devuelve en él el número de segundos transcurridos desde la llamada al shell. Si se asigna un valor a SECONDS, el valor devuelto en posteriores referencias es el número de segundos desde la asignación más el valor asignado. La cantidad de segundos transcurridos hasta la llamada de la shell y hasta el momento actual vienen dados por el reloj del sistema. Si SECONDS no está definido, pierde sus propiedades especiales, incluso si posteriormente es redefinido.

SHELLOPTS

Una lista, de elementos separados por dos puntos, de opciones activas del shell. Cada palabra en la lista es un argumento válido para la opción -o de la orden nativa set (consulte ÓRDENES NATIVAS DE LA SHELL más adelante). Las opciones que aparecen en SHELLOPTS son aquéllas que aparecen como on en set -o. Si esta variable está en el entorno cuando bash empieza, cada opción de la shell en la lista se activará antes de leer cualquier archivo de inicio. Esta variable es de lectura exclusiva.

SHLVL

Se incrementa en uno cada vez que se inicia una nueva instancia de bash.

SRANDOM

Esta variable se expande en un número pseudo-aleatorios de 32-bits cada vez que es referenciada. El generador de números aleatorios no es líneal en los sistemas con soporte para /dev/urandom o arc4random por lo que cada número generado no tendrá ninguna relación con los anteriores. No es posible 'sembrar' el generador por lo que no tendrán ningún efecto las asignaciones a esta variable. Si SRANDOM no está definido, pierde todas sus propiedades aunque se redefina posteriormente.

UID

Se expande al UID del usuario en curso, puesta en el inicio de la shell. Esta variable es de solo lectura.

la shell hace uso de las siguientes variables. En algunos casos, bash asigna un valor predeterminado a una variable; estos casos se indican a continuación.

BASH_COMPAT

Este valor define el nivel de compatibilidad de la shell. Más adelante en MODO DE COMPATIBILIDAD DE LA SHELL puede leer la descripción de los distintos niveles de compatibilidad y sus efectos. Su valor puede ser un número decimal (p.ej: 4.2) o un entero (p.ej: 42) debiendo corresponder al nivel de compatibilidad deseado. Si BASH_COMPAT no está definido o lo está como una cadena vacía, el nivel de compatibilidad se establecerá al de la versión actual. Si se define a un valor inválido (no coincida con ningún valor válido de compatibilidad), la shell mostrará un mensaje de error y definirá el nivel de compatibilidad por defecto al de la versión actual. Los valores válidos de compatibilidades se definen más adelante bajo el epígrafe MODO DE COMPATIBILIDAD DE LA SHELL. Ejemplos de valores válidos serían 4.2 o 42, ambos correspondientes a la opción compat42 shopt definiendo el nivel de compatibilidad a 42. La versión actual también es un nivel de compatibilidad válido.

BASH_ENV

Si este parámetro está definido cuando bash está ejecutando un script de shell, su valor se interpreta como un nombre de archivo que contiene órdenes para iniciar la shell, como en ~/.bashrc. El valor de BASH_ENV está sujeto a expansión de parámetros, sustitución de órdenes y expansión aritmética, antes de ser interpretado como un nombre de archivo. PATH no se usa para buscar el nombre de archivo resultante.

BASH_XTRACEFD

Si se le asigna un número entero cuyo valor coincida con un descriptor de archivo válido, bash anotará la salida generada cuando set -x está activada para este descriptor de archivo. El descriptor de archivo se cerrará cuando BASH_XTRACEFD se desactive o se le asigne un valor nuevo. Si se desactiva o se le asigne una cadena vacía, la salida de la traza se envía a la salida de error estándar. Observe que si se define a 2 el valor de BASH_XTRACEFD (descriptor de archivo de error estándar) y a continuaciń de desactiva se provocará el cierre de la salida de error estándar.

CDPATH

Ruta de búsqueda para la orden cd. Es una lista de directorios separados por dos puntos en los cuales la shell busca directorios destino especificados por la orden cd. Un valor de muestra es ".:~:/usr".

CHILD_MAX

Define el valor númerico del estado de salida del descendiente para ser recordado por la shell. Bash no permitirá que este valor se reduzca más allá de lo definido por POSIX, el valor máximo (actualmente 8192) tampoco puede ser excedido. El valor mínimo varía según el sistema.

COLUMNS

Utilizado por la orden compuest select para determinar el ancho del terminal al imprimir listas de selección. Si la opción checkwinsize está activada o si, estando en una shell interactiva, se recibe una señal SIGWINCH, seactivará automáticamente.

COMPREPLY

Variable vectorial donde bash leerá las diferentes posibilidades de autocompletado que genere una función de la shell invocada por la utilidad de autocompletado programable (consulte Autocompletado Programable más adelante). Cada elemento del vector contiene una posibilidad de autocompletado.

EMACS

Si bash encuentra esta variable en el entorno cuando se inicia con el valor "t", interpretará que se está ejecutando dentro de un buffer de Emacs y deshabilitará la edición de línea.

ENV

Se expande y ejecuta de modo similar a BASH_ENV (consulte INVOCACIÓN anteriormente) cuando se invoa en modo posix una shell interactiva.

EXECIGNORE

Lista de patrones de la shell separados por comas (consulte Concordancia de Patrones) que definen nombres de archivos que cualquier orden debe ignorarse al realizar búsquedas mediante PATH. Aquellos archivos cuyo nombre completo (ruta incluida) concuerden con alguno de estos patrones no se considerarán archivos ejecutables a efectos de autocompletado de órdenes y ejecución de órdenes a través de búsquedas mediantes PATH. Esto no afecta al comportamiento de las órdenes [,test ni [[. Los nombres de ruta completos en la tabla hash de órdenes no están sujetos a EXECIGNORE. Esta variable debe usarse para ignorar bibliotecas compartidas marcadas como ejecutables pero que no lo son. La concordancia de patrones tiene en cuenta la opción de la shell extglob.

FCEDIT

El editor predeterminado para la orden nativa fc.

FIGNORE

Una lista de sufijos separados por dos puntos que no hay que tener en cuenta cuando se realice una terminación de nombres de ficheros (consulte READLINE más adelante). Un nombre de archivo cuyo sufijo concuerde con una de las entradas en FIGNORE se excluye de la lista de nombres de archivo a completar. Un valor de muestra es ".o:~".

FUNCNEST

Si se le asigna un valor mayor de cero, definirá el máximo nivel de anidamiento. Las funciones que se invoquen con un nivel mayor provocarán que se interrumpa la ejecución de la orden en curso.

GLOBIGNORE

Una lista de patrones separados por dos puntos que definen en conjunto de nombres de ficheros que no hay que tener en cuenta en la expansión de nombres de ruta. Si un nombre de fichero que concordaba en un patrón de expansión de nombres de rutas también concuerda con uno de los patrones en GLOBIGNORE, se quita de la lista de concordancias.

HISTCONTROL

Lista de valores separados por comas que gestiona la forma en que las órdenes se guardan en el histórico. Si esta lista contiene ignorespace, no se guardarán en el histórico las líneas que comiencen por un espacio. Un vale de ignoredups hará que no se guarden las líneas que coincidan con la entrada inmediatamente anterior. ignoreboth es una combinación de ignorespace e ignoredups. erasedups hará que se borren todas las entradas anteriores que coincidan con la línea actual antes de insertarse ésta. Cualquier valor distinto de los anteriores será ignorado. Si HISTCONTROL no está definido o no contiene un valor válido se guardarán en el histórico todas las líneas leídas por la shell, siempre según el valor de HISTIGNORE. La segunda y subsiguientes líneas de una órden compuesta multilínea no se chequean y por lo tanto, se guardan en el histórico independientemente del valor de HISTCONTROL.

HISTFILE

El nombre del archivo en el que se guarda el historial de órdenes (consulte HISTORIAL más adelante). El valor predeterminado es ~/.bash_history. Si no está definido, no se guarda el historial de órdenes cuando se finalice una shell interactivo.

HISTFILESIZE

El número máximo de líneas contenidas en el historial. Cuando se asigna un valor a esta variable, el historial se trunca, si es menester, para evitar sobrepasar dicho número de líneas. El valor predeterminado es 500. El historial se trunca también a este tamaño cuando finaliza una shell interactiva.

HISTIGNORE

Una lista de patrones separados por dos puntos empleados para decidir qué líneas de órdenes deben guardarse en el historial. Cada patrón se ancla al principio de la línea y debe especificar la línea completamente (no se añade ningún `*'). Cada patrón se comprueba con la línea tras aplicarse las comprobaciones especificadas por HISTCONTROL. Además de los caracteres normales de concordancia de patrones de la shell, `&' concuerda con la línea de historia anterior. `&' puede protegerse empleando una barra inversa. Ésta se quita antes de intentarse una concordancia. La segunda línea y siguientes de una orden compuesta multi-línea no se comprueban, y se añaden a la historia sin importar el valor de HISTIGNORE. La concordancia de patrones depende de la configuración de la opción de la shell extglob.

HISTSIZE

Cantidad de órdenes que debe guardar el historial (Consulte HISTORIAL más adelante). Si el valor es cero, no se guardarán las órdenes en el historial. Cualquier valor negativo hará que se guarden todas las órdenes sin límite alguno. Por defecto, la shell guarda 500 órdenes después de leer los archivos de inicio.

HISTTIMEFORMAT

Si esta variable está definida y no es nula, su valor se usa como una cadena de formato para strftime(3) para mostrar la marca temporal asociada con cada entrada del historial mostrado por la órden nativa history. Si se establece esta variable, las marcas temporales se escriben en el historial para que puedan conservarse en las sesiones de la shell. Se utiliza el carácter de comentario del historial para distinguir las marcas temporales de otras líneas del historial.

HOME

El directorio inicial de trabajo del usuario en curso; el argumento predeterminado para la orden nativa cd. El valor de esta variable se usa también cuando se realiza la expansión de tilde.

HOSTFILE

Contiene el nombre de un fichero con el mismo formato que /etc/hosts que debería leerse cuando la shell necesite completar un nombre de equipo. El archivo puede ser modificado durante la ejecución de la shell; la siguiente vez que se intente completar un nombre de equipo, bash añade el contenido del nuevo archivo a la base de datos ya existente. Si está definida la variable HOSTFILE pero no tiene ningún valor asignado o tiene asignado el nombre de un archivo que no se puede leer, bash intentará leer /etc/hosts para conseguir la lista de posibles nombres de equipo. Si se resetea el valor de HOSTFILE se vacia la lista de nombres de equipo.

IFS

El Separador Interno de Campo que se emplea para la división de palabras tras la expansión y para dividir líneas en palabras con la orden nativa read. El valor predeterminado es “<espacio><tab><nueva-línea>”.

IGNOREEOF

Controla la acción de una shell interactiva al recibir un carácter EOF como sola entrada. Si está definido, el valor es el número de caracteres EOF consecutivos que deben teclearse como los primeros caracteres de una línea de entrada antes de que bash acabe. Si la variable existe pero no tiene un valor numérico, o ninguno, el valor predeterminado es 10. Si no existe, EOF significa el final de la entrada para la shell.

INPUTRC

El nombre de fichero para el de inicio de readline, en vez del predeterminado ~/.inputrc (consulte READLINE más adelante).

INSIDE_EMACS

Si está presente esta variable cuando se inicia la shell, bash asume que se está ejecutando en el buffer de una shell de Emacs y podrá deshabilitar la edición en línea según el valor de TERM.

LANG

Empleado para determinar la categoría de localización ("escenario") para cualquier categoría no seleccionada específicamente con una variable de las que empiezan por LC_.

LC_ALL

Esta variable tiene preferencia sobre el valor de LANG y de cualquier otra variable de las que empiecen por LC_ especificando una categoría de localización.

LC_COLLATE

Esta variable determina el orden de clasificación empleado cuando se ordene el resultado de una expansión de nombres de rutas, y determina el comportamiento de expresiones de intervalo, clases de equivalencia, y secuencias de clasificación dentro de expansiones de nombres de rutas y concordancia de patrones.

LC_CTYPE

Esta variable determina la interpretación de caracteres y el comportamiento de clases de caracteres dentro de expansiones de nombres de rutas y concordancia de patrones.

LC_MESSAGES

Esta variable determina la localización empleada para traducir cadenas entrecomilladas con comillas dobles precedidas por un $.

LC_NUMERIC

Esta variable determina la localización empleada para el formato de los números.

LC_TIME

Esta variable determina la localización empleada para el formato de fecha y hora.

LINES

Utilizada por la orden compuesta select para determinar la longitud de la columna para mostrar listas de selección. Definida automáticamente siempre que la opción checkwinsize está activada o cuando se reciba una señal SIGWINCH en una shell interactiva.

MAIL

Si este parámetro está puesto a un nombre de archivo y la variable MAILPATH no está definida, bash informa al usuario de la llegada de correo en el archivo definido o con formato Maildir.

MAILCHECK

Define la frecuencia (en segundos) a la que bash comprueba si hay correo nuevo. El valor predeterminado es 60 s. Si es hora de comprobar si hay correo, la shell lo hace antes de mostrar el indicador primario. Si esta variable no está definida, o lo está con un valor inferior a cero, la shell no comprueba si hay correo nuevo.

MAILPATH

Una lista de nombres de fichero separados por dos puntos donde hay que comprobar si hay correo nuevo. El mensaje que haya que mostrar cuando llegue correo a un fichero particular puede especificarse separando el nombre de fichero del mensaje con un '?'. Cuando se use en el texto del mensaje, $_ se expande al nombre del fichero de correo en curso. Ejemplo:

OPTERR

Si se pone al valor 1, bash muestra mensajes de error generados por la orden nativa getopts (consulte ÓRDENES NATIVAS DE LA SHELL más adelante). OPTERR se inicia a 1 cada vez que se llama al shell o cuando se ejecuta un script de la shell.

PATH

La ruta de búsqueda para órdenes, programas ejecutables. Es una lista de directorios separados entre si por dos puntos en los cuales la shell busca órdenes (consulte EJECUCIÓN DE ÓRDENES a continuación). La ruta predeterminada depende del sistema siendo definida por el administrador que instala bash. Un valor habitual es ``/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin''.

POSIXLY_CORRECT

Si esta variable está en el entorno cuando de inicie bash, la shell entrará en modo posix antes de cargar los archivos de inicio igual que si se emplease la opción --posix. Si se define una vez que la shell se está ejecutando, bash activará el modo posix tal como si la orden set -o posix se hubiese ejecutado. Cuando la shell entra en modo posix, definirá está variable si no lo está ya.

PROMPT_COMMAND

si esta variable está definida (y es vectorial), se ejecutará el valor de cada elemento como una orden antes de emitir cada prompt primario. Si está definido pero no es una variable vectorial, se usará ese valor como orden para ejecutar.

PROMPT_DIRTRIM

Si su valor es un número mayor que cero, su valor definirá la cantidad de componentes finales de directorios que se retienen al expandir las cadenas de escape \w y \W del indicador (prompt) (sonsulte PROMPTING más adelante). Los caracteres eliminados se sustituyen por una elipsis.

PS0

El valor de este parámetro se expande (consulte INDICADORES más adelante) y lo muestran las shells interactivas después de leer una orden y despuñes de que sea ejecutada.

PS1

El valor de este parámetro se expande (consulte INDICADORES más adelante) y se emplea como la cadena del indicador primario. El valor predeterminado es “\s-\v\$ ”.

PS2

El valor de este parámetro se expande como con PS1 y se emplea como la cadena del indicador secundario. El valor predeterminado es “> ”.

PS3

El valor de este parámetro se emplea como el indicador para la orden select (consulte GRAMÁTICA DE LA SHELL anteriormente).

PS4

El valor de este parámetro se expande como con PS1 y el valor se imprime antes de cada orden que bash muestra durante una traza de ejecución. El primer carácter de PS4 se replica múltiples veces, tantas como sean necesarias, para indicar múltiples niveles de indirección. El valor predeterminado es “+ ”.

SHELL

Se expande al nombre completo de la ruta de la shell. Si no está definida al inicio de la shell, bash le asignará la ruta completa de la shell de inicio actual del usuario.

TIMEFORMAT

El valor de este parámetro se emplea como una cadena de formato para especificar cómo debe mostrarse la información de tiempos para tuberías precedidas por la palabra reservada time. El carácter % introduce una secuencia de escape que se expande a un valor de tiempo o a otra información. Las secuencias de escape y sus significados son como sigue; los corchetes denotan partes opcionales.

La p opcional es un dígito que especifica la precisión, el número de decimales. Un valor de 0 hace que no se muestre ningún decimal, ni el punto o coma decimal. Como mucho se pueden especificar tres decimales; valores de p mayores de 3 se cambian a 3. Si p no se especifica, se usa precisamente el valor 3.

La l opcional especifica un formato más largo, incluyendo minutos, en la forma MMmSS.FFs. El valor de p determina si se incluye o no la fracción.

Si esta variable no está definida, bash actúa como si tuviera el valor $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. Si el valor es nulo, no se muestra ninguna información de tiempos. Se añade un salto de línea al final cuando se muestra la cadena de formato.

TMOUT

Si se define a un valor mayor que cero, TMOUT se interpreta como la cantidad de segundos de timout de la orden nativa read. Si se espera alguna entrada desde un terminal, la orden select finaliza si ésta no llega transcurridos TMOUT segundos. En una shell interactiva, este valor representa la cantidad de segundos a esperar por una entrada; si éste no llega, se muestra el indicador primario. Bash finalizará transcurrida dicha cantidad de segundos no llega una línea completa de entrada.ue hay que esperar una entrada después de mostrarse el indicador primario. Bash termina después de esperar ese número de segundos si no recibe ninguna entrada.

TMPDIR

Si está definido, bash empleará su valor como nombre del directorio en el que creará los archivos temporales necesario para su el uso de la shell.

auto_resume

Esta variable controla cómo la shell interactúa con el usuario para el control de tareas. Si esta variable está definida, las órdenes simples de una palabra sin redirección se tratan como candidatas para reanudar una tarea existente detenida. No se permite ninguna ambigüedad; si hay más de una tarea que empiece con la cadena tecleada, se selecciona la que se ha accedido más recientemente. El nombre de una tarea detenida, en este contexto, es la línea de órdenes empleada para iniciarlo. Si se define al valor exact, la cadena suministrada debe concordar exactamente con el nombre de una tarea detenida; si se define como substring, la cadena suministrada necesita concordar con una subcadena del nombre de una tarea detenida. El valor substring proporciona una funcionalidad análoga a la del identificador de tarea %? (consulte CONTROL DE TAREAS más adelante). Si se pone a cualquier otro valor, la cadena suministrada debe ser un prefijo del nombre de una tarea detenida; esto proporciona una funcionalidad análoga a la del identificador de tarea %cadena.

histchars

Los dos o tres caracteres que controlan la expansión y separación en lexemas de la historia (consulte EXPANSIÓN DEL HISTORIAL a continuación). El primer carácter es el carácter de expansión del historial, el carácter que señala el comienzo de una expansión de historia, normalmente `!'. El segundo carácter es el carácter de sustitución rápida, que se usa como una abreviatura para reejecutar la orden anterior, sustituyendo una cadena por otra en la orden. El valor predeterminado es `^'. El tercer carácter, opcional, es el carácter que indica que el resto de la línea es un comentario cuando se encuentra como el primer carácter de una palabra, normalmente es `#'. El carácter de comentario de historia hace que la sustitución de historia se salte en el resto de palabras de la línea. No hace que necesariamente el analizador léxico de la shell trate al resto de la línea como un a un comentario.

Vectores¶

Bash proporciona variables vectores monodimensionales, indexados y asociativos. Cualquier variable puede usarse como un vector indexado; la orden nativa declare declarará un vector de forma expresa. No hay un límite máximo en el tamaño de un vector, ni ningún requisito para que los miembros se indexen o asignen de forma contigua. Los vectores se indexan empleando enteros (incluso expresiones aritméticas) y su primer elemento es el de índice cero, los vectores asociativos se referencian empleando cualquier cadena. Salvo que se indique expresamente lo contrario, los índices de los vectores indexados deberán ser siempre enteros positivos.

Un vector indexado se crea automáticamente si se asigna algo a una variable con la sintaxis nombre[índice]=valor. El índice se trata como una expresión aritmética que debe evaluarse a un número. Para declarar un vector explícitamente, emplee declare -a nombre (consulte ÓRDENES NATIVAS DE LA SHELL más adelante). También se acepta declare -a nombre[índice], donde el índice no se tiene en cuenta.

Los vectores asociativos se crean mediante declare -A nombre.

Se pueden definir atributos para una variable vectorial utilizando las órdenes nativas declare y readonly. Cada atributo se aplica a todos los componentes de un vector.

Los vectores se asignan mediante asignaciones compuestas en la forma nombre=(valor1 ... valorn), donde cada valor puede tener la forma [subíndice]=cadena. Las asignaciones de vectores indexados no requieren nada más que cadenas. Cada valor de la lista se expande utilizando todas las expansiones de shell que se describen a continuación en EXPANSIÓN. Al asignar a matrices indexadas, si se proporcionan los corchetes y el subíndice opcionales, ese índice se asigna; sino, el índice del elemento asignado es el último índice asignado por la declaración más uno. La indexación comienza en cero.

Cuando se asignana a un vector asociativo, las palabras en una asignación compuesta pueden ser declaraciones de asignación, para las cuales se requiere el subíndice, o una lista de palabras que se interpreta como una secuencia de claves y valores alternos:nombre=( clave1 valor1 clave2 valor2 ...). Estos se tratan de manera idéntica a nombre=( [clave1]=valor1 [clave2]=valor2 ... ). La primera palabra de la lista determina cómo se interpretan las palabras restantes; todas las asignaciones en una lista deben ser del mismo tipo. Cuando se utilizan pares clave/valor, las claves no pueden faltar ni estar vacías; si falta cualquier valor, se trata como una cadena vacía.

Esta sintaxis también es aceptada por la orden nativa declare . Se pueden asignar elementos de individuales de un vector utilizando la sintaxis nombre [subíndice]=valor introducida anteriormente. Al asignar a un vector indexado, si nombre tiene un subíndice de un número negativo, ese número se interpreta como relativo a uno mayor que el índice máximo de nombre, por lo que los índices negativos cuentan hacia atrás desde el final de la matriz y un índice de -1 hace referencia al último elemento.

El operador += realizará añadidos a una variable vectorial cuando se haga con la sintaxis adecuada. Consulte PARÁMETROS anteriormente.

Cualquier elemento de un vector puede referenciarse mediante ${nombre[índice]}. Las llaves son necesarias para evitar conflictos con la expansión de nombres de rutas. Si índice es @ o *, la palabra se expande a todos los miembros de nombre. Estos índices difieren solamente cuando la palabra aparece entre comillas dobles. Si la palabra está entre comillas dobles, ${nombre[*]} se expande a una sola palabra con el valor de cada miembro del vector separados por el primer carácter de la variable especial IFS, y ${nombre[@]} expande cada elemento de nombre a una palabra separada. Cuando no hay miembros del vector, ${nombre[@]} se expande a nada. Si la expansión entre dobles comillas ocurre dentro de una palabra, la expansión del primer parámetro se une al inicio de la palabra original y la expansión del último se une al final de dicha palabra. Esto es análogo a la expansión de los parámetros especiales * y @ (consulte Parámetros especiales anteriormente). ${#nombre[índice]} se expande a la longitud de ${nombre[índice]}. Si índice es * o @, la expansión es el número de elementos del vector. Si índice empleado para referirse a un elemento de un vector indexado equivale a un número menor que cero se entenderá como un número mayor que el máximo índice del vector, un índice de -1 se referirá al último elemento.

Referenciar la variable de un vector sin un subíndice equivale a hacerlo con el subíndice cero. Es aceptable cualquier referencia a una variable usando un subíndice válido. bash creará un vector si necesario.

Se considera definidad a aquella variable de un vector si se asignó un valor a un subíndice. La cadena vacía es un valor válido.

Es posible obtener las claves (índices) de un vector así como los valores. ${!nombre[@]} y ${!nombre[*]} se expande a los índices asignados en la variable vectorial nombre . El tratamiento entre comillas dobles es similar a la expansión de los parámetros especiales @ y * entre comillas dobles.

La orden nativa unset se emplea para eliminar vectores. unset nombre[índice] elimina el elemento del vector con el índice definido tanto en vectores asociativos como indexados. Los índices negativos en vectores indexados se interpretan tal como se describió anteriormente. Aunque se desactive el último elemento de una variable vectorial, no se desactivará dicha variable. unset nombre, donde nombre es un vector, eliminará por completo dicho vector. unset nombre[índice], donde índice es * o @, tendrá un comportamiento diferente según sea un vector asociativo o indexado. Si nombre es un vector asociativo, desactivará el elemento con índice * o @. Si nombre es un vector indexado, se eliminarán todos los elementos, no así el propio vector.

Cuando se utiliza un nombre de variable con un subíndice como argumento para una orden, tal como unset , sin utilizar la sintaxis de expansión de palabras descrita anteriormente, el argumento está sujeto a la expansión del nombre de ruta. Para evitar la expansión del nombre de la ruta, se debe citar el argumento.

Las órdenes nativas declare, local, y readonly aceptan cada una una opción -a para especificar un vector indexado (indexed array) y la opción -A para especificad un vector asociativo (asociative array). Si se define ambas opciones, prevalecerá -A. La orden nativa read acepta una -a para asignar una lista de palabras leídas desde la entrada estándar a un vector. Las órdenes nativas set y declare muestran valores de un vector en una manera tal que les permite ser reutilizadas como asignaciones.

Expansión de Llaves¶

La expansión de llaves es un mecanismo por el cual pueden generarse cadenas arbitrarias. Este mecanismo es similar a la expansión de nombre de ruta, pero los nombres de archivo creados no necesitan existir. Los patrones a ser expandidos con la expansión de llaves toman la forma de un preámbulo opcional seguido por bien por una serie de cadenas separadas por comas entre un par de llaves o por una expresión secuencial entre llaves, seguido por un post scriptum opcional. El preámbulo sirve de prefijo a cada cadena de entre las llaves, y el post scriptum se añade luego a cada cadena resultante, expandiendo de izquierda a derecha.

Las expansiones de llaves pueden anidarse. Los resultados de cada cadena expandida no se ordenan; se preserva el orden de izquierda a derecha. Por ejemplo, a{d,c,b}e se expande a `ade ace abe'.

Una expresión de secuencia toma la forma {x..y[..incr]}, donde x e y son números enteros o letras individuales, e incr un incremento opcional, es un número entero. Cuando se proporcionan números enteros, la expresión se expande a cada número entre x e y, inclusive. Los números enteros proporcionados pueden tener el prefijo 0 para forzar que cada término tenga el mismo tamaño. Cuando x o y comienzan con un cero, la shell intenta forzar que todos los términos generados contengan el mismo número de dígitos, relenando con ceros donde sea necesario. Cuando se proporcionan letras, la expresión se expande lexicográficamente a cada carácter entre x e y, inclusive, utilizando la el locale C. Nota que tanto x como y deben ser del mismo tipo (número entero o letra). Cuando se indica el incremento, se utiliza como la diferencia entre cada término. El incremento por defecto es 1 o -1 según corresponda.

La expansión de llaves se realiza antes que cualquier otra, y cualquier carácter especial para otras expansiones se preserva en el resultado. Es estrictamente textual. Bash no aplica ninguna interpretación sintáctica al contexto de la expansión ni al texto entre las llaves.

Una expansión de llaves correctamente formada debe contener llaves de apertura y cierre sin entrecomillar, y al menos una coma sin entrecomillar o una secuencia válida. Cualquier expansión de llaves formada incorrectamente se deja inalterada. Una { o , puede protegerse con una barra invertida para evitar que sea considerada como parte de una expansión de llaves. Para evitar conflictos con la expansión de parámetros, la cadena ${ no puede incorporarse en una expansión de llaves y evita que se ocurra hasta la llave de cierre }.

Esta construcción se emplea normalmente como una abreviatura cuando el prefijo común de las cadenas a generar es mayor que en el ejemplo de antes:

La expansión de llaves introduce una pequeña incompatibilidad con versiones anteriores de sh. sh no considera como caracteres especiales a las llaves de apertura o cierre cuando aparecen como parte de una palabra, y las deja en la entrada. Bash quita las llaves de palabras, como una consecuencia de la expansión de llaves. Por ejemplo, una palabra introducida a sh como fichero{1,2} aparece así mismo en la entrada. La misma palabra se muestra como fichero1 fichero2 tras la expansión hecha por bash. Si se desea una compatibilidad estricta con sh, inicie bash con la opción +B o inhabilite la expansión de llaves con la opción +B de la orden nativa set (consulte ÓRDENES NATIVAS DE LA SHELL más adelante).

Expansión de Tilde¶

Si una palabra comienza con un carácter tilde de la ñ sin entrecomillar (`~'), todos los caracteres que precedan a la primera barra inclinada sin entrecomillar (o todos los caracteres, si no hay ninguna barra inclinada sin proteger), se consideran un prefijo-tilde. Si ninguno de los caracteres en el prefijo-tilde están protegidos, los caracteres en el prefijo-tilde que siguen a la tilde se tratan como un posible nombre de entrada de usuario (login). Si este nombre de entrada es la cadena vacía, la tilde se reemplaza con el valor del parámetro de la shell HOME. Si HOME no está definida, se sustituye en su lugar el directorio de trabajo inicial del usuario que está ejecutando la shell. De otra forma, el prefijo-tilde se reemplaza con el directorio de trabajo inicial (de casa) asociado con el nombre de entrada especificado.

Si el prefijo-tilde es un `~+', el valor de la variable de la shell PWD reemplaza al prefijo-tilde. Si el prefijo-tilde es un `~-', el valor de la variable de la shell OLDPWD, si está definido, se sustituye. Si los caracteres que siguen a la tilde en el prefijo-tilde consisten en un número N, prefijado opcionalmente por un `+' o un `-', el prefijo-tilde se reemplaza con el elemento correspondiente de la pila de directorios, como lo mostraría la orden nativa dirs llamada con el prefijo-tilde como argumento. Si los caracteres tras la tilde en el prefijo-tilde consisten en un número sin un `+' ni `-' iniciales, se supone `+'.

Si el nombre de entrada es inválido, o si la expansión de tilde falla, la palabra se deja tal cual.

A cada asignación de variable se comprueba si hay prefijos-tilde sin entrecomillar inmediatamente tras un : o el primer =. En estos casos, la expansión de tilde también tiene lugar. Consecuentemente, uno puede usar nombres de ficheros con tildes en asignaciones a PATH, MAILPATH, y CDPATH, y la shell asigna el valor expandido.

Bash también realiza expansión de tilde en palabras que satisfacen las condiciones de asignaciones variables (descrito anteriormente en el apartado PARÁMETROS) cuando aparecen como argumentos de órdenes simples. Bash no hace esto, salvo para la declaración de las órdenes listadas anteriormente, cuando está en modo posix.

Expansión de Parámetro¶

El carácter `$' introduce la expansión de parámetro, sustitución de orden, o expansión aritmética. El nombre de parámetro o símbolo a ser expandido puede estar encerrado entre llaves, que son opcionales pero sirven para proteger a la variable en la expansión de caracteres que la sigan y puedan interpretarse como parte de su nombre.

Cuando se empleen llaves, la de cierre es la primera `}' no protegida con una barra invertida o en una cadena entrecomillada, y no dentro de una expansión aritmética empotrada, sustitución de orden, o expansión de parámetro.

${parámetro}

Se sustituye el valor de parámetro. Se requieren llaves cuando parámetro es un parámetro posicional de más de un dígito, o cuando parámetro viene seguido por un carácter que no debe interpretarse como parte de su nombre. El parámetro es un parámetro de la shell tal como se describe en la sección PARÁMETROS o una referencia a un vector (Vectores).

Si el primer carácter del parámetro es un signo de exclamación (!) y el parámetro no es un nameref, introduce un nivel de direccionamiento indirecto. Bash usa el valor formado expandiendo el resto del parámetro como el nuevo parámetro; esto luego se expande y ese valor se usa en el resto de la expansión, en lugar del expansión del parámetro original. Esto se conoce como expansión indirecta. El valor está sujeto a expansión de tilde, expansión de parámetros, sustitución de órdenes y expansión aritmética. Si el parámetro es un nameref, esto se expande al nombre del parámetro al que hace referencia el parámetro en lugar de realizar la expansión indirecta completa. Las excepciones a esto son las expansiones de ${!prefix*} y ${!name[@]} que se describen a continuación. El signo de exclamación debe seguir inmediatamente a la llave izquierda para introducir la dirección indirecta.

En cada uno de los casos descritos a continuación, sobre palabra se aplican expansión de tilde, expansión de parámetro, sustitución de orden y expansión aritmética.

Cuando no se realiza la expansión de subcadenas, mediantes alguna de las formas documentadas a continuación (por ejemplo, :-), bash prueba si un parámetro no está definido o es nulo. Omitir los dos puntos da como resultado una prueba solo para un parámetro que no está definido.

${parámetro:-palabra}

Emplear valores predeterminados. Si parámetro no está definido o está vacío, se sustituye la expansión de palabra. De otro modo, se sustituye el valor de parámetro.

${parámetro:=palabra}

Asignar valores predeterminados. Si parámetro no está definido o es nulo, la expansión de palabra se asigna a parámetro. Luego, el valor de parámetro se sustituye. No se puede asignar nada de esta manera a los parámetros posicionales ni a los especiales.

${parámetro:?palabra}

Muestra un error si no está definido o está vacío. Si parámetro es nulo o no está definido, la expansión de palabra (o un mensaje a tal efecto si palabra no está presente) se escribe en la salida estándar de errores y la shell, si no es interactivo, acaba. De otra manera, se sustituye el valor de parámetro.

${parámetro:+palabra}

Emplear un valor alternativo. Si parámetro está vacío o no está definido, no se sustituye nada; de otro modo, se sustituye la expansión de palabra.

${parámetro:desplazamiento}

${parámetro:desplazamiento:longitud}

Expansión de subcadena. Se expande hasta longitud caracteres del valor de parámetro comenzando en el carácter especificado en desplazamiento. Si parámetro es @ o *, un vector indexado con un subíndice @ o *, o un nombre de vector asociativo, los resultados difieren como se describe a continuación. Si longitud se omite, se expande a la subcadena del valor de parámetro comenzando en el carácter especificado por offset y extendiéndose hasta el final de el valor. longitud e desplazamiento son expresiones aritméticas (ver EVALUACIÓN ARITMÉTICA a continuación).

Si desplazamiento se evalúa como un número menor que cero, el valor se utiliza como desplazamiento en caracteres desde el final del valor de parámetro. Si longitud se evalúa como un número menor que cero, se interpreta como desplazamiento en caracteres desde el final del valor de parámetro en lugar del número de caracteres, y la expansión son los caracteres entre desplazamiento y ese resultado. Tenga en cuenta que un desplazamiento negativo debe separarse de los dos puntos por al menos un espacio para evitar confundirse con la expansión :-

Si parámetro es @ o *, el resultado es longitud parámetros posicionales que comienzan en desplazamiento. Un desplazamiento negativo se toma relativo a uno mayor que el mayor parámetro posicional, por lo que un desplazamiento de -1 evalúa hasta el último parámetro posicional. Es un error de expansión si longitud se evalúa como un número menor que cero.

Si parámetro es un nombre de vector indexado con subíndice '@' o '*', el resultado serán los miembros longitud de la matriz que comienzan con ${parámetro[desplazamiento]}. Se toma un desplazamiento negativo en relación con uno mayor que el índice máximo del vector especificado. Será un error de expansión si longitud se evalúa como un número menor que cero.

La expansión de subcadena aplicada sobre un vector asociativo produce resultados inesperados.

La indexación de subcadenas se inicia en el cero a menos que se utilicen parámetros posicionales, en cuyo caso la indexación comienza en 1 de forma predeterminada. Si desplazamiento es 0, y se utilizan los parámetros posicionales, se añade el prefijo $0 a la lista

${!prefijo*}

${!prefijo@}

Nombres que coinciden con el prefijo. Se expande a los nombres de las variables cuyos nombres comienzan con prefijo, separados por el primer carácter de la variable especial IFS. Cuando se usa @ y la expansión aparece entre comillas dobles, cada nombre de variable se expandirá a una palabra separada.

${!nombre[@]}

${!nombre[*]}

Lista de claves del vector.Si nombre es una variable vectorial, se expande a la lista de índices del vector (las claves) asignados en nombre. Si nombre no es un vector, se expandirá a 0 si nombre está definido y sino será nulo. Cuando se usa @ y la expansión aparece entre comillas dobles, cada clave se expande a una palabra separada.

${#parámetro}

Parameter length. The length in characters of the value of parameter is substituted. If parameter is * or @, the value substituted is the number of positional parameters. If parameter is an array name subscripted by * or @, the value substituted is the number of elements in the array. If parameter is an indexed array name subscripted by a negative number, that number is interpreted as relative to one greater than the maximum index of parameter, so negative indices count back from the end of the array, and an index of -1 references the last element.

${parámetro#palabra}

${parámetro##palabra}

Remove matching prefix pattern. The word is expanded to produce a pattern just as in pathname expansion, and matched against the expanded value of parameter using the rules described under Pattern Matching below. If the pattern matches the beginning of the value of parameter, then the result of the expansion is the expanded value of parameter with the shortest matching pattern (the “#” case) or the longest matching pattern (the “##” case) deleted. If parameter is @ or *, the pattern removal operation is applied to each positional parameter in turn, and the expansion is the resultant list. If parameter is an array variable subscripted with @ or *, the pattern removal operation is applied to each member of the array in turn, and the expansion is the resultant list.

${parámetro%palabra}

${parámetro%%palabra}

Remove matching suffix pattern. The word is expanded to produce a pattern just as in pathname expansion, and matched against the expanded value of parameter using the rules described under Pattern Matching below. If the pattern matches a trailing portion of the expanded value of parameter, then the result of the expansion is the expanded value of parameter with the shortest matching pattern (the “%” case) or the longest matching pattern (the “%%” case) deleted. If parameter is @ or *, the pattern removal operation is applied to each positional parameter in turn, and the expansion is the resultant list. If parameter is an array variable subscripted with @ or *, the pattern removal operation is applied to each member of the array in turn, and the expansion is the resultant list.

${parámetro/patrón/cadena}

${parámetro//patrón/cadena}

${parámetro/#patrón/cadena}

${parámetro/%patrón/cadena}

Pattern substitution. The pattern is expanded to produce a pattern just as in pathname expansion. Parameter is expanded and the longest match of pattern against its value is replaced with string. string undergoes tilde expansion, parameter and variable expansion, arithmetic expansion, command and process substitution, and quote removal. The match is performed using the rules described under Pattern Matching below. In the first form above, only the first match is replaced. If there are two slashes separating parameter and pattern (the second form above), all matches of pattern are replaced with string. If pattern is preceded by # (the third form above), it must match at the beginning of the expanded value of parameter. If pattern is preceded by % (the fourth form above), it must match at the end of the expanded value of parameter. If the expansion of string is null, matches of pattern are deleted. If string is null, matches of pattern are deleted and the / following pattern may be omitted.

Si la opción de shell pathsub_replacement está activada mediante shopt, cualquier instancia de & sin entrecomillar contenida en cadena será sustituida por la parte concordante de patrón.

Citar cualquier parte de cadena inhibe el reemplazo en la expansión de laparte citada, incluidas las cadenas de reemplazo almacenadas en variables de shellLa barra invertida escapará de & en cadena; la barra invertida se elimina para permitir el carácter & en la cadena de reemplazo. La barra invertida también puede ser usada para escapar otra barra invertida; \\ da como resultado el carácter de barra invertida en reemplazo. Los usuarios deben tener precaución si cadena está entre comillas dobles para evitar interacciones no deseadas entre la barra invertida y las comillas dobles, porque la barra invertida tiene un significado especial entre comillas dobles. Sustitución de patrón realiza la comprobación de & sin comillas después de expandir cadena; los programadores de la shell deben entrecomillar los caracteres & que quieran que se interpretenliteralmente y asegurarse que no esté entrecomillado cualquier carácter & que quieranque sea reemplazado.

If the nocasematch shell option is enabled, the match is performed without regard to the case of alphabetic characters. If parameter is @ or *, the substitution operation is applied to each positional parameter in turn, and the expansion is the resultant list. If parameter is an array variable subscripted with @ or *, the substitution operation is applied to each member of the array in turn, and the expansion is the resultant list.

${parámetro^patrón}

${parámetro^^patrón}

${parámetro,patrón}

${parámetro,,patrón}

Modificación en la capitalización. Esta expansión modifica la capitalización de caracteres en parámetro. El patrón se expande para producir un patrón al igual que en la expansión del nombre de ruta. Cada carácter en el valor expandido de parámetro se prueba con patrón y, si coincide con el patrón, se convierte su capitalización. El patrón no debe intentar coincidir más de un carácter. El operador ^ convierte letras minúsculas, que coinciden con patrón, a mayúsculas; el operador , convierte las mayúsculas coincidentes en minúsculas. Las expansiones ^^ y ,, convierten cada coincidencia en el valor expandido; las expansiones ^ y , coinciden y convierte sólo el primer carácter del valor expandido. Si se omite patrón, se considerará como ?, que coincide con todos los caracteres. Si parámetro es @ o *, la modificación de capitalizaciónse aplica a cada parámetro posicional por turno, y la expansión es la lista resultanteSi parámetro es una variable de matriz con el subíndice @ o *, la modificación de capitalización se aplica a cada miembro de la matriz por turno y la expansión es la lista resultante

${parámetro:operador}

Transformación de parámetros. La expansión puede ser una transformación del valor de parámetro o información sobre el propio parámetro dependiendo del valor del operador. Cada operador consta de una única letra:

Sustitución de Orden¶

La sustitución de orden permite a la salida de una orden reemplazar al nombre de la orden. Hay dos formas:

Bash realiza la expansión ejecutando orden en una subshell y reemplazando la sustitución de orden con la salida estándar de la orden, quitando los saltos de línea finales. Los saltos de línea empotrados no se borran, pero pueden ser eliminados durante la división de palabras. La sustitución de orden $(cat archivo) puede reemplazarse por lo equivalente pero más rápido $(< archivo).

Cuando se emplea la forma de sustitución al viejo estilo con las comillas inversas, la barra invertida mantiene su significado literal excepto cuando es seguida por $, `, o \. La primera comilla inversa no precedida por una barra invertida termina la sustitución de orden. Cuando se emplea la forma $(orden), todos los caracteres entre los paréntesis forman parte de la orden; ninguno se considera como especial.

Las sustituciones de orden pueden anidarse. Para anidar cuando se emplee la forma de comillas inversas, proteja las comillas inversas internas con barras inversas.

Si la sustitución aparece dentro de las dobles comillas, la división de palabras y la expansión de nombres no se realiza en los resultados.

Expansión Aritmética¶

La expansión aritmética permite la evaluación de una expresión aritmética y la sustitución del resultado. El formato para la expansión aritmética es:

La expresión se trata como si estuviera entre comillas dobles, pero un signo de doble comilla en expresión no se considera un carácter especial y se elimina. Todos los lexemas en la expresión están sujetos a expansión de parámetro, expansión de cadena, sustitución de orden, y eliminación de comillas. El resultado se tratará coma la expansión aritmética a evaluar, dichas expansiones pueden anidarse.

La evaluación se realiza de acuerdo a las reglas listadas más adelante en EVALUACIÓN ARITMÉTICA. Si expresión no es válida, bash imprime un mensaje indicando el fallo y no ocurre ninguna sustitución.

Sustitución de Proceso¶

Process substitution allows a process's input or output to be referred to using a filename. It takes the form of <(list) or >(list). The process list is run asynchronously, and its input or output appears as a filename. This filename is passed as an argument to the current command as the result of the expansion. If the >(list) form is used, writing to the file will provide input for list. If the <(list) form is used, the file passed as an argument should be read to obtain the output of list. Process substitution is supported on systems that support named pipes (FIFOs) or the /dev/fd method of naming open files.

Cuando esté disponible, se realiza la sustitución de proceso simultáneamente con la expansión de parámetro y variable, sustitución de orden y expansión aritmética.

División de Palabra¶

la shell examina los resultados de la expansión de parámetro, sustitución de orden y expansión aritmética que no ocurrieron dentro de comillas dobles para realizar la división de palabras.

The shell treats each character of IFS as a delimiter, and splits the results of the other expansions into words using these characters as field terminators. If IFS is unset, or its value is exactly <space><tab><newline>, the default, then sequences of <space>, <tab>, and <newline> at the beginning and end of the results of the previous expansions are ignored, and any sequence of IFS characters not at the beginning or end serves to delimit words. If IFS has a value other than the default, then sequences of the whitespace characters space, tab, and newline are ignored at the beginning and end of the word, as long as the whitespace character is in the value of IFS (an IFS whitespace character). Any character in IFS that is not IFS whitespace, along with any adjacent IFS whitespace characters, delimits a field. A sequence of IFS whitespace characters is also treated as a delimiter. If the value of IFS is null, no word splitting occurs.

Explicit null arguments ("" or '') are retained and passed to commands as empty strings. Unquoted implicit null arguments, resulting from the expansion of parameters that have no values, are removed. If a parameter with no value is expanded within double quotes, a null argument results and is retained and passed to a command as an empty string. When a quoted null argument appears as part of a word whose expansion is non-null, the null argument is removed. That is, the word -d'' becomes -d after word splitting and null argument removal.

Observe que si no hay expansión, tampoco se realiza la división de palabras.

Expansión de Nombres de Ruta¶

After word splitting, unless the -f option has been set, bash scans each word for the characters *, ?, and [. If one of these characters appears, and is not quoted, then the word is regarded as a pattern, and replaced with an alphabetically sorted list of filenames matching the pattern (see Pattern Matching below). If no matching filenames are found, and the shell option nullglob is not enabled, the word is left unchanged. If the nullglob option is set, and no matches are found, the word is removed. If the failglob shell option is set, and no matches are found, an error message is printed and the command is not executed. If the shell option nocaseglob is enabled, the match is performed without regard to the case of alphabetic characters. When a pattern is used for pathname expansion, the character “.” at the start of a name or immediately following a slash must be matched explicitly, unless the shell option dotglob is set. In order to match the filenames “.” and “..”, the pattern must begin with “.” (for example, “.?”), even if dotglob is set. If the globskipdots shell option is enabled, the filenames “.” and “..” are never matched, even if the pattern begins with a “.”. When not matching pathnames, the “.” character is not treated specially. When matching a pathname, the slash character must always be matched explicitly by a slash in the pattern, but in other matching contexts it can be matched by a special pattern character as described below under Pattern Matching. See the description of shopt below under SHELL BUILTIN COMMANDS for a description of the nocaseglob, nullglob, globskipdots, failglob, and dotglob shell options.

La variable de la shell GLOBIGNORE puede utilizarse para restringir el conjunto de nombres de archivo que concuerden con un patrón. Si GLOBIGNORE está definido, cada nombre de archivo concordante que también coincida con uno de los patrones en GLOBIGNORE se quita de la lista de concordancias. Los nombres de archivo “.” y “..” nunca son tenidos en cuenta, incluso cuando GLOBIGNORE esté puesto. Sin embargo, definir GLOBIGNORE activa la opción de la shell dotglob, de modo que todos los otros nombres de archivo que comiencen con un “.” concordarán. Para obtener el comportamiento anterior de no hacer caso de nombres de archivo que comienzan con un “.”, haga que “.*” sea uno de los patrones de GLOBIGNORE. La opción dotglob está deshabilitada cuando GLOBIGNORE no está definido. La concordancia de patrones depende de la configuración de la opción de la sehll extglob.

Concordancia

Cualquier carácter que aparezca en un patrón, aparte de los especiales descritos más adelante, concuerda consigo mismo. El carácter NUL no puede estar en un patrón. Una barra invertida protege al siguiente carácter y no se tiene en cuenta durante la búsqueda de concordancias. Los caracteres de patrón especiales deben protegerse si han de concordar literalmente consigo mismos.

Los caracteres de patrón especiales tienen los siguientes significados:

Si la opción de la shell extglob se activa mediante la orden nativa shopt, se reconocen algunos operadores de patrones avanzados. En la siguiente descripción, una lista-patrón es una lista de uno o más patrones separados por el carácter |. Se pueden formar patrones compuestos usando uno o más de los siguientes sub-patrones:

La opción extglob modifica el funcionamiento del analizador, ya que los paréntesis suelen tratarse como operadores con significado sintáctico. Para asegurarse de que los patrones de concordancia extendidos se analicen correctamente, asegúrese de que extglob esté habilitado antes de analizar construcciones que contienen dichos patrones, incluidas funciones de shell y sustituciones de órdenes.

Al hacer coincidir nombres de archivos, la opción de shell dotglob determina el conjunto de nombres de archivos que se probarán: cuando dotglob está habilitado, el conjunto de nombres de archivos incluye todos los archivos que comienzan por “.”, excepto “.” y “..” debe coincidir con un patrón o subpatrón que comience por un punto; cuando está deshabilitado, el conjunto no incluye ningún nombre de archivo que comience por “.” a menos que el patrón o subpatrón comience con “.”. Como arriba, “.” solo tiene un significado especial cuando coincide con nombres de archivos.

La comparación de patrones extendidos complejos con cadenas largas es lenta, especialmente cuando los patrones contienen alternancias y las cadenas contienen múltiples concordancias. El uso de concordancias separadas para cadenas más cortas, o usar vectores de cadenas en lugar de una sola cadena larga, puede ser más rápido.

Eliminación de Comillas¶

Tras las expansiones precedentes, todas las ocurrencias no entrecomilladas de los caracteres \, ', y " que no resulten de una de las expansiones anteriores, se eliminan.

Redirección de la Entrada¶

La redirección de la entrada hace que el fichero cuyo nombre resulte de la expansión de palabra se abra para lectura en el descriptor de fichero n, o la entrada estándar (descriptor de fichero 0) si no se especificó n.

El formato general para la redirección de la entrada es:

Redirección de la Salida¶

La redirección de la salida hace que el fichero cuyo nombre resulte de la expansión de palabra se abra para escritura en el descriptor de fichero n, o la salida estándar (descriptor de fichero 1) si n no se especificó. Si el fichero no existe se crea; si existe se trunca a longitud cero, se vacía.

El formato general para la redirección de la salida es:

Si el operador de redirección es >, y la opción noclobber de la orden nativa set ha sido activada, la redirección fallará si el nombre de fichero resultante de la expansión de palabra existiera y fuera un fichero regular. Si el operador de redirección es >|, o es > y la opción noclobber de la orden nativa set no está activada, la redirección se intenta incluso si el archivo nombrado por palabra existe.

Añadir a la Salida Redirigida¶

La redirección de la salida en esta forma hace que el fichero cuyo nombre resulte de la expansión de palabra se abra para añadir en el descriptor de fichero n, o la salida estándar (descriptor de fichero 1) si n no se especificó. Si el fichero no existe, se crea.

El formato general para añadir a la salida es:

Redirección de las Salidas Estándar y de Errores¶

Este constructo permite que ambas salidas estándares, la normal (descriptor de archivo 1) y la de errores (descriptor de archivo 2) se redirijan hacia el archivos cuyo nombre sea la expansión de palabra con esta construcción.

hay dos formatos para la redirección de la salida estándar y la salida de errores:

De las dos formas, es preferible la primera. Ésta es semánticamente equivalente a

Cuando se utiliza la segunda forma, palabra no puede expandirse a un número o -. Si es así, se aplican otros operadores de redirección (consulte Duplicación de descriptores de archivos más adelante) en aras de la compatibilidad.

Uniendo las Salidas Estándar y Error¶

Este constructo permite que ambas salidas estándares, la normal (descriptor de archivo 1) y la de errores (descriptor de fichero 2) se redirijan hacia el archivo cuyo nombre sea la expansión de palabra.

el formato para unir la redirección de la salida estándar y la salida de errores sería el siguiente:

Ésta es semánticamente equivalente a

(consulte Duplicación de descriptores de fichero más adelante).

Documentos Internos¶

Este tipo de redirección indica a la shell que lea la entrada desde la fuente actual hasta que vea una línea que contenga solamente separador (sin espacios en blanco al final). Todas las líneas leídas hasta ese punto se emplean como la entrada estándar de una orden.

El formato de los documentos internos es:

[n]<<[-]palabra


        documento-interno
delimitador

No parameter and variable expansion, command substitution, arithmetic expansion, or pathname expansion is performed on word. If any part of word is quoted, the delimiter is the result of quote removal on word, and the lines in the here-document are not expanded. If word is unquoted, all lines of the here-document are subjected to parameter expansion, command substitution, and arithmetic expansion, the character sequence \<newline> is ignored, and \ must be used to quote the characters \, $, and `.

Si el operador de redirección es <<-, entonces se quitan de las líneas de la entrada todos los caracteres de tabulación iniciales, así como de la línea que contiene delimitador. Esto permite que los documentos internos dentro de guiones de la shell se sangren de manera natural.

Cadenas de Documentos Internos¶

Una variante de los documentos internos con el siguiente formato:

[n]<<<palabra

La palabra se ve afectada por expansión de tilde, expansión de parámetros y variables, sustitución de comandos, expansión aritmética y eliminación de comillas. No se realiza expansión de nombres de rutas ni división de palabra. El resultado se proporciona como una sola cadena, añadiéndole el una nueva línea, a la orden en su entrada estándar (o descriptor de archivo n si se especifica n).

Duplicación de Descriptores de Archivo¶

Operador de Redirección

se emplea para duplicar descriptores de ficheros de entrada. Si palabra se expande a uno o más dígitos, el descriptor de fichero denotado por n se hace ser una copia de este descriptor de fichero. Si los dígitos en palabra no especifican un descriptor de fichero abierto para entrada, se produce un error de redirección. Si palabra se evalúa a -, el descriptor de fichero n se cierra. Si n no se especifica, se emplea la entrada estándar (descriptor de fichero 0).

Operador

is used similarly to duplicate output file descriptors. If n is not specified, the standard output (file descriptor 1) is used. If the digits in word do not specify a file descriptor open for output, a redirection error occurs. If word evaluates to -, file descriptor n is closed. As a special case, if n is omitted, and word does not expand to one or more digits or -, the standard output and standard error are redirected as described previously.

Mobilidad de los Descriptores de Archivo¶

Operador de Redirección

moves the file descriptor digit to file descriptor n, or the standard input (file descriptor 0) if n is not specified. digit is closed after being duplicated to n.

De forma análoga, el operador de redirección

moves the file descriptor digit to file descriptor n, or the standard output (file descriptor 1) if n is not specified.

Apertura de Descriptores de Archivo para lectura y escritura¶

Operador de Redirección

hace que el fichero cuyo nombres sea la expansión de palabra se abra para lectura y para escritura en el descriptor de fichero n, o en el descriptor de fichero 0 si no se especifica n. Si el fichero no existe, se crea.

Notación de Readline¶

En esta sección, se emplea la notación al estilo de Emacs para denotar las teclas. Las teclas de control se representan por medio de C-tecla; así, C-n significa Control-N. De forma similar, las teclas meta (Alt) se representan con M-tecla, de forma que M-x significa Meta-X. (En teclados sin tecla meta, M-x significa ESC x, i.e., pulsar la tecla de escape (Esc) y luego la tecla x. Esto hace que ESC sea el prefijo meta. La combinación M-C-x quiere decir ESC-Control-x, o pulsar la tecla Escape y luego mantener presionada la tecla Control mientras se pulsa la tecla x.)

Las órdenes de readline pueden recibir argumentos numéricos que actúan normalmente como un número de repetición. Algunas veces, empero, lo que tiene significado es el signo del argumento. Pasar un argumento negativo a una orden que actúa en la dirección adelante (p. ej., kill-line) hace que esa orden actúe en la dirección contraria, hacia atrás. Las órdenes cuyo comportamiento con argumentos se desvíe de esto se señalan más adelante.

Cuando una orden se describe como que corta texto, el texto borrado se guarda para una posible futura recuperación (pegado). El texto cortado se guarda en un anillo de corte. Cortes consecutivos hacen que el texto se acumule en una unidad, que puede pegarse toda de golpe, de una vez. Las órdenes que no cortan texto separan los trozos de texto en el anillo de corte.

Inicio de Readline¶

Readline is customized by putting commands in an initialization file (the inputrc file). The name of this file is taken from the value of the INPUTRC environment variable. If that variable is unset, readline will read both /etc/inputrc and ~/.inputrc. If that file does not exist or cannot be read, the ultimate default is /etc/inputrc. When a program which uses the readline library starts up, the initialization file is read, and the key bindings and variables are set. There are only a few basic constructs allowed in the readline initialization file. Blank lines are ignored. Lines beginning with a # are comments. Lines beginning with a $ indicate conditional constructs. Other lines denote key bindings and variable settings.

Las definiciones predeterminadas de teclas pueden cambiarse con un fichero inputrc. Otros programas que usen esta biblioteca pueden añadir sus propias órdenes y definiciones.

Por ejemplo, el poner

Se reconocen los siguientes nombres simbólicos de caracteres: RUBOUT, DEL, ESC, LFD, NEWLINE, RET, RETURN, SPC, SPACE, y TAB.

Además de los nombres de órdenes, readline permite que se enlace una tecla cualquiera a una cadena de caracteres que se inserta cuando la tecla se pulse (una macro).

Definiciones de Teclas de Readline¶

La sintaxis para controlar las definiciones de teclas en el fichero inputrc es simple. Todo lo que se requiere es el nombre de la orden o el texto de una macro y una secuencia de teclas con la cual debe enlazarse. El nombre se puede especificar en una de dos formas: como un nombre simbólico de tecla, posiblemente con prefijos Meta- o Control-, o como una secuencia de teclas.

Cuando se use la forma nombre-tecla:nombre-función o macro, nombre-tecla es el nombre de una tecla en inglés. Por ejemplo:

En el ejemplo de arriba, C-u se enlaza a la función universal-argument, M-DEL se vincula a la función backward-kill-word, y C-o se define como que se ejecute la macro expresada en la parte derecha (esto es, insertar el texto ``> output'' en la línea).

En la segunda forma, "sectecla":nombre-función o macro, sectecla difiere de la nombre-tecla de antes en que las cadenas que representan una secuencia entera de teclas pueden especificarse poniendo la secuencia entre comillas dobles. Así se pueden utilizar algunas teclas de escape al estilo de GNU Emacs, como en el siguiente ejemplo, pero no se reconocen los nombres de caracteres simbólicos.

En este ejemplo, C-u se enlaza de nuevo a la función universal-argument. C-x C-r se vincula a la función re-read-init-file, y ESC [ 1 1 ~ se define como que se inserte el texto ``Function Key 1''.

El conjunto completo de las secuencias de escape al estilo de GNU Emacs es

Además de las secuencias de escape al estilo de GNU Emacs, se dispone de un segundo conjunto de escapes con la barra invertida:

Cuando se mete el texto de una macro, se deben emplear comillas simples o dobles para indicar una definición de macro. El texto no entrecomillado se supone un nombre de función. En el cuerpo de la macro, los escapes con barra inversa de arriba se expanden. La barra inversa protegerá a cualquier otro carácter en el texto de la macro, incluyendo a " y a '.

Bash permite mostrar o modificar las definiciones de teclas en curso mediante la orden interna bind. El modo de edición puede cambiarse durante una sesión interactiva empleando la opción -o de la orden interna set (vea ÓRDENES NATIVAS DE LA SHELL más adelante).

Variables de Readline¶

Readline tiene variables que se pueden usar para personalizar más aún su comportamiento. Una variable se puede definir en el fichero inputrc con una sentencia de la forma

Salvo que se indique lo contrario, las variables readline pueden tomar los valores On o Off (sin distinción entre mayúsculas y minúsculas). Los nombres de variables no reconocidas se ignorarán. Cuando se lee un valor de variable, los valores vacíos o nulos, "on" (sin distinción entre mayúsculas y minúsculas) y "1" son equivalentes a On. Todos los demás valores son equivalentes a Off. Las variables y sus valores predeterminados son:

active-region-start-color

Una variable de cadena que controla el color y el fondo del texto cuando se muestra el texto en la región activa (consulte la descripción de enable-active-region a continuación). Esta cadena no debe ocupar físicamente ninguna posición en la pantalla, por lo que debe consistir únicamente en secuencias de escape de terminal. Se envía al terminal antes de mostrar el texto en la región activa. Esta variable se restablece al valor predeterminado cada vez que cambia el tipo de terminal. El valor predeterminado es la cadena que pone el terminal en modo destacado, según se obtiene de la descripción terminfo del terminal. Un valor de muestra podría ser "\e[01;33m".

active-region-end-color

Una variable de cadena que "deshace" los efectos de active-region-start-color y restaura la apariencia "normal" de la pantalla del terminal después de mostrar texto en la región activa. Esta cadena no debe ocupar físicamente ninguna posición en la pantalla, por lo que debe consistir únicamente en secuencias de escape de terminal. Se envía al terminal después de mostrar el texto en la región activa. Esta variable se restablece al valor predeterminado cada vez que cambia el tipo de terminal. El valor predeterminado es la cadena que restaura el terminal desde el modo destacado, tal como se obtiene de la descripción terminfo del terminal. Un valor de ejemplo podría ser "\e[0m".

bell-style (audible)

Controla qué pasa cuando readline quiere tocar el pito de la terminal. Si se define como none, readline nunca toca el pito. Si se pone a visible, readline usa una alerta visible si está disponible. Si se pone como audible, readline intenta hacer sonar el pito de la terminal.

bind-tty-special-chars (On)

Si se establece a On, readline intenta vincular los caracteres de control tratados especialmente por el controlador de terminal del kernel a sus equivalentes en readline.

blink-matching-paren (Off)

Si se establece a On, readline intenta mover el cursor a un paréntesis de apertura cuando se inserte un paréntesis de cierre.

colored-completion-prefix (Off)

Si se establece a On, al enumerar las terminaciones, readline mostrará el prefijo común del conjunto de posibles terminaciones usando un color diferente. Las definiciones de color se toman del valor de la variable de entorno LS_COLORS. Si hay una definición de color en $LS_COLORS para el sufijo personalizado "readline-colored-completion-prefix", readline usará este color para el prefijo común en lugar del predeterminado.

colored-stats (Off)

Si se establece en On, readline mostrará varias posibilidades de autocompletado usando diferentes colores para indicar su tipo de archivo. Las definiciones de color se toman del valor de la variable de entorno LS_COLORS.

comment-begin (“#”)

La cadena que se inserta cuando se ejecuta la orden de readline insert-comment. Esta orden está enlazada a M-# en modo emacs y a # en modo vi.

completion-display-width (-1)

El número de columnas de pantalla utilizadas para mostrar posibles coincidencias cuando se autocompleta. El valor se ignora si es menor que 0 o mayor que el ancho de pantalla del terminal. Un valor de 0 hará que las coincidencias se muestren una por línea. El valor predeterminado es -1.

completion-ignore-case (Off)

Si se pone a On, readline realiza la concordancia y terminación de nombres de ficheros sin importar si las letras son mayúsculas o minúsculas.

completion-map-case (Off)

Si se establece en On, y completion-ignore-case está habilitado, readline trata como equivalentes los guiones medios (-) y los guiones bajos (_) cuando se realizan concordancias y autocompletados de nombres de archivos sin distinción entre mayúsculas y minúsculas.

completion-prefix-display-length (0)

La longitud en caracteres del prefixo común de una lista de posibles autocompletadosque se muestra sin modificación. Cuando se establece un valor mayor que cero, los prefijos comunes más largos que este valor se sustituyen por una elipse cuando se muestran posibles autocompletados.

completion-query-items (100)

Esto determina cuándo se pregunta al usuario si quiere ver el número de terminaciones posibles generadas por la orden possible-completions. Puede ponerse a cualquier valor entero mayor o igual a cero. Si el número de posibles terminaciones es mayor o igual que el valor de esta variable, al usuario se le pregunta si desea o no verlas; si no, simplemente se muestran en la terminal. El valor cero indica que readline no debe preguntar nunca mientras que valores negativos son interpretados igual que el cero.

convert-meta (On)

Si se pone a On, readline convertirá caracteres con el octavo bit definido a una secuencia de teclas ASCII recortando el octavo bit y añadiendo un carácter Esc como prefijo (es decir, usando Esc como el prefijo meta). Por está definido como On, pero readline lo define como Off si la localización contiene caracteres de 8 bits. Esta variable depende de la LC_TYPE pudiendo variar según la localización empleada.

disable-completion (Off)

Si se pone a On, readline inhibirá la terminación de palabras. Los caracteres para la terminación se insertarán en la línea como si se hubieran hecho corresponder con self-insert.

echo-control-characters (On)

Cuando se establece On, en los sistemas operativos que indican que incluyen soporte, readline repite un caracter que corresponde a una señal generada desde el teclado.

editing-mode (emacs)

Controla si readline empieza con un conjunto de definiciones de teclas similar a las de Emacs o vi. editing-mode puede ponerse a los valores emacs o vi.

emacs-mode-string (@)

Si está activa la variable show-mode-in-prompt, esta cadena se muestra inmediatamente antes de la última línea del mensaje principal cuando el modo de edición de emacs está activo. El valor se expande como una combinación de teclas, por lo que el conjunto estándar de prefijos meta, de control y secuencias de escape de barra invertida están disponible. Utilice los escapes \1 y \2 para comenzar y finalizar secuencias de caracteres que no se imprimen, que se pueden utilizar para incrustar una secuencia de control de terminal en la cadena de modo.

enable-active-region (On)

El punto es la posición actual del cursor y marca se refiere a una posición guardada del cursor. El texto entre el punto y la marca se denomina región. Cuando el valor de esta variable se establece en On, readline permite que ciertas órdenes designen la región como activa. Cuando la región está activa, readline resalta el texto en la región usando el valor de active-region-start-color, que de forma predeterminada es la cadena que habilita el modo destacado del terminal. La región activa muestra el texto insertado mediante pegado entre corchetes y cualquier texto concordante encontrado mediante búsquedas incrementales y no incrementales en el histórico.

enable-bracketed-paste (On)

Cuando su valor es On, readline configurará el terminal para insertar cada información que se pegue en el búfer de edición como una única cadena de caracteres, en lugar de tratar cada carácter como si hubiera sido leído desde el teclado. Esto evita que readline ejecute cualquier orden de edición vinculada a secuencias de teclas que puedan aparecer en el texto pegado.

enable-keypad (Off)

Cuando se pone a On, readline intentará activar el teclado auxiliar cuando se llame. Algunos sistemas necesitan esto para activar las teclas de flechas de cursor.

enable-meta-key (On)

Cuando se pone a On, readline intentará activar cualquier modificación con la tecla meta para la que el terminal tenga soporte. En muchos terminales, la tecla meta se usa para escribir caracteres de 8 bits.

expand-tilde (Off)

Si se pone a On, la expansión de tilde se realiza cuando readline intenta la terminación de palabras.

history-preserve-point (Off)

Si se establece a On, el código de historial intenta colocar un punto en la misma ubicación en cada línea del histórico recuperada con previous-history o next-history.

history-size (unset)

Establece el número máximo de entradas guardadas en la lista del historial. Si se establece a cero, se eliminan todas las entradas del historial existentes y no se guardan entradas nuevas. Si se establece en un valor menor que cero, el número de entradas del historial no está limitado. De forma predeterminada, el número de entradas del historial se establece en el valor de la variable de shell HISTSIZE. Si se intenta establecer tamaño del historial en un valor no numérico, el número máximo de entradas del historial se establecerá en 500.

horizontal-scroll-mode (Off)

When set to On, makes readline use a single line for display, scrolling the input horizontally on a single screen line when it becomes longer than the screen width rather than wrapping to a new line. This setting is automatically enabled for terminals of height 1.

input-meta (Off)

Si se pone a On, readline habilitará la entrada de 8 bits (esto es, no pondrá a cero el octavo bit de los caracteres que lea), sin importar lo que la terminal diga que admite. El nombre meta-flag es un sinónimo para esta variable. Por defecto, su valor es off aunque readline lo pondrá a On si la localización contiene caracteres de 8 bits. Esta variable depende de LC_TYPE pudiendo variar según la localización empleada.

isearch-terminators (“C-[C-J”)

La cadena de caracteres que debe finalizar una búsqueda incremental sin ejecutar posteriormente el carácter como una orden. Si a esta variable no se le ha dado un valor, los caracteres ESC e C-J finalizarán una búsqueda incremental.

keymap (emacs)

Establece el mapa de teclado actual para readline. El conjunto de nombres de mapas de teclado válidos es emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command, y vi-insert. vi es equivalente a vi-command; emacs es equivalente a emacs-standard. El valor predeterminado es emacs; el valor de editing-mode también afecta al mapa de teclado predeterminado.

keyseq-timeout (500)

Specifies the duration readline will wait for a character when reading an ambiguous key sequence (one that can form a complete key sequence using the input read so far, or can take additional input to complete a longer key sequence). If no input is received within the timeout, readline will use the shorter but complete key sequence. The value is specified in milliseconds, so a value of 1000 means that readline will wait one second for additional input. If this variable is set to a value less than or equal to zero, or to a non-numeric value, readline will wait until another key is pressed to decide which key sequence to complete.

mark-directories (On)

Si se pone a On, los nombres de directorios completados tendrán una barra inclinada añadida al final.

mark-modified-lines (Off)

Si se pone a On, las líneas de historia que hayan sido modificadas se muestran con un asterisco precediéndolas (*).

mark-symlinked-directories (Off)

If set to On, completed names which are symbolic links to directories have a slash appended (subject to the value of mark-directories).

match-hidden-files (On)

This variable, when set to On, causes readline to match files whose names begin with a `.' (hidden files) when performing filename completion. If set to Off, the leading `.' must be supplied by the user in the filename to be completed.

menu-complete-display-prefix (Off)

If set to On, menu completion displays the common prefix of the list of possible completions (which may be empty) before cycling through the list.

output-meta (Off)

If set to On, readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is Off, but readline will set it to On if the locale contains eight-bit characters. This variable is dependent on the LC_CTYPE locale category, and may change if the locale is changed.

page-completions (On)

Si está a On, readline emplea un paginador interno, similar a more, para mostrar en la pantalla todas las posibilidades autocompletado al mismo tiempo.

print-completions-horizontally (Off)

Si se pone a On, readline mostrará terminaciones con concordancias clasificadas horizontalmente en orden alfabético, en vez de verticalmente.

revert-all-at-newline (Off)

If set to On, readline will undo all changes to history lines before returning when accept-line is executed. By default, history lines may be modified and retain individual undo lists across calls to readline.

show-all-if-ambiguous (Off)

Esto altera el comportamiento predeterminado de las funciones de terminación. Si se pone a On, las palabras que tienen más de una posible terminación hacen que las concordancias se muestren inmediatamente en vez de tocarse el pito de la terminal.

show-all-if-unmodified (Off)

This alters the default behavior of the completion functions in a fashion similar to show-all-if-ambiguous. If set to On, words which have more than one possible completion without any possible partial completion (the possible completions don't share a common prefix) cause the matches to be listed immediately instead of ringing the bell.

show-mode-in-prompt (Off)

If set to On, add a string to the beginning of the prompt indicating the editing mode: emacs, vi command, or vi insertion. The mode strings are user-settable (e.g., emacs-mode-string).

skip-completed-text (Off)

If set to On, this alters the default completion behavior when inserting a single match into the line. It's only active when performing completion in the middle of a word. If enabled, readline does not insert characters from the completion that match characters after point in the word being completed, so portions of the word following the cursor are not duplicated.

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

If the show-mode-in-prompt variable is enabled, this string is displayed immediately before the last line of the primary prompt when vi editing mode is active and in command mode. The value is expanded like a key binding, so the standard set of meta- and control prefixes and backslash escape sequences is available. Use the \1 and \2 escapes to begin and end sequences of non-printing characters, which can be used to embed a terminal control sequence into the mode string.

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

If the show-mode-in-prompt variable is enabled, this string is displayed immediately before the last line of the primary prompt when vi editing mode is active and in insertion mode. The value is expanded like a key binding, so the standard set of meta- and control prefixes and backslash escape sequences is available. Use the \1 and \2 escapes to begin and end sequences of non-printing characters, which can be used to embed a terminal control sequence into the mode string.

visible-stats (Off)

Si se pone a On, se añade un carácter que represente un tipo de fichero según lo que devuelve stat(2) cuando se listan las terminaciones posibles.

Construcciones Condicionales de Readline¶

Readline implementa una facilidad similar en espíritu a las características de compilación condicional del preprocesador de C que permite que las definiciones de teclas y variables se realicen en función de pruebas o condiciones. Hay cuatro directivas del analizador que se usan.

$if

The $if construct allows bindings to be made based on the editing mode, the terminal being used, or the application using readline. The text of the test, after any comparison operator,
extends to the end of the line; unless otherwise noted, no characters are required to isolate it.

$if Bash
# Entrecomilla la palabra actual o previa
"\C-xq": "\eb\"\ef\""
$endif

$endif

Esta orden, como se ha visto en el ejemplo precedente, termina una orden $if.

$else

Las órdenes en esta rama de la directiva $if se ejecutan si la comprobación falla.

$include

Esta directiva toma como argumento un solo nombre de fichero y lee órdenes y definiciones de ese fichero. Por ejemplo, la siguiente directiva leería de /etc/inputrc:

$include  /etc/inputrc

Búsquedas¶

Readline proporciona órdenes para buscar a través del historial de órdenes (vea HISTORIAL más adelante) líneas que contengan una cadena especificada. Hay dos modos de búsqueda: incremental y no incremental.

La búsqueda incremental comienza antes de que el usuario haya acabado de teclear la cadena a buscar. Tan pronto como se teclea cada carácter de la cadena de búsqueda, readline muestra la siguiente entrada de la historia que concuerde con la cadena que se esté tecleando hasta este punto. Una búsqueda incremental requiere solamente tantos caracteres como se necesiten para encontrar la entrada deseada en el historial. Los caracteres contenidos en la variable isearch-terminators se emplean para terminar una búsqueda incremental. Control-G terminará una búsqueda incremental reataurando la línea original. Una vez que la búsqueda termine, la línea del historial que contenga la cadena de búsqueda pasa a ser la línea actual.

To find other matching entries in the history list, type Control-S or Control-R as appropriate. This will search backward or forward in the history for the next entry matching the search string typed so far. Any other key sequence bound to a readline command will terminate the search and execute that command. For instance, a newline will terminate the search and accept the line, thereby executing the command from the history list.

Readline remembers the last incremental search string. If two Control-Rs are typed without any intervening characters defining a new search string, any remembered search string is used.

Las búsquedas no incrementales leen la cadena de búsqueda entera antes de empezar a buscar en las líneas de la lista de historia. La cadena de búsqueda puede ser tecleada por el usuario o ser parte de los contenidos de la línea en curso.

Nombres de Órdenes de Readline¶

Lo siguiente es una lista de los nombres de las órdenes y las secuencias de teclas predeterminadas a las que están asociadas. Los nombres de órdenes sin una secuencia de tecla acompañante pertenecen a órdenes que no están asociadas a ninguna secuencia de teclas de forma predeterminada. En las siguientes descripciones, punto se refiere a la posición actual del cursor y marca se refiere a una posición guardada mediante la orden set-mark. El texto en dicho punto y la marca es lo que se conoce como region.

Órdenes para el Movimiento¶

beginning-of-line (C-a)

Mover al principio de la línea en curso.

end-of-line (C-e)

Mover al final de la línea.

forward-char (C-f)

Mover un carácter hacia adelante.

backward-char (C-b)

Mover un carácter hacia atrás.

forward-word (M-f)

Mover adelante hasta el final de la siguiente palabra. Las palabras se componen de caracteres alfanuméricos (letras y dígitos).

backward-word (M-b)

Mover atrás hasta el principio de esta palabra o la anterior. Las palabras se componen de caracteres alfanuméricos (letras y dígitos).

shell-forward-word

Mover adelante hasta el final de la siguiente palabra. Las palabras están delmitadas por metacaracteres de la shell no entrecomillados.

shell-backward-word

Mover atrás hasta el principio de esta palabra o la anterior. Las palabras se delimitan por metacaracteres de la shell no entrecomillados.

previous-screen-line

Attempt to move point to the same physical screen column on the previous physical screen line. This will not have the desired effect if the current readline line does not take up more than one physical line or if point is not greater than the length of the prompt plus the screen width.

next-screen-line

Attempt to move point to the same physical screen column on the next physical screen line. This will not have the desired effect if the current readline line does not take up more than one physical line or if the length of the current readline line is not greater than the length of the prompt plus the screen width.

clear-display (M-C-l)

Clear the screen and, if possible, the terminal's scrollback buffer, then redraw the current line, leaving the current line at the top of the screen.

clear-screen (C-l)

Despejar la pantalla y volver a crear la línea actual dejándola en la parte superior de la pantalla. Si se proporciona un argumento, refresca la línea actual sin despejar la pantalla.

redraw-current-line

Refrescar la línea en curso.

Órdenes para Manipular el Historial¶

accept-line (Nueva-línea, Intro)

Aceptar la línea sin importar dónde esté el cursor. Si esta línea no está vacía, añadirla al historial de acuerdo con el estado de la variable HISTCONTROL. Si la línea es una de las de la historia, modificada, entonces restaurar el historial a su estado original.

previous-history (C-p)

Obtener la orden anterior del historial, moviéndose hacia atrás en la misma.

next-history (C-n)

Obtener la orden siguiente del historial, moviéndose hacia delante en el mismo.

beginning-of-history (M-<)

Mover a la primera línea del historial.

end-of-history (M->)

Mover al final de la historia de entrada; esto es, la línea que está siendo introducida en la actualidad.

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

Aceptar la línea en curso para la ejecución y obtener la línea siguiente relativa a la actual desde el historial, para la edición. Si se añade un argumento numérico define la línea del historial a emplear en lugar de usar al actual.

fetch-history

Con un argumento numérico, toma dicha entrada del histórico y la copia en la línea actual. Si no se da ningún argumento, se desplaza a la primera entrada del mismo.

reverse-search-history (C-r)

Buscar hacia atrás empezando en la línea en curso y moviéndose `arriba' a través del historial si es necesario. Esta búsqueda es incremental.

forward-search-history (C-s)

Buscar hacia adelante empezando en la línea en curso y moviéndose `abajo' a través del historial si es necesario. Esta búsqueda es incremental.

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

Buscar hacia atrás a través del historial empezando en la línea en curso empleando una búsqueda no incremental de una cadena suministrada por el usuario.

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

Buscar hacia delante a través del historial empezando en la línea en curso empleando una búsqueda no incremental de una cadena suministrada por el usuario.

history-search-forward

Buscar hacia adelante a través del historial una cadena de caracteres entre el comienzo de la línea en curso y el punto. Esta búsqueda no es incremental.

history-search-backward

Buscar hacia atrás a través del historial una cadena de caracteres entre el comienzo de la línea en curso y el punto. Esta búsqueda no es incremental.

history-substring-search-backward

Buscar hacia atrás a través del historial una cadena de caracteres entre el comienzo de la línea en curso y el punto. Esta búsqueda no es incremental.

history-substring-search-forward

Buscar hacia delante a través del historial una cadena de caracteres entre el comienzo de la línea en curso y el punto. Esta búsqueda no es incremental.

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

Insertar el primer argumento de la orden anterior (normalmente la segunda palabra de la línea anterior) en el punto. Con un argumento n, insertar la n-sima palabra de la orden anterior (las palabras en la orden anterior empiezan con la palabra 0). Un argumento negativo inserta la n-sima palabra desde el final de la orden anterior.Una vez que se computa el argumento n, se extraerá como si se definiese esta exapnsión del historial: "!n"

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

Inserta el último argumento de la orden anterior (la última palabra de la anterior entrada del historial). Con un argumento numérico, se comporta de igual modo a yank-nth-arg. Invocando varias veces yank-last-arg, se desplazará hacia atrás en el historial insertando la última palabra (o aquella definida en el argumento de la primera invocación) de cada línea por la que se desplace. Cualquier aargumento numérico que se proporcione en las sucesivas invocaciones determina la dirección de desplazamiento en el historial. Un argumento negativo cambiará dicha dirección hacia delante o hacia atrás. Las utilidades de expansión del historial se usan para extraer la última palabra como si se especificase "!$".

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

Expandir la línea como hace la shell. Esto realiza la expansión de alias y de historia así como todas las expansiones de palabra de la shell. Consulte EXPANSIÓN DEL HISTORIAL más adelante para una descripción de la expansión de historia.

history-expand-line (M-^)

Realizar la expansión de historia en la línea en curso. Vea EXPANSIÓN DEL HISTORIAL más adelante para una descripción de la expansión de historia.

magic-space

Efectuar la expansión de historia en la línea en curso e insertar un espacio. Vea EXPANSIÓN DEL HISTORIAL más adelante para una descripción de la expansión de historia.

alias-expand-line

Realizar la expansión de alias en la línea en curso. Vea ALIAS arriba para una descripción de la expansión de alias.

history-and-alias-expand-line

Realizar la expansión de historia y alias en la línea en curso.

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

Un sinónimo para yank-last-arg.

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

Invoca un editor en la línea de órdenes actual ejecutándose el resultado como órdenes de la shell. bash intenta invocas $VISUAL, $EDITOR y emacs en ese orden.

Órdenes para Cambiar el Texto¶

end-of-file (generalmente C-d)

El carácter que determina el fin-de-archivo se define por ejemplo mediante ``stty''. Si se lee el carácter cuando no hay ninguno en la línea y el punto está al principio de la línea, Readline lo interpreta como el fin de la entrada y devuelve EOF.

delete-char (C-d)

Eliminar el carácter en el punto. Si esta función está asociada con el mismo carácter que que tenga el tty para EOF, como suele serlo C-d, vea anteriormente los efectos.

backward-delete-char (Borrar)

Borrar el carácter tras el cursor. Cuando se da un argumento numérico, guardar el texto borrado en el anillo de corte.

forward-backward-delete-char

Borrar el carácter bajo el cursor, salvo que el cursor esté al final de la línea, en cuyo caso se borrará el carácter que esté detrás.

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

Añadir el siguiente carácter tecleado a la línea tal cual. Así es como se pueden insertar caracteres como C-q, por ejemplo.

tab-insert (C-v TAB)

Insertar un carácter de tabulación.

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

Insertar el carácter tecleado.

transpose-chars (C-t)

Arrastrar el carácter antes del punto hacia adelante sobre el carácter en el punto. El punto se mueve adelante también. Si el punto está al final de la línea, entonces transpone los dos caracteres antes del punto. Los argumentos negativos no tienen efecto.

transpose-words (M-t)

Arrastrar la palabra antes del punto hacia adelante sobre el carácter en el punto. El punto se mueve adelante también. Si el punto está al final de la línea, se transponen los dos últimas palabras de dicha línea.

upcase-word (M-u)

Poner en mayúsculas la palabra en curso (o la siguiente). Con un argumento negativo, pone la anterior, pero no mueve el punto.

downcase-word (M-l)

Poner en minúsculas la palabra en curso (o la siguiente). Con un argumento negativo, pone la anterior, pero no mueve el punto.

capitalize-word (M-c)

Poner en mayúscula la inicial de la palabra en curso (o la siguiente). Con un argumento negativo, pone la anterior, pero no mueve el punto.

overwrite-mode

Toggle overwrite mode. With an explicit positive numeric argument, switches to overwrite mode. With an explicit non-positive numeric argument, switches to insert mode. This command affects only emacs mode; vi mode does overwrite differently. Each call to readline() starts in insert mode. In overwrite mode, characters bound to self-insert replace the text at point rather than pushing the text to the right. Characters bound to backward-delete-char replace the character before point with a space. By default, this command is unbound.

Cortar y Pegar¶

kill-line (C-k)

Cortar el texto desde la posición actual del cursor hasta el final de la línea.

backward-kill-line (C-x Borrar)

Cortar hacia atrás hasta el principio de la línea.

unix-line-discard (C-u)

Cortar hacia atrás desde el punto hasta el principio de la línea. El texto cortado se guarda en el anillo de corte.

kill-whole-line

Cortar todos los caracteres de la línea en curso, sin importar dónde esté el punto.

kill-word (M-d)

Cortar desde el punto hasta el final de la palabra en curso, o si entre palabras, hasta el final de la siguiente. Los extremos de las palabras son los mismos que los empleados por forward-word.

backward-kill-word (M-supr)

Cortar la palabra tras el punto. Los extremos de las palabras son los mismos que los empleados por backward-word.

shell-kill-word

Cortar desde el punto hasta el final de la palabra en curso, o si entre palabras, hasta el final de la siguiente. Los extremos de las palabras son los mismos que los empleados por shell-forward-word.

shell-backward-kill-word

Cortar la palabra tras el punto. Los extremos de las palabras son los mismos que los empleados por shell-backward-word.

unix-word-rubout (C-w)

Cortar la palabra tras el punto, empleando el espacio en blanco como un límite de palabra. El texto cortado se guarda en el anillo de corte.

unix-filename-rubout

Cortar la palabra detrás del punto empleando el espacio en blanco y la barra como límites de la palabra. El texto cortado se guarda en el anillo de corte.

delete-horizontal-space (M-\)

Borrar todos los espacios y tabuladores alrededor del punto.

kill-region

Cortar el texto en la región actual.

copy-region-as-kill

Copiar el texto de la región al anillo de corte.

copy-backward-word

Copiar la palabra antes del punto al búfer de corte. Los extremos de palabras son los mismos que con backward-word.

copy-forward-word

Copiar la palabra que sigue al punto al búfer de corte. Los extremos de palabra son los mismos que con forward-word.

yank (C-y)

Pegar la cima del anillo de corte en el búfer en el punto.

yank-pop (M-y)

Rotar en el anillo de corte, y pegar la nueva cima. Solo funciona tras un yank o yank-pop.

Argumentos Numéricos¶

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

Añadir este dígito al argumento, acumulándolo, o comenzar con un nuevo argumento. M-- empieza un argumento negativo.

universal-argument

Ésta es otra forma de especificar un argumento. Si esta orden se hace seguir de uno o más dígitos, opcionalmente con un signo menos inicial, estos dígitos definen el argumento. Si a la orden siguen dígitos, ejecutar de nuevo universal-argument finaliza el argumento numérico, pero si no, no se tiene en cuenta. Como un caso especial, si a esta orden sigue inmediatamente un carácter que no es ni un dígito ni un signo menos, el número del argumento para la siguiente orden se multiplica por cuatro. El número del argumento es inicialmente uno, así que ejecutar esta función por primera vez hace que el número del argumento sea cuatro, una segunda vez lo hace dieciséis, y así sucesivamente.

Terminación¶

complete (TAB)

Intentar realizar una terminación del texto antes del punto. Bash intenta la terminación tratando al texto como una variable (si el texto comienza con $), como un nombre de usuario (si el texto empieza con ~), como un nombre de equipo anfitrión (si el texto comienza con @), o como una orden (incluyendo alias y funciones), por este orden. Si nada de esto concuerda, se intenta la terminación de un nombre de fichero.

possible-completions (M-?)

Listar las terminaciones posibles del texto antes del punto.

insert-completions (M-*)

Insertar todas las terminaciones del texto antes del punto que habrían sido generadas por possible-completions.

menu-complete

Similar to complete, but replaces the word to be completed with a single match from the list of possible completions. Repeated execution of menu-complete steps through the list of possible completions, inserting each match in turn. At the end of the list of completions, the bell is rung (subject to the setting of bell-style) and the original text is restored. An argument of n moves n positions forward in the list of matches; a negative argument may be used to move backward through the list. This command is intended to be bound to TAB, but is unbound by default.

menu-complete-backward

Identical to menu-complete, but moves backward through the list of possible completions, as if menu-complete had been given a negative argument. This command is unbound by default.

delete-char-or-list

Deletes the character under the cursor if not at the beginning or end of the line (like delete-char). If at the end of the line, behaves identically to possible-completions. This command is unbound by default.

complete-filename (M-/)

Intentar la terminación de un nombre de fichero en el texto antes del punto.

possible-filename-completions (C-x /)

Listar las posibles terminaciones del texto antes del punto, tratándolo como un nombre de fichero.

complete-username (M-~)

Intentar la terminación del texto antes del punto, tratándolo como un nombre de usuario.

possible-username-completions (C-x ~)

Listar las posibles terminaciones del texto antes del punto, tratándolo como un nombre de usuario.

complete-variable (M-$)

Intentar la terminación del texto antes del punto, tratándolo como una variable de la shell.

possible-variable-completions (C-x $)

Listar las posibles terminaciones del texto antes del punto, tratándolo como una variable de la shell.

complete-hostname (M-@)

Intentar la terminación del texto antes del punto, tratándolo como un nombre de equipo anfitrión.

possible-hostname-completions (C-x @)

Listar las posibles terminaciones del texto antes del punto, tratándolo como un nombre de equipo anfitrión.

complete-command (M-!)

Intentar la terminación del texto antes del punto, tratándolo como un nombre de orden. La terminación de orden intenta hacer concordar el texto con alias, palabras reservadas, funciones de la shell, órdenes internas de la shell, y finalmente nombres de ficheros ejecutables, en ese orden.

possible-command-completions (C-x !)

Listar las posibles terminaciones del texto antes del punto, tratándolo como un nombre de orden.

dynamic-complete-history (M-TAB)

Intentar la terminación del texto antes del punto, comparando el texto con líneas del historial buscando concordancias para la terminación.

dabbrev-expand

Intentar completar el menu en el texto antes del punto, comparando el texto con líneas del historial buscando concordancias para la terminación.

complete-into-braces (M-{)

Efectuar la terminación de nombres de archivos e insertar la lista de terminaciones posibles encerrada entre llaves de forma que la lista esté disponible para la shell (vea Expansión de llaves arriba).

Macros de Teclado¶

start-kbd-macro (C-x ()

Empezar a grabar los caracteres tecleados, en la macro de teclado en curso.

end-kbd-macro (C-x ))

Parar de grabar los caracteres tecleados en la macro de teclado en curso, y almacenar la definición.

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

Reejecutar la última macro de teclado definida, haciendo que los caracteres en la macro aparezcan como si se hubieran pulsado en el teclado.

print-last-kbd-macro ()

Muestra la última macro de teclado definida en un formato adecuado para su uso en el archivo inputrc.

Varios¶

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

Leer los contenidos del archivo inputrc, e incorporar cualquier definición de teclas o asignaciones de variables que se hubieran encontrado en él.

abort (C-g)

Terminar abruptamente la orden de edición en curso y tocar el pito de la terminal (según el establecimiento de bell-style).

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

If the metafied character x is uppercase, run the command that is bound to the corresponding metafied lowercase character. The behavior is undefined if x is already lowercase.

prefix-meta (ESC)

Convertir en meta el siguiente carácter tecleado. ESC f es equivalente a Meta-f.

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

Deshacer de forma incremental, recordado separadamente para cada línea.

revert-line (M-r)

Deshacer todos los cambios hechos a esta línea. Esto es como ejecutar la orden undo las veces suficientes como para devolver la línea a su estado inicial.

tilde-expand (M-&)

Efectuar la expansión de tilde en la palabra en curso.

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

Establecer la marca en el punto. Si se da un argumento numérico, la marca se establece en esa posición.

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

Cambia el punto con la marca. La posición actual del cursor se pone en la posición guardada, y la vieja posición del cursor se guarda como la marca.

character-search (C-])

Se lee un carácter y el punto se mueve a la siguiente ocurrencia de ese carácter. Un argumento numérico negativo hace que la búsqueda sea de las ocurrencias anteriores.

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

Se lee un carácter y el punto se mueve a la anterior ocurrencia de ese carácter. Un numérico negativo hace que la búsqueda sea de las ocurrencias siguientes.

skip-csi-sequence

Read enough characters to consume a multi-key sequence such as those defined for keys like Home and End. Such sequences begin with a Control Sequence Indicator (CSI), usually ESC-[. If this sequence is bound to "\[", keys producing such sequences will have no effect unless explicitly bound to a readline command, instead of inserting stray characters into the editing buffer. This is unbound by default, but usually bound to ESC-[.

insert-comment (M-#)

Without a numeric argument, the value of the readline comment-begin variable is inserted at the beginning of the current line. If a numeric argument is supplied, this command acts as a toggle: if the characters at the beginning of the line do not match the value of comment-begin, the value is inserted, otherwise the characters in comment-begin are deleted from the beginning of the line. In either case, the line is accepted as if a newline had been typed. The default value of comment-begin causes this command to make the current line a shell comment. If a numeric argument causes the comment character to be removed, the line will be executed by the shell.

spell-correct-word (C-x s)

Ejecuta una corrección ortográfica sobre la palabra actual, considerándola un nombre de directorio o de archivo, igual que mediante la opción cdspell.Los extremos de las palabras son los mismos que los empleados por shell-forward-word.

glob-complete-word (M-g)

La palabra antes del punto se trata como un patrón para la expansión de nombres de ruta con un asterisco implícitamente añadido. Este patrón se emplea para generar una lista de posibles nombres de archivo para autocompletar.

glob-expand-word (C-x *)

La palabra antes del punto se trata como un patrón para la expansión de nombres de rutas y la lista de nombres de archivo concordantes se inserta, reemplazando a la palabra. Si se proporciona un argumento numérico, se añade un asterisco antes de la expansión del nombre de ruta.

glob-list-expansions (C-x g)

Mostrar la lista de expansiones que habrían sido generadas por glob-expand-word y redibujar la línea. Si se aporta un argumento numérico, se añade un asterisco antes de la expansión del nombre de ruta

dump-functions

Mostrar todas las funciones y sus asociaciones de teclas en el flujo de salida de readline. Si se da un argumento numérico, la salida se formatea de tal modo que pueda formar parte de un fichero inputrc.

dump-variables

Mostrar todas las variables de readline a las que se puedan asignar valores, y éstos, en el flujo de salida de readline. Si se da un argumento numérico, la salida se formatea de tal manera que pueda formar parte de un fichero inputrc.

dump-macros

Mostrar todas las secuencias de teclas de readline asociadas a macros y las cadenas de caracteres asociadas correspondientes. Si se da un argumento numérico, la salida se formatea de tal manera que pueda formar parte de un fichero inputrc.

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

Mostrar información de versión acerca de la instancia actual de bash.

Autocompletado Programable¶

When word completion is attempted for an argument to a command for which a completion specification (a compspec) has been defined using the complete builtin (see SHELL BUILTIN COMMANDS below), the programmable completion facilities are invoked.

First, the command name is identified. If the command word is the empty string (completion attempted at the beginning of an empty line), any compspec defined with the -E option to complete is used. If a compspec has been defined for that command, the compspec is used to generate the list of possible completions for the word. If the command word is a full pathname, a compspec for the full pathname is searched for first. If no compspec is found for the full pathname, an attempt is made to find a compspec for the portion following the final slash. If those searches do not result in a compspec, any compspec defined with the -D option to complete is used as the default. If there is no default compspec, bash attempts alias expansion on the command word as a final resort, and attempts to find a compspec for the command word from any successful expansion.

Once a compspec has been found, it is used to generate the list of matching words. If a compspec is not found, the default bash completion as described above under Completing is performed.

First, the actions specified by the compspec are used. Only matches which are prefixed by the word being completed are returned. When the -f or -d option is used for filename or directory name completion, the shell variable FIGNORE is used to filter the matches.

Any completions specified by a pathname expansion pattern to the -G option are generated next. The words generated by the pattern need not match the word being completed. The GLOBIGNORE shell variable is not used to filter the matches, but the FIGNORE variable is used.

Next, the string specified as the argument to the -W option is considered. The string is first split using the characters in the IFS special variable as delimiters. Shell quoting is honored. Each word is then expanded using brace expansion, tilde expansion, parameter and variable expansion, command substitution, and arithmetic expansion, as described above under EXPANSION. The results are split using the rules described above under Word Splitting. The results of the expansion are prefix-matched against the word being completed, and the matching words become the possible completions.

After these matches have been generated, any shell function or command specified with the -F and -C options is invoked. When the command or function is invoked, the COMP_LINE, COMP_POINT, COMP_KEY, and COMP_TYPE variables are assigned values as described above under Shell Variables. If a shell function is being invoked, the COMP_WORDS and COMP_CWORD variables are also set. When the function or command is invoked, the first argument ($1) is the name of the command whose arguments are being completed, the second argument ($2) is the word being completed, and the third argument ($3) is the word preceding the word being completed on the current command line. No filtering of the generated completions against the word being completed is performed; the function or command has complete freedom in generating the matches.

Any function specified with -F is invoked first. The function may use any of the shell facilities, including the compgen builtin described below, to generate the matches. It must put the possible completions in the COMPREPLY array variable, one per array element.

Next, any command specified with the -C option is invoked in an environment equivalent to command substitution. It should print a list of completions, one per line, to the standard output. Backslash may be used to escape a newline, if necessary.

After all of the possible completions are generated, any filter specified with the -X option is applied to the list. The filter is a pattern as used for pathname expansion; a & in the pattern is replaced with the text of the word being completed. A literal & may be escaped with a backslash; the backslash is removed before attempting a match. Any completion that matches the pattern will be removed from the list. A leading ! negates the pattern; in this case any completion not matching the pattern will be removed. If the nocasematch shell option is enabled, the match is performed without regard to the case of alphabetic characters.

Finally, any prefix and suffix specified with the -P and -S options are added to each member of the completion list, and the result is returned to the readline completion code as the list of possible completions.

If the previously-applied actions do not generate any matches, and the -o dirnames option was supplied to complete when the compspec was defined, directory name completion is attempted.

If the -o plusdirs option was supplied to complete when the compspec was defined, directory name completion is attempted and any matches are added to the results of the other actions.

By default, if a compspec is found, whatever it generates is returned to the completion code as the full set of possible completions. The default bash completions are not attempted, and the readline default of filename completion is disabled. If the -o bashdefault option was supplied to complete when the compspec was defined, the bash default completions are attempted if the compspec generates no matches. If the -o default option was supplied to complete when the compspec was defined, readline's default completion will be performed if the compspec (and, if attempted, the default bash completions) generate no matches.

When a compspec indicates that directory name completion is desired, the programmable completion functions force readline to append a slash to completed names which are symbolic links to directories, subject to the value of the mark-directories readline variable, regardless of the setting of the mark-symlinked-directories readline variable.

There is some support for dynamically modifying completions. This is most useful when used in combination with a default completion specified with complete -D. It's possible for shell functions executed as completion handlers to indicate that completion should be retried by returning an exit status of 124. If a shell function returns 124, and changes the compspec associated with the command on which completion is being attempted (supplied as the first argument when the function is executed), programmable completion restarts from the beginning, with an attempt to find a new compspec for that command. This allows a set of completions to be built dynamically as completion is attempted, rather than being loaded all at once.

For instance, assuming that there is a library of compspecs, each kept in a file corresponding to the name of the command, the following default completion function would load completions dynamically:

_completion_loader()
{
. "/etc/bash_completion.d/$1.sh" >/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader -o bashdefault -o default

Designadores de Eventos¶

Un designador de evento es una referencia a una entrada de línea de orden en el historial. Salvo que la referencia sea absoluta, la posición de los eventos será relativa a la posición actual en el historial.

!

Comenzar una sustitución de historia, excepto cuando le siga un blanco, salto de línea, retorno de carro, = o (. (cuando la opción extglob está activada mediante shopt).

!n

Referirse a la línea de órdenes número n.

!-n

Referirse a la orden en curso menos n.

!!

Referirse a la orden anterior. Esto es lo mismo que `!-1'.

!cadena

Referirse a la orden más reciente del historial que precede a la actual y comienza con cadena.

!?cadena[?]

Referirse a la orden más reciente del historial que precede a la actual y que contenga cadena. El ? del final puede omitirse si a cadena le sigue inmediatamente un salto de línea. Si no se indica ninguna string, se usará la cadena empleada en la última búsqueda, emitiendo un mensaje de error si no hay ninguna cadena de búsquedas anteriores.

^cadena1^cadena2^

Sustitución rápida. Repetir la orden anterior, reemplazando cadena1 con cadena2. Equivale a “!!:s^cadena1^cadena2^” (vea Modificadores a continuación).

!#

La línea de orden entera tecleada hasta ahora.

Designadores de Palabras¶

Los designadores de palabras se emplean para seleccionar las palabras que se deseen del evento. Un : separa la especificación de evento del designador de palabra. Puede omitirse si el designador de palabra comienza con un ^, $, *, -, o %. Las palabras se numeran desde el principio de la línea, con la primera palabra denotada por 0 (cero). Las palabras se insertan en la línea en curso separadas por espacios simples.

0 (cero)

La palabra número 0. Para la shell, ésta es la palabra de la orden.

n

La n-sima palabra.

^

El primer argumento. Esto es, la palabra número 1.

$

The last word. This is usually the last argument, but will expand to the zeroth word if there is only one word in the line.

%

La palabra que concuerda con la búsqueda más reciente de '?cadena?', si dicha cadena comienza con un carácter que forma parte de una palabra.

x-y

Un intervalo de palabras; `-y' abrevia `0-y'.

*

Todas las palabras menos la número cero. Esto es un sinónimo de `1-$'. No es un error emplear * si solo hay una palabra en el evento; en este caso se devuelve la cadena vacía.

x*

Abreviatura de x-$.

x-

Abrevia x-$ como x*, pero omite la última palabra. Si no se indica x, se usará el valor 0 por defecto.

Si se suministra un designador de palabra sin una especificación de evento, se usa la orden anterior como el evento.

Modificadores¶

Tras el designador opcional de palabra, puede haber una secuencia de uno o más de los siguientes modificadores, precedido cada uno por un ':'. Esto modifica o edita la/s palabra/s seleccionadas del evento del historial.

h

Quitar un componente final de nombre de fichero, dejando solo la parte izquierda.

t

Quitar todos los primeros componentes de un nombre de fichero, dejando la última parte.

r

Quitar un sufijo final de la forma .xxx, dejando el nombre base.

e

Quitar todo salvo el sufijo final.

p

Mostrar la nueva orden pero no ejecutarla.

q

Entrecomillar las palabras sustituidas, escapando de posteriores sustituciones.

x

Entrecomillar las palabras sustituidas como con q, pero separae entre palabras en los blancos y saltos de línea. Los modificadores q y x son mutuamente excluyentes, usándose el que aparezca de último.

s/viejo/nuevo/

Sustituir nuevo por la primera ocurrencia de viejo en la línea de evento. Se puede emplear cualquier delimitador en vez de /. El delimitador final es opcional si es el último carácter de la línea de evento. El delimitador puede entrecomillarse en viejo y nuevo con una sola barra inclinada inversa. Si & aparece en nuevo, se reemplaza por viejo. Una sola barra inversa protegerá el &. Si viejo está vacío, se pone al último viejo sustituido, o, si no tuvo lugar ninguna sustitución de historia previa, a la última cadena en una búsqueda del tipo !?cadena[?].. Si no se indica nuevo se borrarán todas las ocurrencias de viejo.

&

Repetir la sustitución anterior.

g

Hace que los cambios se apliquen sobre la línea entera de evento. Esto se emplea en conjunción con `:s' (p.ej., `:gs/viejo/nuevo/') o `:&'. Si se usa con `:s', cualquier delimitador se puede utilizar en lugar de /, y el delimitador final es opcional si es el último carácter de la línea de evento. Puede usarse a como sinónimo de g.

G

Aplica los modificadores 's' o '&' una vez a cada palabra en la correspondiente línea del evento.