Funcionalidades de Bash

Este texto es una descripción breve de las funcionalidades presentes en el intérprete de órdenes Bash (versión 5.0, 7 de diciembre de 2018). El sitio web la Bash es http://www.gnu.org/software/bash/.

Esta es la Edición 5.0, actualizada por última vez 7 de diciembre de 2018, de Manual de Referencia de Bash, para Bash, Version 5.0.

Bash contiene funcionalidades que aparecen en otros intérpretes de instrucciones populares, y algunas funcionalidades que solo aparecen en Bash. Algunos de los intérpretes de los que Bash ha tomado conceptos son el Bourne Shell (‘sh’), el Korn Shell (‘ksh’) y el C-shell (‘csh’ y su sucesor, ‘tcsh’). El siguiente menú divide las funcionalidades en categorías, mencionando qué funcionalidades fueron inspiradas por otros intérpretes y cuáles son propias de Bash.

Este manual está pensado como una breve introducción a las funcionalidades que se encuentran en Bash. La página de manual de Bash debería usarse como la referencia definitiva sobre el compartamiento del intérprete de órdenes.

1. Introducción

1.1 ¿Qué es Bash?

Bash es el intérprete, o el lenguaje intérprete de órdenes, para el sistema operativo GNU. El nombre es un acrónimo de ‘Bourne-Again SHell’, un juego de palabras con Stephen Bourne, el autor del ancestro directo del actual intérprete sh, que apareció en la versión Seventh Edition Bell Labs Research de Unix.

Bash es en gran parte compatible con sh e incorpora funcionalidades útiles del intérprete Korn ksh y el intérprete C csh. Esta concebido para ser una implementación que se ajusta a la parte IEEE POSIX Shell and Tools de la especificación IEEE POSIX (IEEE Standard 1003.1). Ofrece mejoras funcionales sobre sh tanto para uso interactivo como para programar.

Aunque el sistema operativo GNU proporciona otros intérpretes de órdenes, incluyendo una versión de csh, Bash es el intérprete predeterminado. Al igual que otro software de GNU, Bash es bastante portable. Actualmente se ejecuta en casi cualquier versión de Unix y algunos otros sistemas operativos —existen versiones portadas mantenidas de forma independiente para MS-DOS, OS/2 y plataformas Windows—.

1.2 ¿Qué es un intérprete?

Básicamente, un intérprete es simplemente un procesador de macros que ejecuta instrucciones. El término procesador de macros significa funcionalidad donde texto y símbolos son expandidos para crear expresiones más grandes.

Un intérprete de Unix es tanto un intérprete de órdenes como un lenguaje de programación. Como un intérprete de instrucciones, el intérprete proporciona la interfaz de usuario a un variado conjunto de utilidades de GNU. Las funcionalidades del lenguaje de programación permiten que estás utilidades se combinen. Se pueden crear archivos que contienen instrucciones, y convertirse ellos mismos en instrucciones. Estas nuevas órdenes tienen la misma naturaleza que instrucciones del sistema en directorios como ‘/bin’, permitiendo que usuarios o grupos puedan establecer entornos personalizados para automatizar sus tareas comunes.

Los intérpretes pueden ser usados de forma interactiva o de forma no interactiva. En el modo interactivo, aceptan la entrada escrita desde el teclado. Cuando se ejecutan de forma no interactiva, los intérpretes ejecutan instrucciones leídas de un archivo.

Un intérprete permite la ejecución de instrucciones GNU, tanto síncrona como asíncronamente. El intérprete espera a que las instrucciones síncronas se completen antes de aceptar más entradas; las instrucciones asíncronas continúan ejecutándose en paralelo con el intérprete mientras que lee y ejecuta instrucciones adicionales. Las construcciones de redirección permiten un control preciso de la entrada y la salida de esas instrucciones. Asimismo, el intérprete proporciona control sobre los contenidos de los entornos de instrucciones.

Los intérpretes también proporcionan un pequeño conjunto de instrucciones integradas (builtins) que implementan funcionalidad imposible o inconveniente de obtener mediante utilidades separadas. Por ejemplo, cd, break, continue y exec no pueden ser implementados fuera del intérprete porque manipulan directamente el intérprete en sí mismo. Las instrucciones integradas history, getopts, kill o pwd, entre otras, podrían ser implementadas en utilidades separadas, pero son más convenientes de usar como instrucciones integradas. Todas las funciones integradas del intérprete son descritas en las secciones posteriores.

Mientras que la ejecución de instrucciones es esencial, la mayoría del poder (y de la complejidad) de los intérpretes es debido a sus lenguajes de programación integrados. Como cualquier otro lenguaje de alto nivel, el intérprete proporciona variables, estructuras de control de flujo, entrecomillado y funciones.

Los intérpretes ofrecen funcionalidades enfocadas específicamente para uso interactivo en vez de para aumentar el lenguaje de programación. Estas funcionalidades interactivas incluyen control de tareas, edición en línea de órdenes, historial de instrucciones y aliases. En este manual se describe cada una de estas funcionalidades.

2. Definiciones

Estas definiciones son usadas a lo largo de este manual.

POSIX

Una familia de estándares de sistemas abiertos basado en Unix. Bash se atañe principalmente a la porción Shell and Utilities del estándar POSIX 1003.1.

vacío

Un carácter de espacio o tabulación.

instrucción integrada

Una instrucción que está implementada internamente por el propio intérprete, en vez de por un programa ejecutable en algún lugar del archivo de ficheros.

operador de control

Un símbolo que realiza una función de control. Es una nueva línea o uno de los siguientes: ‘||’, ‘&&’, ‘&’, ‘;’, ‘;;’, ‘;&’, ‘;;&’, ‘|’, ‘|&’, ‘(’, o ‘)’.

estado de salida

El valor devuelto por una instrucción a su ejecutor. El valor está restringido a ocho bits, así que el máximo valor es 255.

campo

Una unidad de texto que es el resultado de una de las expansiones del intérprete. Después de la expansión, cuando se ejecuta un comando, los campos resultantes son usados como el nombre de instrucción y los argumentos.

nombre de archivo

Una cadena de caracteres usada para identificar a un archivo.

tarea

Un conjunto de procesos que componen una tubería, y cualquier otro proceso que descienda de ella, que se encuentran todos en el mismo grupo de proceso.

control de tareas

Un mecanismo por el cual los usuarios pueden selectivamente parar (suspender) o reiniciar (reanudar) la ejecución de procesos.

metacarácter

Un carácter que, cuando no está entrecomillado, separa palabras. Un metacarácter es espacio, tabulación, nueva línea o uno de los siguientes caracteres: ‘|’, ‘&’, ‘;’, ‘(’, ‘)’, ‘<’, or ‘>’.

nombre

Una palabra que solo está compuesta de letras, números y barras bajas, y comienza por una letra o barra baja. Los Nombres son usados como nombres de variables y funciones del intérprete. También mencionado como indentificador.

operador

Un operador de control o un operador de redirección. Véase la sección Redirecciones, para una lista de los operadores de redirección. Los operadores contienen al menos un metacarácter sin entrecomillar.

grupo de proceso

Una colección de procesos relacionados que tienen el mismo ID de proceso de grupo.

ID de proceso de grupo

Un identificador único que representa un proceso de grupo durante su tiempo de vida.

palabra reservada

Una palabra que tiene un significado especial para el intérprete. La mayoría de palabras reservadas introducen construcciones de control de flujo, como for y while.

estado de retorno

Un sinónimo de estado de salida.

señal

Un mecanismo por el cual un proceso puede ser notificado por el núcleo de un evento ocurrido en el sistema.

instrucción integrada especial

Una instrucción integrada del intérprete que ha sido clasificada como especial por el estándar POSIX.

símbolo

Una secuencia de caracteres considerada como unidad única por el intérprete. O bien es una palabra o un operador

palabra

Una secuencia de caracteres tratada como una unidad por el intérprete. Las palabras no pueden incluir metacaracteres sin entrecomillar.

3. Funcionalidades Básicas del Intérprete

Bash es un acrónimo para ‘Bourne-Again SHell’. El Bourne shell es el intérprete tradicional de Unix escrito originalmente por Stephen Bourne. Todas las instrucciones integradas del Bourne shell están disponibles en Bash. Las reglas para evaluación y entrecomillado se toman de la especificación POSIX para el intérprete Unix ‘estándar’.

Este capítulo resume brevemente los ‘bloques constructores’ del intérprete: instrucciones, estructuras de control, funciones del intérprete, parámetros del intérprete, expansiones del intérprete, redirecciones, las cuales son una forma de dirigir entrada y salida desde y hacia archivos nombrados, y cómo el intérprete ejecuta instrucciones.

3.1 Sintaxis del Intérprete

Cuando el intérprete lee la entrada, procede a través de una secuencia de operaciones. Si la entrada indica el inicio de un comentario, el intérprete ignora el símbolo de comentario (‘#’) y el resto de esa línea.

De lo contrario, básicamente, el intérprete lee su entrada y divide la entrada en palabras y operadores, empleando las reglas de entrecomillado para elegir qué significados asignar a varias palabras y caracteres.

El intérprete entonces transforma estos símbolos en instrucciones y otras construcciones, elimina el significado especial de ciertas palabras o caracteres, expande otros, redirige entrada y salida según sea necesario, ejecuta la instrucción especificada, espera el estado de salida de la instrucción y deja disponible ese estado de salida para inspección o procesamiento posterior.

3.1.1 Funcionamiento del Intérprete

Lo siguiente es una breve descripción del funcionamiento del intérprete cuando lee y ejecuta una instrucción. Básicamente, el intérprete hace lo siguiente:

1. Lee su entrada de un archivo (véase la sección Guiones del Intérprete), de una cadena proporcionada como un argumento para la opción de llamada ‘-c’ (véase la sección Llamando a Bash) o de la terminal del usuario.
2. Divide la entrada en palabras y operadores, atendiendo a las reglas de entrecomillado descritas en Entrecomillado. Estos símbolos son separados por metacaracteres. La expansión de alias se realiza por este paso (véase la sección Aliases).
3. Transforma estos símbolos en instrucciones simples y compuestas (véase la sección Instrucciones del Intérprete).
4. Realiza las distintas expansiones del intérprete (véase la sección Expansiones del Intérprete), dividiendo los símbolos expandidos en listas de nombres de archivo (véase la sección Expansión de Nombre de Archivo e instrucciones y argumentos.
5. Realiza cualquier redirección necesaria (véase la sección Redirecciones) y elimina los operadores de redirección y sus operandos de la lista de argumentos.
6. Ejecuta la instrucción (véase la sección Ejecutando Instrucciones).
7. Opcionalmente espera a que la instrucción termine y recoge su estado de salida (véase la sección Estado de Salida).

3.1.2 Entrecomillado

El entrecomillado se usa para eliminar el significado especial para el intérprete de ciertos caracteres o palabras. El entrecomillado se puede usar para deshabilitar el tratamiento especial de caracteres especiales, para evitar que se reconozcan palabras reservadas como tales y para evitar la expansión de parámetro.

Cada uno de los metacaracteres del intérprete (véase la sección Definiciones) tiene un significado especial para el intérprete y debe ser entrecomillado si se representa a sí mismo. Cuando se usan las facilidades de expansión del historial de instrucciones (véase la sección Expansión del Historial), el carácter de expansión de historial, normalmente ‘!’, debe entrecomillarse para evitar la expansión de historial. Véase la sección Servicios del Historial de Bash, para más detalles sobre la expansión de historial.

Hay tres mecanismos de entrecomillado: el carácter de escape, comillas simples y comillas dobles.

3.1.2.1 Carácter de Escape

La barra invertida sin entrecomillar ‘\’ es el carácter de escape de Bash. Preserva el valor literal del siguiente carácter que lo sigue, con la excepción de nueva línea. Si aparece una pareja \nueva línea y la barra invertida en sí no está entrecomillada, la \nueva línea se trata como una continuación de línea (es decir, es eliminada del flujo de entrada y es efectivamente ignorada).

3.1.2.2 Comillas Simples

Encerrar caracteres en comillas simples (‘'’) preserva el valor literal de cada carácter dentro de las comillas. Una comilla simple no puede encontrarse entre comillas simples, incluso precedida de una barra invertida.

3.1.2.3 Comillas Dobles

Encerrar caracteres en comillas dobles (‘"’) preserva el valor literal de todos los caracteres entre las comillas, con la excepción de ‘$’, ‘`’, ‘\’ y, cuando está activada la expansión de historial, ‘!’. Cuando el intérprete está en modo POSIX (véase la sección Modo POSIX de Bash), el ‘!’ no tiene un significado especial entre comillas dobles, incluso cuando está activada la expansión de historial. Los caracteres ‘$’ y ‘`’ conservan su significado especial dentro de comillas dobles (véase la sección Expansiones del Intérprete). La barra invertida solo conserva su significado especial seguido por uno de los siguientes caracteres: ‘$’, ‘`’, ‘"’, ‘\’ o nueva línea. Dentro de comillas dobles, las barras invertidas que son seguidas por uno de estos caracteres son eliminadas. Las barras invertidas precediendo caracteres sin un significado especial no se modifican. Una comilla doble puede ser entrecomillada dentro de comillas dobles precediéndola con una barra invertida. Si está habilitada, la expansión del historial se realizará a no ser que se escape un ‘!’ que aparezca entre comillas dobles con una barra invertida. La barra invertida que precede al ‘!’ no es eliminada.

Los parámetros especiales ‘*’ y ‘@’ tienen significado especial entre comillas dobles (véase la sección Expansión de Parámetros del Intérprete).

3.1.2.4 Entrecomillado ANSI-C

Las palabras de forma $'cadena' se tratan de forma especial. La palabra se expande a cadena, con los caracteres escapados por barras invertidas reemplazados como se especifica en el estándar ANSI C. Si están presentes, las secuencias de escape de barras invertidas se decodifican así:

\a

alerta (timbre)

\b

retroceso

\e

\E

un carácter de escape (no ANSI C)

\f

salto de página

\n

nueva línea

\r

retorno de carro

\t

tabulación horizontal

\v

tabulación vertical

\\

barra invertida

\'

comilla simple

\"

comilla doble

\?

símbolo de interrogación de cierre

\nnn

el carácter de ocho bits cuyo valor es el valor octal nnn (de uno a tres dígitos octales).

\xHH

el carácter de ocho bits cuyo valor es el valor hexadecimal HH (uno o dos dígitos hexadecimales)

\uHHHH

el carácter Unicode (ISO/IEC 10646) cuyo valor es el valor hexadecimal HHHH (de uno a cuatro dígitos hexadecimales)

\UHHHHHHHH

el carácter Unicode (ISO/IEC 10646) cuyo valor es el valor hexadecimal HHHHHHHH (de uno a ocho dígitos hexadecimales)

\cx

un catácter control-x

El resultado expandido es entrecomillado con una comilla, como si el símbolo de dolar no hubiera estado presente.

3.1.2.5 Traducción de Región Específica

Una cadena entre comillas dobles precedida del signo de dolar (‘$’) hará que la cadena sea traducida según la configuración regional actual. Si la configuración regional actual es C o POSIX, se ignora el signo de dolar. Si la cadena se traduce y reemplaza, el remplazo está entre comillas dobles.

Algunos sistemas usan el catálogo de mensajes elegido por la variable del intérprete LC_MESSAGES. Otros crean el nombre del catálogo de mensajes desde el valor de la variable del intérprete TEXTDOMAIN, posiblemente añadiendo un sufijo de ‘.mo’. Si usa la variable TEXTDOMAIN, puede que necesite establecer la variable TEXTDOMAINDIR a la ubicación del archivo de catálogo de mensajes. Otros usan todavía ambas variables de esta forma: TEXTDOMAINDIR/LC_MESSAGES/LC_MESSAGES/TEXTDOMAIN.mo.

3.1.3 Comentarios

En un intérprete no interactivo o un intérprete interactivo en que la opción interactive_comments para la instrucción integrada shopt está activada (véase la sección La Instrucción Integrada Shopt), una palabra que empieza por ‘#’ hace que esa palabra y todos los caracteres restantes en esa línea sean ignorados. Un intérprete interactivo sin la opción interactive_comments activada no permite comentarios. La opción interactive_comments está activada por defecto en intérpretes interactivos. Véase la sección Intérpretes Interactivos, para una descripción de qué hace a un intérprete interactivo.

3.2 Instrucciones del Intérprete

Una instrucción simple del intérprete como echo a b c consta de la instrucción en sí seguida por argumentos, separados por espacios.

Las instrucciones del intérprete más complejas están compuestas de instrucciones simples organizadas conjuntamente de diferentes maneras: en una tubería en que la salida de una instrucción se convierte en la entrada de una segunda, en un bucle o instrucción condicional o en alguna otra agrupación.

3.2.1 Instrucciones Simples

Una instrucción simple es el tipo de instrucción encontrado más a menudo. Es solo una secuencia de palabras separadas por blancos, terminada en uno de los operadores de control del intérprete (véase la sección Definiciones). La primera palabra especifica generalmente una instrucción para que sea ejecutada, siendo el resto de las palabras los argumentos de esa instrucción.

El estado de retorno (véase la sección Estado de Salida) de una instrucción simple es su estado de salida tal como estipula la función POSIX 1003.1 waitpid o 128+n si la instrucción fue terminada por la señal n.

3.2.2 Tuberías

Una tubería es una secuencia de una o más instrucciones separadas por uno de los operadores de control ‘|’ o ‘|&’.

El formato para una tubería es

[time [-p]] [!] instrucción1 [ | o |& instrucción2 ] …

La salida de cada instrucción en la tubería es conectada por medio de una tubería a la entrada de la siguiente instrucción. Es decir, cada instrucción lee la salida de la anterior instrucción. Esta conexión se realiza antes de cualquier redirección especificada por la instrucción.

Si se usa ‘|&’, el error estándar de instrucción1, además de su salida estándar, es conectado a la entrada estándar de instrucción2 a través de la tubería; es una abreviatura de 2>&1 |. Esta redirección implícita del error estándar a la salida estándar es realizada después de cualquier redirección especificada por la instrucción.

La palabra reservada time hace que sean imprimidas estadísticas temporales para la tubería una vez finalice. Las estadísticas constan actualmente del tiempo (de reloj) transcurrido y del tiempo de usuario y de sistema consumido por la ejecución de la instrucción. La opción ‘-p’ cambia el formato de salida al especificado por POSIX. Cuando el intérprete está en el modo POSIX (véase la sección Modo POSIX de Bash), no reconoce time como una palabra reservada si el siguiente símbolo comienza por ‘-’. La variable TIMEFORMAT puede ser establecida a una cadena de formato que especifica cómo debe ser mostrada la información temporal. Véase la sección Variables de Bash, para una descripción de los formatos disponibles. El uso de time como una palabra reservada permite el cronometraje de las instrucciones integradas del intérprete, funciones del intérprete y tuberías. Una instrucción time externa no puede cronometrar estas fácilmente.

Cuando el intérprete está en modo POSIX (véase la sección Modo POSIX de Bash), time puede ser seguido por una nueva línea. En este caso, el intérprete muestra el tiempo total de usuario y de sistema consumido por el intérprete y sus hijos. La variable TIMEFORMAT puede ser usada para especificar el formato de la información temporal.

Si la tubería no es ejecutada asíncronamete (véase la sección Listas de Instrucciones), el intérprete espera a que todas las instrucciones en la tubería se completen.

Cada instrucción en una tubería se ejecuta en su propio subintérprete, que es un proceso separado (véase la sección Entorno de Ejecución de Instrucciones). Si la opción lastpipe está activada por medio de la instrucción integrada shopt (véase la sección La Instrucción Integrada Shopt), el último elemento de una tubería puede ser ejecutado por el proceso del intérprete.

El estado de salida de una tubería es el estado de salida de la última instrucción en la tubería, a no ser que esté activada la opción pipefail (véase la sección La Instrucción Integrada Set). Si pipefail está habilitada, el estado de retorno de la tubería es el valor de la última (la más a la derecha) instrucción que finalice con un estado distinto a cero, o cero si todas las instrucciones finalizan con éxito. Si la palabra reservada ‘!’ precede a la tubería, el estado de salida es la negación lógica del estado de salida descrito anteriormente. El intérprete espera a que finalicen todas las instrucciones en la tubería antes de devolver un valor.

3.2.3 Listas de Instrucciones

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

De esta lista de operadores, ‘&&’ y ‘||’ tienen igual precedencia, seguidos de ‘;’ y ‘&’, que tienen igual precedencia.

Una secuencia de una o más nuevas líneas puede aparecer en una lista para delimitar instrucciones, equivalente a un punto y coma.

Si se termina una instrucción con el operador de control ‘&’, el intérprete ejecuta la instrucción asíncronamente en un subintérprete. Esto se conoce como ejecutar la instrucción en segundo plano, y estas se conocen como instrucciones asíncronas. El intérprete no espera a que termine la instrucción, y el estado de retorno es 0 (verdadero). Cuando el control de tareas no está activo (véase la sección Control de Tareas), la entrada estándar para instrucciones asíncronas, en ausencia de cualquier redirección explícita, es redirigida desde /dev/null.

Las instrucciones separadas por un ‘;’ son ejecutadas secuencialmente; el intérprete espera a que cada instrucción termine en orden. El estado de retorno es el estado de salida de la última instrucción ejecutada.

Las listas AND y OR son secuencias de una o más tuberías separadas por los operadores de control ‘&&’ y ‘||’, respectivamente. Las listas AND y OR son ejecutadas con asociatividad izquierda.

Una lista AND tiene la forma

instrucción1 && instrucción2

instrucción2 es ejecutada únicamente si instrucción1 devuelve un estado de salida de cero (éxito).

Una lista OR tiene la forma

instrucción1 || instrucción2

instrucción2 es ejecutada únicamente si instrucción1 devuelve un estado de salida distinto de cero.

El estado de retorno de las listas AND y OR es el estado de salida de la última instrucción ejecutada en la lista.

3.2.4 Instrucciones Compuestas

Las instrucciones compuestas son las construcciones del lenguaje de programación del intérprete. Cada construcción empieza con una palabra reservada u operador de control y termina con una palabra reservada u operador correspondiente. Cualquier redirección (véase la sección Redirecciones) asociada a una instrucción compuesta se aplica a todas las instrucciones dentro de esa instrucción compuesta a no ser que sea reemplazada explícitamente.

En la mayoría de los casos, una lista de instrucciones en una descripción de instrucción compuesta puede ser separada del resto de las instrucción por una o más nuevas líneas, y puede ser seguida por una nueva línea en lugar de un punto y coma.

Bash proporciona construcciones de bucle, instrucciones condicionales y mecanismos para agrupar instrucciones y ejecutarlas como una unidad.

3.2.4.1 Construcciones de Bucle

Bash acepta las siguientes construcciones de bucle.

Tenga en cuenta que cada vez que aparezca un ‘;’ en la descripción de la sintaxis de una instrucción, puede ser reemplazado por una o más nuevas líneas.

until

La sintaxis de la instrucción until es:

until instrucciones-test; do instrucciones-consiguientes; done

Ejecuta instrucciones-consiguientes mientras que instrucciones-test tenga un estado de salida que no sea cero. El estado de retorno es el estado de salida de la última instrucción ejecutada en instrucciones-consiguientes, o cero si ninguna fue ejecutada.

while

La sintaxis de la instrucción while es:

while instrucciones-test; do instrucciones-consiguientes; done

Ejecuta instrucciones-consiguientes mientras que instrucciones-test tenga un estado de salida de cero. El estado de retorno es el estado de salida de la última instrucción ejecutada en instrucciones-consiguientes, o cero si ninguna fue ejecutada.

for

La sintaxis de la instrucción for es:

for nombre [ [in [palabras …] ] ; ] do instrucciones; done

Expande palabras (véase la sección Expansiones del Intérprete) y ejecuta instrucciones una vez por cada elemento en la lista resultante, con nombre vinculado al miembro actual. Si ‘in palabras’ no está presente, la instrucción for ejecuta las instrucciones una vez por cada parámetro posicional que esté establecido, como si ‘in "$@"’ hubiera sido especificado (véase la sección Parámetros Especiales).

El estado de retorno es el estado de salida de la última instrucción que ejecuta. Si no hay elementos en la expansión de palabras, no se ejecutan instrucciones y el estado de retorno es cero.

También se acepta una forma alternativa de la instrucción for:

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

Primero, la expresión aritmética expr1 se evalúa de acuerdo a las reglas descritas adelante (véase la sección Aritmética del Intérprete). La expresión aritmética expr2 es entonces evaluada repetidamente hasta que evalúe a cero. Cada vez que expr2 evalúe a un valor distinto de cero, se ejecutan las instrucciones y se evalúa la expresión aritmética expr3. Si se omite cualquier expresión, se comporta como si evaluara a 1. El valor de retorno es el estado de salida de la última instrucción que es ejecutada en instrucciones, o falso si cualquiera de las expresiones es inválida.

Las instrucciones integradas break y continue (véase la sección Instrucciones Integradas del Bourne Shell) se pueden usar para controlar la ejecución del bucle.

3.2.4.2 Construcciones Condicionales

if

La sintaxis de la instrucción if es:

if instrucciones-test; then instrucciones-consiguientes; [elif más-instrucciones-test; then más-consiguientes;] [else consiguientes-alternativas;] fi

La lista de instrucciones-test es ejecutada, y si su estado de retorno es cero, la lista de instrucciones-consiguientes es ejecutada. Si instrucciones-test devuelve un estado de retorno distinto de cero, cada lista elif es ejecutada en orden, y si su estado es cero, el más-consiguientes correspondiente es ejecutado y la instrucción se completa. Si ‘else consiguientes-alternativas’ está presente, y la instrucción final en la última cláusula if o elif tiene un estado de salida distinto de cero, entonces consiguientes-alternativas es ejecutado. El estado de retorno es el estado de salida de la última instrucción ejecutada, o cero si ninguna condición se evaluó a verdadero.

case

La sintaxis de la instrucción case es:

case palabra in [ [(] patrón [| patrón]…) lista-de-instrucciones ;;]… esac

case ejecutará selectivamente la lista-de-instrucciones correspondiente al primer patrón que coincide con palabra. La coincidencia se realiza según las reglas descritas más adelante en Coincidencia de Patrones. Si la opción del intérprete nocasematch (vea la descripción de shopt en La Instrucción Integrada Shopt) está habilitada, la coincidencia se realiza sin tener en cuenta las mayúsculas y minúsculas de caracteres alfabéticos. El ‘|’ es usado para separar múltiples patrones, y el operador ‘)’ finaliza una lista de patrón. Se llama cláusula a la lista de patrones y a su lista de instrucciones asociada.

Cada cláusula debe terminar en ‘;;’, ‘;&’ o ‘;;&’. La palabra pasa por la expansión de virgulilla, expansión de parámetro, sustitución de instrucción, expansión aritmética y eliminación de comillas (véase la sección Expansión de Parámetros del Intérprete) antes de que se intente la coincidencia. Cada patrón pasa por la expansión de virgulilla, sustitución de instrucción y expansión aritmética.

Puede haber un número arbitrario de cláusulas case, cada una terminada en ‘;;’, ‘;&’ o ‘;;&’. El primer patrón que coincide determina la lista de instrucciones que es ejecutada. Es una expresión normal usar ‘*’ como el patrón final para definir el caso predeterminado, ya que ese patrón siempre coincidirá.

Aquí hay un ejemplo que usa case en un guion que podría ser usado para describir un rasgo interesante de un animal:

echo -n "Introduzca el nombre de un animal: " read ANIMAL echo -n "El $ANIMAL tiene " case $ANIMAL in caballo | perro | gato) echo -n "cuatro";; hombre | canguro ) echo -n "dos";; *) echo -n "un número desconocido de";; esac echo " patas."

Si se usa el operador ‘;;’, no se intentan más coincidencias después de la primera coincidencia de patrón. Usar ‘;&’ en lugar de ‘;;’ hace que la ejecución continúe con la lista-de-instrucciones asociada con la próxima cláusula, si existe. Usar ‘;;&’ en lugar de ‘;;’ hace que el intérprete pruebe los patrones en la próxima cláusula, si existen, y ejecuta cualquier lista-de-instrucciones asociada cuando hay una coincidencia con éxito.

El estado de retorno es cero si ningún patrón coincide. En caso contrario, el estado de retorno es el estado de salida de la lista-de-instrucciones ejecutada.

select

La construcción select permite la sencilla generación de menús. Tiene casi la misma sintaxis que la instrucción for:

select nombre [in palabras …]; do instrucciones; done

La lista de palabras detrás de in es expandida, generando una lista de elementos. El conjunto de palabras expandidas es imprimido en el flujo de la salida de error estándar, cada una precedida por un número. Si se omite el ‘in palabras’, se imprimen los parámetros posicionales, como si ‘in "$@"’ hubiera sido especificado. El prompt PS3 es entonces mostrado y es leída una línea de la entrada estándar. Si la línea consta de un número correspondiente a una de las palabras mostradas, el valor de nombre es establecido a esa palabra. Si la línea está vacía, las palabras y el prompt se muestran de nuevo. Si es leído EOF, la instrucción select se completa. Cualquier otro valor leído hace que nombre se establezca a nulo. La línea leída es guardada en la variable REPLY.

Las instrucciones se ejecutan después de cada selección hasta que se ejecute una instrucción break, en cuyo momento la instrucción select se completa.

He aquí un ejemplo que permite al usuario escoger un nombre de archivo del directorio actual y muestra el nombre y el índice del archivo seleccionado.

select narchivo in *; do echo escogiste $narchivo \($REPLY\) break; done

((…))

(( expresión ))

La expresión aritmética se evalúa de acuerdo a las reglas descritas adelante (véase la sección Aritmética del Intérprete). Si el valor de la expresión es distinto de cero, el estado de retorno es 0; de lo contrario, el valor de retorno es 1. Esto es exactamente equivalente a

let "expresión"

Véase la sección Instrucciones Integradas de Bash, para una descripción completa de la instrucción integrada let.

[[…]]

[[ expresión ]]

Devuelve un estado de 0 o 1 dependiendo de la evaluación de la expresión condicional expresión. Las expresiones están compuestas de los elementos primarios descritos más adelante en Expresiones Condicionales de Bash. La división de palabras y la expansión de nombre de archivo no se realizan en las palabras entre el [[ y el ]]; son realizadas la expansión de virgulilla, la expansión de parámetro y de variable, la expansión aritmética, la sustitución de instrucciones, la sustitución de proceso y la eliminación de entrecomillado. Los operadores condicionales como ‘-f’ no deben estar entrecomillados para ser reconocidos como opciones primarias.

Cuando se usa con [[, los operadores ‘<’ y ‘>’ ordenan lexicográficamente usando la configuración regional actual.

Cuando se usan los operadores ‘==’ y ‘!=’, la cadena a la derecha del operador es considerada un patrón y es correspondida según las reglas descritas a continuación en Coincidencia de Patrones, como si la opción del intérprete extglob estuviera habilitada. El operador ‘=’ es idéntico a ‘==’. Si la opción del intérprete nocasematch (vea la descripción de shopt en La Instrucción Integrada Shopt) está habilitada, la correspondencia se realiza sin importar las mayúsculas y minúsculas de los caracteres alfabéticos. El valor de retorno es 0 si la cadena coincide (‘==’) o no coincide (‘!=’) con el patrón, y 1 en caso contrario. Cualquier parte del patrón puede ser entrecomillada para forzar la porción entrecomillada a que sea coincidida con una cadena.

Un operador binario adicional, ‘=~’, está disponible, con la misma precedencia que ‘==’ y ‘!=’. Cuando se usa, la cadena a la derecha del operador es considerada una expresión regular extendida POSIX y coincide debidamente (como en regex3)). El valor de retorno es 0 si la cadena coincide con el patrón, y 1 en caso contrario. Si la expresión regular es sintácticamente incorrecta, el valor de retorno de la expresión condicional es 2. Si está habilitada la opción del intérprete nocasematch (vea la descripción de shopt en La Instrucción Integrada Shopt), la coincidencia se realiza sin consideración de mayúsculas y minúsculas de los caracteres alfabéticos. Cualquier parte del patrón puede ser entrecomillada para obligar a que la porción entrecomillada sea coincidida como cadena. Las expresiones de llaves en expresiones regulares deben ser tratadas cuidadosamente, pues los caracteres de entrecomillado normales pierden sus significados entre llaves. Si el patrón se guardaen una variable del intérprete, entrecomillar la expansión de variable fuerza el patrón entero a que coincida como cadena. Las subcadenas coincididas por subexpresiones entre paréntesis dentro de la expresión regular son guardadas en la variable de vector BASH_REMATCH. El elemento de BASH_REMATCH con índice 0 es la porción de la cadena que coincide con la expresión regular completa. El elemento de BASH_REMATCH con índice n es la porción de la cadena que coincide con la subexpresión entre paréntesis número n.

Por ejemplo, lo siguiente coincidirá con una línea (guardada en la variable del intérprete linea) si hay una secuencia de caracteres en el valor que conste de cualquier número, incluido cero, de caracteres de espacio, cero o más instancias de ‘a’, después una ‘b’:

[[ $linea =~ [[:es:]]*?(a)b ]]

Eso quiere decir que valores como ‘aab’ y ‘ aaaaaab’ coincidirán, como también lo hará una línea que contenga una ‘b’ en cualquier lugar en su valor.

Guardar la expresión regular en una variable del intérprete es habitualmente una forma útil de evitar problemas con entrecomillar caracteres que son especiales para el intérprete. A veces es difícil especificar una expresión regular literalmente sin usar comillas, o llevar un seguimiento del entrecomillado usado por las expresiones regulares mientras se presta atención a la eliminación de comillas del intérprete. Usar una variable del intérprete disminuye estos problemas. Por ejemplo, lo siguiente es equivalente a lo anterior:

patron='[[:space:]]*?(a)b' [[ $linea =~ $patron ]]

Si quieres hacer coincidir un carácter que es especial para la gramática de expresiones regulares, tiene que ser entrecomillado para eliminar su significado especial. Esto significa que en el patrón ‘xxx.txt’, el ‘.’ corresponde a cualquier carácter en la cadena (su significado usual de expresión regular), pero en el patrón ‘"xxx.txt"’ puede corresponder solo a un ‘.’ literal. Los programadores del intérprete deberían tener un especial cuidado con las barras invertidas, puesto que las barras invertidas son usadas tanto por el intérprete como por las expresiones regulares para eliminar el significado especial del siguiente carácter. Los siguientes dos conjuntos de instrucciones no son equivalentes:

patron='\.' [[ . =~ $patron ]] [[ . =~ \. ]] [[ . =~ "$patron" ]] [[ . =~ '\.' ]]

Las primeras dos coincidencias tendrán éxito, pero las segundas dos no, porque en las segundas las barras invertidas serán parte del patrón que será coincidido. En los primeros dos ejemplos, la barra invertida elimina el significado especial de ‘.’, para que el ‘.’ coincida. Si la cadena en los primeros ejemplos fuera cualquier cosa distinta de ‘.’, digamos que ‘a’, el patrón no coincidiría, porque el ‘.’ entrecomillado en el patrón pierde su significado especial de coincidir con cualquier carácter.

Las expresiones pueden ser combinadas usando los siguientes operadores, listados en orden decreciente de precedencia:

( expresión )

Devuelve el valor de expresión. Esto puede ser usado para sobrescribir la precedencia normal de operadores.

! expresión

Verdadero si expresión es falso.

expresión1 && expresión2

Verdadero si tanto expresión1 como expresión son verdaderas.

expresión1 || expresión2

Verdadero si expresión1 o expresión2 es verdadera.

Los operadores && y || no evalúan expresión2 si el valor de expresión1 es suficiente para determinar el valor de retorno de la expresión condicional completa.

3.2.4.3 Agrupación de Instrucciones

Bash proporciona dos maneras de agrupar una lista de instrucciones para ser ejecutada como una únidad. Cuando las instrucciones son agrupadas, las redirecciones pueden ser agrupadas por la lista de instrucciones completa. Por ejemplo, la salida de todas las instrucciones en la lista puede ser redirigida a un único flujo.

()

( lista )

Ubicar una lista de instrucciones entre paréntesis hace que se cree un entorno de subintérprete (véase la sección Entorno de Ejecución de Instrucciones), y cada una de las instrucciones en lista sea ejecutada en ese subintérprete. Dado que la lista es ejecutada en un subintérprete, las asignaciones de variable no permanecen en vigor después de que el subintérprete finalice.

{}

{ lista; }

Ubicar una lista de instrucciones entre llaves hace que la lista sea ejecutada en el contexto actual del intérprete. No se crea un subintérprete. Se requiere el punto y coma (o nueva línea) después de lista.

Además de la creación de un subintérprete, hay una sutil diferencia entre estas dos construcciones debido a razones históricas. Las llaves son palabras reservadas, así que tienen que estar separadas de lista por blancos u otros metacaracteres del intérprete. Los paréntesis son operadores, y son reconocidos como símbolos separados por el intérprete incluso si no están separados de la lista por espacios en blanco.

El estado de salida de estas dos construcciones es el estado de salida de lista.

3.2.5 Coprocesos

Un coproceso es una instrucción del intérprete precedida por la palabra reservada coproc. Un coproceso es ejecutado asíncronamente en un subintérprete, como si la instrucción se hubiera terminado con el operador de control ‘&’, con una tubería de dos sentidos establecida entre el intérprete en ejecución y el coproceso.

El formato para un coproceso es:

coproc [NOMBRE] instrucción [redirecciones]

Esto crea un coproceso llamado NOMBRE. Si no se proporciona NOMBRE, el nombre predeterminado es COPROC. NOMBRE no tiene que ser proporcionado si instrucción es una instrucción simple (véase la sección Instrucciones Simples); de lo contrario, se interpreta como la primera palabra de una instrucción simple.

Cuando se ejecuta el coproceso, el intérprete crea una variable de vector (véase la sección Vectores) llamada NAME en el contexto del intérprete en ejecución. La salida estándar de instrucción se conecta a través de una tubería al descriptor de archivo en el intérprete en ejecución, y ese descriptor de archivo es asignado a NAME[0]. La entrada estándar de instrucción se conecta a través de una tubería a un descriptor de archivo en el intérprete en ejecución, y ese descriptor de archivo es asignado a NAME[1]. Esta tubería se establece antes de cualquier redirección especificada por la instrucción (véase la sección Redirecciones). Los descriptores de archivo pueden ser utilizados como argumentos para instrucciones del intérprete y redirecciones usando expansiones de palabras estándares. Aparte de aquellos creados para ejecutar sustituciones de instrucciones y procesos, los descriptores de archivos no están disponibles en subintérpretes.

El identificador de proceso del intérprete generado para ejecutar el coproceso está disponible como el valor de la variable NAME_PID. La instrucción integrada wait puede usarse para esperar a que el coproceso finalice.

Dado que el coproceso es creado como una instrucción asíncrona, la instrucción coproc siempre retorna éxito. El estado de retorno de un coproceso es el estado de salida de instrucción.

3.2.6 GNU Parallel

Hay varias maneras de ejecutar instrucciones en paralelo que no están integradas en Bash. GNU Parallel es una herramienta para hacer precisamente esto.

GNU Parallel, como su nombre sugiere, puede ser usado para construir y ejecutar instrucciones en paralelo. Puede ejecutar las mismas instrucciones con diferentes argumentos, ya sean nombres de archivo, nombre de usuario, nombres de equipos o líneas leídas de archivos. GNU Parallel proporciona referencias abreviadas a muchas de las operaciones más comunes (líneas de entrada, varias porciones de la línea de entrada, diferentes formas de especificar la fuente de entrada y demás). Parallel puede reemplazar xargs o surtir de instrucciones de sus fuentes de entrada a varias instancias diferentes de Bash.

Para una descripción completa, consulte la documentación de GNU Parallel. Unos pocos ejemplos deberían proporcionar una breve introducción a su uso.

Por ejemplo, es fácil reemplazar xargs para comprimir con gzip todos los archivos HTML en el directorio actual y sus subdirectorios:

find . -type f -name '*.html' -print | parallel gzip

Si necesita proteger caracteres especiales como nuevas líneas en nombres de archivo, use la opción de find ‘-print0’ y la opción de parallel ‘-0’.

Puede usar Parallel para mover archivos desde el directorio actual cuando el número de archivos es muy grande para procesar con una llamada a mv:

ls | parallel mv {} dirdest

Como puede ver, la {} es reemplazada con cada línea leída de la entrada estándar. Mientras que usar ls funcionará en la mayoría de los casos, no es suficiente encargarse de todos los nombres de archivo. Si necesita acomodar caracteres especiales en nombres de archivo, puede usar

find . -depth 1 \! -name '.*' -print0 | parallel -0 mv {} dirdest

como se menciona anteriormente.

Esto ejecutará tantas instrucciones mv como archivos haya en el directorio actual. Puede emular un xargs paralelo añadiendo la opción ‘-X’:

find . -depth 1 \! -name '.*' -print0 | parallel -0 -X mv {} dirdest

GNU Parallel puede reemplazar ciertas expresiones comunes que operan en líneas leídas de un archivo (en este caso, los nombres de archivo listados uno por línea):

	while IFS= read -r x; do
		haz-algo1 "$x" "config-$x"
		haz-algo2 < "$x"
	done < archivo | procesa-salida

con una sintaxis más compleja reminiscente de lambdas:

cat lista | parallel "haz-algo1 {} config-{} ; haz-algo2 < {}" |
           procesa-salida

Parallel proporciona un mecanismo integrado para eliminar las extensiones de nombre de archivo, que se presta a transformaciones o renombraciones de archivos en lote:

ls *.gz | parallel -j+0 "zcat {} | bzip2 >{.}.bz2 && rm {}"

Esto volverá a comprimir todos los archivos en el directorio actual con nombres acabados en .gz usando bzip2, ejecutando una tarea por CPU (-j+0) en paralelo. (Usamos ls por brevedad aquí; usar find como antes es más robusto de cara a nombres de archivo que contienen caracteres inesperados.) Parallel puede tomar argumentos de la línea de instrucciones; lo anterior puede ser también escrito como

parallel "zcat {} | bzip2 >{.}.bz2 && rm {}" ::: *.gz

Si una instrucción genera salida, puede que quieras preservar el orden de entrada en la salida. Por ejemplo, la siguiente instrucción

{
    echo foss.org.my ;
    echo debian.org ;
    echo freenetproject.org ;
} | parallel traceroute

mostrará como salida la llamada a traceroute que finalice primero. Añadiendo la opción ‘-k’

{
    echo foss.org.my ;
    echo debian.org ;
    echo freenetproject.org ;
} | parallel -k traceroute

asegurará que la salida de traceroute foss.org.my sea mostrada primero.

Finalmente, Parallel se puede usar para ejecutar una secuencia de instrucciones del intérprete en paralelo, similar a ‘cat file | bash’. No es raro tomar una lista de nombres de archivo, crear conjuntos de instrucciones del intérprete para operar sobre ellos y surtir de esa línea de instrucciones a un intérprete. Parallel puede acelerar esto. Asumiendo que ‘archivo’ contiene una lista de instrucciones del intérprete, una por línea,

parallel -j 10 < archivo

evaluará las instrucciones usando el intérprete (ya que no se ha proporcionado ninguna instrucción explícita como argumento), en bloques de diez tareas del intérprete cada vez.

3.3 Funciones del Intérprete

Las funciones del intérprete son una forma de agrupar instrucciones para su posterior ejecución usando un único nombre para el grupo. Son ejecutadas como una instrucción «normal». Cuando se usa el nombre de una función del intérprete como un nombre de instrucción simple, se ejecuta la lista de instrucciones asociada con ese nombre de función. Las funciones del intérprete son ejecutadas en el contexto actual del intérprete; ningún nuevo proceso es creado para interpretarlas.

Las funciones se declaran usando esta sintaxis:

nombre () instrucción-compuesta [ redirecciones ]

o

function nombre [()] instrucción-compuesta [ redirecciones ]

Esto define una función del intérprete llamada nombre. La palabra reservada function es opcional. Si se proporciona la palabra reservada function, los paréntesis son opcionales. El cuerpo de la función es la instrucción compuesta instrucción-compuesta (véase la sección Instrucciones Compuestas). Esa instrucción es normalmente una lista encerrada entre { y }, pero puede ser cualquier instrucción compuesta listada anteriormente, con una excepción: si se usa la palabra reservada function, pero no se proporcionan los paréntesis, las llaves son requeridas. instrucción-compuesta es ejecutada cada vez que nombre es especificado como el nombre de una instrucción. Cuando el intérprete está en modo POSIX (véase la sección Modo POSIX de Bash), nombre no puede ser el mismo que una de las instrucciones integradas especiales (véase la sección Instrucciones Integradas Especiales). Todas las (véase la sección Redirecciones) asociadas con la función del intérprete son realizadas cuando se ejecuta la función.

Una definición de función puede ser eliminada usando la opción ‘-f’ con la instrucción integrada unset (véase la sección Instrucciones Integradas del Bourne Shell).

El estado de salida de una definición de función es cero a no ser que ocurra un error de sintaxis o una función de solo lectura con el mismo nombre ya exista. Cuando se ejecuta, el estado de salida de una función es el estado de salida de la última instrucción ejecutada en el cuerpo.

Tenga en cuenta que por razones históricas, en el modo más usual las llaves que rodean el cuerpo de la función tienen que estar separadas del cuerpo por blancos o nuevas líneas. Esto es porque las llaves son palabras reservadas que solo son reconocidas como tales cuando están separadas de la lista de instrucciones por espacios en blanco u otros metacaracteres del intérprete. Además, al usar llaves, la lista debe terminar en un punto y coma, un ‘&’ o una nueva línea.

Cuando se ejecuta una función, los argumentos para la función se convierten en los parámetros posicionales durante su ejecución (véase la sección Parámetros Posicionales). El parámetro especial ‘#’ que se expande al número de parámetros posicionales se actualiza para reflejar el cambio. El parámetro especial 0 no es modificado. El primer elemento de la variable FUNCNAME es establecido al nombre de la función durante la ejecución de la función.

Todos los otros aspectos del entorno de ejecución del intérprete son idénticos entre una función y su ejecutor con estas excepciones: las traps DEBUG y RETURN no se heredan a no ser que se le haya dado a la función el atributo trace usando la instrucción integrada declare o la opción -o functrace haya sido habilitada con la instrucción integrada set, (en cuyo caso todas las funciones heredan las traps DEBUG y RETURN), y la trap ERR no se hereda a no ser que la opción del intérprete -o errtrace haya sido habilitada. Véase la sección Instrucciones Integradas del Bourne Shell, para la decripción de la instrucción integrada trap.

La variable FUNCNEST, si está establecida a un valor numérico mayor que 0, define el nivel máximo de anidamiento de funciones. Las llamadas de funciones que exceden el límite hacen que la instrucción completa se aborte.

Si la instrucción integrada return se ejecuta en una función, la función finaliza y la ejecución se reanuda con la siguiente instrucción después de la llamada a la función. Cualquier instrucción asociada con la trap RETURN es ejecutada antes de que la ejecución se reanude. Cuando una función finaliza, los valores de los parámetros posicionales y el parámetro especial ‘#’ se restablecen a los valores que tenían antes de la ejecución de la función. Si se le pasa un argumento numérico a return, este es el estado de retorno de la función; si no, el estado de retorno de la función es el estado de salida de la última instrucción ejecutada antes de return.

Las variables locales a la función pueden ser declaradas con la instrucción integrada local. Estas variables son solo visibles para la función y las instrucciones que invoca. Esto es especialmente importante cuando una función del intérprete llama a otras funciones.

Las variables locales variables «sombra» con el mismo nombre declarado en diferentes alcances. Por ejemplo, una variable local declarada en una función esconde una variable global del mismo nombre: referencias y asignaciones se refieren a la variable local, dejando la variable global sin modificar. Cuando la función retorna, la variable global es visible de nuevo.

El intérprete usa el alcance dinámico para controlar la visibilidad de una variables dentro de funciones. Con el alcance dinámico, las variables visibles y sus valores son un resultado de la secuencia de llamadas de función que hicieron que la ejecución llegara a la ubicación actual. El valor de una variable que una función ve depende de su valor dentro de su ejecutor, si existe, si el ejecutor es el alcance «global» u otra función del intérprete. Esto también es el valor a la que una declaración de variable local hace «sombra» y el valor que es restablecido cuando la función retorna.

Por ejemplo, si una variable var se declara como local en función func1, y func1 llama a otra función func2, las referencias a var hechas desde dentro de func2 resolverán a la variable local var de func1, haciendo sombra a cualquier variable global llamada var.

El siguiente guion demuestra este comportamiento. Al ser ejecutado, el guion muestra

In func2, var = func1 local

func1()
{
    local var='func1 local'
    func2
}

func2()
{
    echo "In func2, var = $var"
}

var=global
func1

La instrucción integrada unset también actúa usando el mismo alcance dinámico: si una variable es local al actual alcance, unset la eliminará; de lo contrario, la eliminación se referirá a la variable encontrada en cualquier alcance de llamada descrito arriba. Si una variable en el alcance local actual se elimina, permanecerá así hasta que sea restablecida en ese alcance o hasta que la función retorne. Una vez que la función retorna cualquier instancia de la variable en el alcance anterior se vuelve invisible. Si la eliminación actúa sobre una variable en un alcance anterior, cualquier instancia de una variable con ese nombre a la que se ha hecho sombra se volverá invisible.

Los nombres y definiciones de funciones pueden ser listados con la opción ‘-f’ para la instrucción integrada declare (typeset) (véase la sección Instrucciones Integradas de Bash). La opción ‘-F’ para declare o typeset listará solo los nombres de funciones (y opcionalmente el archivo fuente y el número de línea, si la opción del intérprete extdebug está habilitada). Las funciones pueden ser importadas para que los subintérpretes las tengan definidas automáticamente con la opción ‘-f’ para la instrucción integrada export (véase la sección Instrucciones Integradas del Intérprete).

Las funciones pueden ser recursivas. La variable FUNCNEST se puede usar para limitar la profundidad de la pila de llamadas y restringir el número de llamadas de función. Por defecto, no hay límite en el número de llamadas recursivas.

3.4 Parámetros del Intérprete

Un parámetro es una entidad que almacena valores. Puede ser un nombre, un número o uno de los caracteres especiales listados más abajo. Una variable es un parámetro denotado por un nombre. Una variable tiene un valor y cero o más atributos. Los atributos son asignados usando la instrucción integrada declare (consulte la descripción de la instrucción integrada declare en Instrucciones Integradas de Bash).

Un parámetro está establecido si se le ha asignado un valor. La cadena nula es un valor válido. Una vez que se asigne una variable, solo puede ser eliminada usando la instrucción integrada unset.

Se puede asignar a una variable con una declaración de la forma

nombre=[valor]

Si no se da valor, se asigna la cadena nula a la variable. Todos los valores experimentan la expansión de virgulilla, la expansión de parámetros y de variables, sustitución de instrucciones, expansión aritmética y eliminación de comillas (detallada a continuación). Si la variable tiene establecido su atributo integer, entonces el valor es evaluado como una expansión aritmética incluso si no es usada la expansión $((…)) (véase la sección Expansión Aritmética). No se realiza la separación de palabras, con la excepción de "$@" como se explica más abajo. No se realiza la expansión de nombre de archivo. Las declaraciones de asignaciones pueden aparecer también como argumentos para las instrucciones integradas alias, declare, typeset, export, readonly y local (instrucciones de declaración). Durante modo POSIX (véase la sección Modo POSIX de Bash), estas instrucciones integradas pueden aparecer en una instrucción después de una o más instancias de la instrucción integrada command y mantener estas propiedades de declaración de asignación.

En el contexto en el que una sentencia de asignación esté asignando un valor a una variable o índice de vector (véase la sección Vectores) del intérprete, el operador ‘+=’ puede ser usado para añadir o sumar al valor previo de la variable. Esto incluye argumentos de instrucciones integradas como declare que aceptan sentencias de asignación (instrucciones de declaración). Cuando ‘+=’ se aplica a una variable para la cual el atributo integer ha sido establecido, valor se evalúa como una expresión aritmética y se suma al valor actual de la variable, que también es evaluado. Cuando ‘+=’ se aplica a una variable de vector usando la asignación compuesta (véase la sección Vectores), el valor de la variable no es eliminado (como lo es al usar ‘=’), y se adjuntan nuevos valores al vector empezando por un número a partir del índice máximo del vector (para vectores indexados), o se añade como una pareja clave-valor en un vector asociativo. Cuando se aplica a una variable con valor de cadena, valor se expande y se añade al valor de la variable.

Se puede asignar una variable el atributo nameref usando la opción ‘-n’ para las instrucciones integradas declare o local (véase la sección Instrucciones Integradas de Bash) para crear una nameref, o una referencia a otra variable. Esto permite que las variables sean manipuladas indirectamente. Cada vez que se haga referencia a la variable nameref, se asigne, elimine o sean modificados sus atributos (aparte de usando o cambiando el atributo nameref en sí), la operación se realiza en la variable especificada por el valor de la variable nameref. Un nameref se usa comúnmente dentro de las funciones del intérprete para referirse a una variable cuyo nombre es pasado como un argumento a la función. Por ejemplo, si un nombre de variable es pasado a una función del intérprete como su primer argumento, ejecutar

declare -n ref=$1

dentro de la función crea una variable nameref ref cuyo valor es el nombre de variable pasado como el primer argumento. Las referencias y asignaciones a ref, y cambios a sus atributos, son tratados como referencias, asignaciones y modificaciones de atributo a la variable cuyo nombre fue pasado a $1.

Si la variable de control en un bucle for tiene el atributo nameref, la lista de palabras puede ser una lista de variables del intérprete, y una referencia de nombre será establecida para cada palabra en la lista, en orden, cuando el bucle sea ejecutado. No se le puede dar el atributo nameref a las variables de vector. Sin embargo, las variables nameref pueden hacer referencia a variables de vector y variables de subíndice de vector. Los namerefs pueden ser eliminados usando la opción ‘-n’ de la instrucción integrada unset (véase la sección Instrucciones Integradas del Bourne Shell). De lo contrario, si se ejecuta unset con el nombre de una variable nameref como un argumento, la variable referenciada por la variable nameref será eliminada.

3.4.1 Parámetros Posicionales

Un parámetro posicional es un parámetro denotado por uno o más dígitos, aparte del único dígito 0. Los argumentos posicionales se asignan desde los argumentos del intérprete cuando es llamado y pueden ser reasignados usando la instrucción integrada set. El parámetro posicional N puede ser referenciado como ${N}, o como $N cuando N consta de un único dígito. Los parámetros posicionales no pueden ser asignados con declaraciones de asignación. Las instrucciones integradas set y shift son usadas para asignar y eliminarlos (véase la sección Instrucciones Integradas del Intérprete). Los parámetros posicionales son temporalmente reemplazados cuando se ejecuta una función del intérprete (véase la sección Funciones del Intérprete).

Cuando un parámetro posicional que consta de un único dígito se expande, debe estar rodeado de llaves.

3.4.2 Parámetros Especiales

El intérprete trata varios parámetros de forma especial. Estos parámetros solo pueden ser referenciados; las asignaciones a ellos no están permitidas.

*

($*) Se expande a los parámetros posicionales, empezando por uno. Cuando la expansión no está entre comillas dobles, cada parámetro posicional se expande a una palabra separada. En los contextos donde se realiza, aquellas palabras están sujetas a una división de palabras y expansión de nombre de archivo posteriores. Cuando la expansión ocurre dentro de comillas dobles, se expande a una única palabra con el valor de cada parámetro separado por el primer carácter de la variable especial IFS. Es decir, "$* es equivalente a "$1c$2c…", donde c es el primer carácter del valor de la variable IFS. Si se elimina IFS, los parámetros se separan por espacios. Si IFS no está asignado, los parámetros se unen sin separadores intermedios.

@

($@) Se expande a los parámetros posicionales empezando por uno. En contextos donde se realiza la división de palabras, esto expande cada parámetro posicional a una palabra separada; si no está entre comillas dobles, estas palabras están sujetas a la división de palabras. En contextos donde no se realiza la división de palabras, esto se expande a una única palabra con cada parámetro posicional separado por un espacio. Cuando la expansión ocurre dentro de comillas dobles y se realiza la división de palabras, cada parámetro se expande a una palabra separada. Es decir, "$@" es equivalente a "$1" "$2" …. Si la expansión rodeada entre comillas dobles ocurre dentro de una palabra, la expansión del primer parámetro se una con la parte inicial de la palabra original y la expansión del último parámetro se una con la última parte de la palabra original. Cuando no hay parámetros posicionales, "$@" y $@ se expanden a nada (es decir, son eliminados).

#

($#) Se expande al número de parámetros posicionales en decimal.

?

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

-

($-, un guion.) Se expande a las actuales opciones centinelas como se especifica en la llamada, por la instrucción integrada set o aquellas establecidas por el propio intérprete (como la opción ‘-i’).

$

($$) Se expande al ID de proceso del intérprete. En un subintérprete (), se expande al ID de proceso del intérprete que lo llama, no del subintérprete.

!

($!) Se expande al ID de proceso de tarea ubicada en segundo plano más recientemente, bien ejecutada como una instrucción asíncrona o usando la instrucción integrada bg (véase la sección Instrucciones Integradas de Control de Tareas).

0

($0) Se expande al nombre del intérprete o el guion del intérprete. Esto es establecido durante la inicialización del intérprete. Si Bash se invoca con un archivo de instrucciones (véase la sección Guiones del Intérprete), $0 se establece al nombre de ese archivo. Si Bash se inicia con la opción ‘-c’ (véase la sección Llamando a Bash), entonces $0 se establece al primer argumento después de que la cadena sea ejecutada, si una está presente. De lo contrario, es establecido al nombre de archivo usado para llamar a Bash, como si fuera dado como argumento cero.

_

($_, una barra baja). Durante el inicio del intérprete, establecida al nombre de ruta absoluto usado para llamar al intérprete o el guion del intérprete ejecutado como se pasa en el entorno o en la lista de argumentos. Posteriormente, se expande al último argumento de la instrucción simple anterior, ejecutada en primer plano, después de la expansión. También asignada al nombre de ruta completo usado para llamar a cada instrucción ejecutada y ubicada en el entorno exportado para esa instrucción. Al consultar el correo, este parámetro guarda el nombre del archivo de correo.

3.5 Expansiones del Intérprete

La expansión se realiza en la línea de órdenes después de que haya sido dividida en símbolos. Hay siete tipos de expansión realizados:

• expansión de llaves
• expansión de virgulilla
• expansión de parámetros y variables
• sustitución de instrucciones
• expansión aritmética
• división de palabras
• expansión de nombre de archivo

El orden de las expansiones es expansión de llaves; expansión de virgulilla, expansión de parámetros y variables, expansión aritmética y sustitución de instrucciones (hechas de izquierda a derecha); división de palabras; y expansión de nombre de archivo.

En sistemas que lo soportan, hay un expansión adicional disponible: sustitución de proceso. Esta se realiza al mismo tiempo que la expansión de virgulilla, parámetros y variables y la sustitución de instrucciones.

Después de que se hayan realizado estas expansiones, los caracteres de entrecomillado presentes en la palabra original son eliminados a no ser que estos mismos hayan sido entrecomillados (eliminación de comillas).

Solo la expansión de llaves, división de palabras y la expansión de nombre de archivo pueden aumentar el número de palabras de la expansión; otras expansiones expanden una sola palabra a una sola palabra. Las únicas excepciones a esto son las expansiones de "$@" y $* (véase la sección Parámetros Especiales, y ${nombre[*]} (véase la sección Vectores).

Después de todas las expansiones, se realiza la eliminación de comillas (véase la sección Eliminación de Comillas).

3.5.1 Expansión de Llaves

La expansión de llaves es un mecanismo por el cual se pueden generar cadenas arbitrarias. Este mecanismo es similar a la expansión de nombre de archivo (véase la sección Expansión de Nombre de Archivo), pero los nombres de archivo generados no necesitan existir. Los patrones que serán expandidos por llaves toman la forma de un preámbulo opcional, seguido de una serie de cadenas separadas por comas o una expresión secuencial entre un par de llaves, seguida por un epílogo opcional. El preámbulo es prefijado a cada cadena contenida entre las llaves, y el epílogo es entonces añadido a cada cadena resultante, expandiendo de izquierda a derecha.

Las expansiones de llaves pueden ser anidadas. Los resultados de cada cadena expandida no se ordenan; se preserva el orden de izquierda a derecha. Por ejemplo,

bash$ echo a{d,c,b}e
ade ace abe

Una expresión secuencial toma la forma {x..y[..incr]}, donde x e y son enteros o caracteres únicos, y incr, un incremento opcional, es un entero. Cuando se proporcionan enteros, la expresión se expande a cada número entre x y y, inclusive. Los enteros proporcionados pueden ser prefijados con ‘0’ para forzar que cada término tenga la misma anchura. Cuando x o y comienzan en cero, el intérprete trata de obligar a todos los términos generados contener el mismo número de dígitos, rellenando con ceros donde sea necesario. Cuando se proporcionan los caracteres, la expresión se expande a cada carácter lexicográficamente entre x e y, inclusive, usando la configuración regional predeterminada C. Observe que tanto x e y deben ser del mismo tipo. Cuando se proporciona el incremento, se usa como diferencia entre cada término. El incremento predeterminado es 1 o -1 según corresponda.

La expansión de llaves se realiza antes que cualquier otra expansión, y se preservan todos los caracteres especiales de otras expansiones en el resultado. Es estrictamente textual. Bash no aplica ninguna interpretación sintáctica al contexto de la expansión o al texto entre las llaves.

Una expansión de llaves correctamente formada debe contener llaves de apertura y de cierre sin entrecomillar, y al menos una coma sin entrecomillar o una expresión secuencial válida. Cualquier expansión de llaves formada incorrectamente se deja sin modificar.

Un { o ‘,’ puede ser entrecomillado con una barra invertida para evitar que sea considerado parte de la expansión de llaves. Para evitar conflictos con la expansión de parámetros, la cadena ‘${’ no se considera apta para la expansión de llaves e inhibe la expansión de llaves hasta el ‘}’ de cierre.

Esta construcción se usa típicamente como atajo cuando el prefijo común de las cadenas que van a ser generadas es más largo que en el siguiente ejemplo:

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

o

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

3.5.2 Expansión de Virgulilla

Si una palabra comienza por un carácter de virgulilla sin entrecomillar (‘~’), todos los caracteres hasta la primera barra sin entrecomillar (o todos los caracteres, si no hay barra sin entrecomillar) son considerados un prefijo de virgulilla. Si ninguno de los caracteres en el prefijo de virgulilla está entrecomillado, los caracteres en el prefijo de virgulilla que siguen a la virgulilla son tratados como un posible nombre de acceso. Si este nombre de acceso es la cadena nula, la virgulilla se reemplaza por el valor de la variable HOME del intérprete. Si HOME no está establecida, se sustituye el directorio personal del usuario ejecutando el intérprete en su lugar. De lo contrario, se reemplaza el prefijo de virgulilla por el directorio personal asociado con el nombre de acceso especificado.

Si el prefijo de virgulilla es ‘~+’, el valor de la variable del intérprete PWD reemplaza el prefijo de virgulilla. Si el prefijo de virgulilla es ‘~-’, se sustituye el valor de la variable OLDPWD, si está establecida.

Si los caracteres que siguen la virgulilla en el prefijo de virgulilla constan de un número N, opcionalmente prefijado por un ‘+’ o un ‘-’, la expansión de virgulilla se reemplaza por el elemento correspondiente de la pila de directorios, como se mostraría por la instrucción integrada dirs llamada con los caracteres que siguen a la virgulilla en el prefijo de virgulilla como un argumento (véase la sección La Pila de Directorios). Si el prefijo de virgulilla, sin la virgulilla, consta de un número sin un ‘+’ o ‘-’ inicial, se asume ‘+’.

Si el nombre de acceso es inválido, o la expansión de virgulilla falla, la palabra se deja sin modificar.

Cada asignación de variable se revisa en busca de prefijos de virgulilla sin entrecomillar que inmediatamente sigan a un ‘:’ o al primer ‘=’. En estos casos, también es realizada la expansión de virgulilla. Consecuentemente, uno puede usar nombres de archivo con virgulillas en asignaciones a PATH, MAILPATH y CDPATH, y el intérprete asigna el valor expandido.

La siguiente tabla muestra cómo trata Bash los prefijos de virgulilla sin entrecomillar:

~

El valor de $HOME

~/foo

‘$HOME/foo’

~fred/foo

El subdirectorio foo del directorio personal del usuario fred

~+/foo

‘$PWD/foo’

~-/foo

‘${OLDPWD-'~-'}/foo’

~N

La cadena que sería mostrada por ‘dirs +N’

~+N

La cadena que sería mostrada por ‘dirs +N’

~-N

La cadena que sería mostrada por ‘dirs -N’

Bash también realiza la expansión de virgulilla en palabras que satisfacen las condiciones de asignación de variables (véase la sección Parámetros del Intérprete) cuando aparecen como argumentos de instrucciones simples. Bash no hace esto, aparte de para las instrucciones de declaración listadas arriaba, en el modo POSIX

3.5.3 Expansión de Parámetros del Intérprete

El carácter ‘$’ introduce la expansión de parámetros, sustitución de instrucciones o expansión aritmética. El nombre o símbolo del parámetro para ser expandido se puede encerrar en llaves, que son opcionales pero sirven para evitar que la variable se expanda de caracteres que inmediatamente lo siguen que podrían ser interpretados como parte del nombre.

Cuando se usan llaves, la llave de cierre coincidente es el primer ‘}’ no escapado por una barra invertida o dentro de una cadena entrecomillada, y no dentro de una expresión aritmética, sustitución de instrucción o expansión de parámetro incrustadas.

La forma básica de expansión de parámetros es ${parámetro}. El valor de parámetro es sustituido. El parámetro es un parámetro del intérprete como se describe arriba (véase la sección Parámetros del Intérprete) o una referencia de vector (véase la sección Vectores). Las llaves son requeridas cuando parámetro es un parámetro posicional con más de un dígito, o cuando parámetro es seguido por un carácter que no está pensado para ser interpretado como parte de su nombre.

Si el primer carácter de parámetro es un signo de exclamación (!) y parámetro no es un nameref, introduce un nivel de indirección. Bash usa el valor formado al expandir el resto de parámetro como el nuevo parámetro; este es luego expandido y ese valor se usa en el resto de la expansión, en vez de la expansión del parámetro original. Esto se conoce como expansión indirecta. El valor está sujeto a la expansión de virgulilla, la expansión de parámetros, la sustitución de instrucciones y la expansión aritmética. Si parámetro es un nameref, esto se expande al nombre de la variable referenciada por parámetro en vez de realizar la expansión indirecta completa. Las excepciones a esto son las expansiones de ${!prefijo*} y ${!nombre[@]} descritas abajo. El signo de exclamación debe seguir inmediatamente a la llave izquierda para introducir la indirección.

En todos los siguientes casos, palabra está sujeta a la expansión de virgulilla, expansión de parámetro, sustitución de instrucción y expansión aritmética.

Cuando no se realiza la expansión de subcadena, usando la forma descrita abajo (p. ej., ‘:-’), Bash comprueba por un parámetro que sea nulo o no esté establecido. Omitir los dos puntos resulta en una prueba solo para un parámetro que no esté establecido. Dicho de otra manera, si se incluyen los dos puntos, el operador comprueba la existencia de parámetro y que su valor no sea nulo; si se omiten los dos puntos, el operador solo comprueba su existencia.

${parámetro:-palabra}

Si parámetro no está establecido o es nulo, se sustituye por la expansión de palabra. De lo contrario, se sustituye por el valor de parámetro.

${parámetro:=palabra}

Si parámetro no está establecido o es nulo, se asigna la expansión de palabra a parámetro. Se sustituye entonces el valor de parámetro. A los parámetros posicionales y parámetros especiales no se les puede asignar de esta manera.

${parámetro:?palabra}

Si parámetro no está establecido o es nulo, la expansión de palabra (o un mensaje al respecto si palabra no está presente) es escrita al error estándar, y el intérprete, si no es interactivo, se cierra. De lo contrario, se sustituye el valor de parámetro.

${parámetro:+palabra}

Si parámetro es nulo o no está establecido, no se sustituye por nada; de lo contrario, se sustituye por la expansión de palabra.

${parámetro:desplazamiento}

${parámetro:desplazamiento:longitud}

Esto se conoce como Expansión de Subcadena. Se expande hasta longitud carácteres del valor de parámetro empezando por el carácter especificado por desplazamiento. Si parámetro es ‘@’, un vector indexado subindexado por ‘@’ o ‘*’ o un nombre de vector asociativo, los resultados difieren como se describe más abajo. Si se omite longitud, se expande a la subcadena del valor de parámetro empezando en el carácter especificado por desplazamiento y extendiéndose hasta el final del valor. longitud y desplazamiento son expresiones aritméticas (véase la sección Aritmética del Intérprete).

Si desplazamiento se evalúa a un número menor que cero, el valor se usa como un desplazamiento en caracteres desde el final del valor de parámetro. Si longitud se evalúa a un número menor que cero, se interpreta como un desplazamiento en caracteres desde el final del valor de parámetro en vez de un número de caracteres, y la expansión equivale a los caracteres entre desplazamiento y ese resultado. Observe que un desplazamiento negativo debe ser separado de los dos puntos por al menos un espacio para evitar confusión con la expansión ‘:-’.

Aquí hay algunos ejemplos que ilustran la expansión de subcadenas en parámetros y vectores subindexados:

$ cadena=01234567890abcdefgh
$ echo ${cadena:7}
7890abcdefgh
$ echo ${cadena:7:0}

$ echo ${cadena:7:2}
78
$ echo ${cadena:7:-2}
7890abcdef
$ echo ${cadena: -7}
bcdefgh
$ echo ${cadena: -7:0}

$ echo ${cadena: -7:2}
bc
$ echo ${cadena: -7:-2}
bcdef
$ set -- 01234567890abcdefgh
$ echo ${1:7}
7890abcdefgh
$ echo ${1:7:0}

$ echo ${1:7:2}
78
$ echo ${1:7:-2}
7890abcdef
$ echo ${1: -7}
bcdefgh
$ echo ${1: -7:0}

$ echo ${1: -7:2}
bc
$ echo ${1: -7:-2}
bcdef
$ vector[0]=01234567890abcdefgh
$ echo ${vector[0]:7}
7890abcdefgh
$ echo ${vector[0]:7:0}

$ echo ${vector[0]:7:2}
78
$ echo ${vector[0]:7:-2}
7890abcdef
$ echo ${vector[0]: -7}
bcdefgh
$ echo ${vector[0]: -7:0}

$ echo ${vector[0]: -7:2}
bc
$ echo ${vector[0]: -7:-2}
bcdef

Si parámetro es ‘@’, el resultado es longitud parámetros posicionales comenzando por desplazamiento. Un desplazamiento se toma en relación a uno mayor que el parámetro posicional más grande, de manera que un desplazamiento de -1 evalúa al último parámetro posicional. Es un error de expansión si longitud evalúa a un número menor que cero.

Los siguientes ejemplos ilustran la expansión de subcadenas usando parámetros posicionales:

$ set -- 1 2 3 4 5 6 7 8 9 0 a b c d e f g h
$ echo ${@:7}
7 8 9 0 a b c d e f g h
$ echo ${@:7:0}

$ echo ${@:7:2}
7 8
$ echo ${@:7:-2}
bash: -2: expresi@'on de subcadena < 0
$ echo ${@: -7:2}
b c
$ echo ${@:0}
./bash 1 2 3 4 5 6 7 8 9 0 a b c d e f g h
$ echo ${@:0:2}
./bash 1
$ echo ${@: -7:0}

Si parámetro es un nombre de vector subindexado por ‘@’ o ‘*’, el resultado es la longitud de miembros del vector que comienzan por ${parámetro[desplazamiento]}. Un desplazamiento negativo se toma respecto a uno mayor que el máximo índice del vector especificado. Es un error de expansión si longitud evalúa a un número menor que cero.

Estos ejemplos muestran cómo puede usar la expansión de subcadenas con vectores indexados:

$ vector=(0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h)
$ echo ${vector[@]:7}
7 8 9 0 a b c d e f g h
$ echo ${vector[@]:7:2}
7 8
$ echo ${vector[@]: -7:2}
b c
$ echo ${vector[@]: -7:-2}
bash: -2: expresi@'on de subcadena < 0
$ echo ${vector[@]:0}
0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h
$ echo ${vector[@]:0:2}
0 1
$ echo ${vector[@]: -7:0}

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

La indexación de subcadenas es a partir del cero a no ser que se usen los parámetros posicionales, en cuyo caso la indexación comienza en 1 por defecto. Si desplazamiento es 0 y se usan los parámetros posicionales, se prefija $@ a la lista.

${!prefijo*}

${!prefijo@}

Se expande a los nombres de variables cuyos nombres empiezan por 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 expande a una palabra separada.

${!nombre[@]}

${!nombre[*]}

Si nombre es una variable de vector, se expande a la lista de indices de vectores (claves) asignada en nombre. Si nombre no es un vector, se expande a 0 si nombre está establecido y a nulo en caso contrario. Cuando se usa ‘@’ y la expansión aparece entre comillas dobles, cada clave se expande a una palabra separada.

${#parámetro}

Se sustituye la longitud en caracteres del valor expandido de parámetro. Si parámetro es ‘*’ o ‘@’, el valor sustituido es el número de parámetros posicionales. Si parámetro es un nombre de vector subindexado por ‘*’ o ‘@’, el valor sustituido es el número de elementos en el vector. Si parámetro es un nombre de vector indexado subindexado por un número negativo, ese número es interpretado como relativo a uno mayor que el índice máximo de parámetro, de forma que los índices negativos cuenten atrás desde el final del vector, y un índice de -1 referencie al último elemento.

${parámetro#palabra}

${parámetro##palabra}

La palabra se expande para producir un patrón y es coincidida según las reglas descritas abajo (véase la sección Coincidencia de Patrones). Si el patrón coincide con el principio del valor expandido de parámetro, el resultado de la expansión es el valor expandido de parámetro con el patrón coincidente más corto (el caso ‘#’) o el patrón coincidente más largo (el caso ‘##’). Si parámetro es ‘@’ o ‘*’, se aplica la operación de eliminación de patrón a cada parámetro posicional en orden, y la expansión es la lista resultante. Si parámetro es una variable de vector subindexada con ‘@’ o ‘*’, la operación de eliminación de patrón se aplica a cada miembro del vector en orden, y la expansión es la lista resultante.

${parámetro%palabra}

${parámetro%%palabra}

La palabra se expande para producir un patrón y es coincidida según las reglas descritas abajo (véase la sección Coincidencia de Patrones). Si el patrón coincide con una porción del final del valor expandido de parámetro, el resultado de la expansión es el valor de parámetro con el patrón coincidente más corto (el caso ‘%’) o el patrón coincidente más largo (el caso ‘%%’). Si parámetro es ‘@’ o ‘*’, se aplica la operación de eliminación de patrón a cada parámetro posicional en orden, y la expansión es la lista resultante. Si parámetro es una variable de vector subindexada con ‘@’ o ‘*’, la operación de eliminación de patrón se aplica a cada miembro del vector en orden, y la expansión es la lista resultante.

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

El patrón se expande para producir un patrón de la misma manera que en la expansión de nombre de archivo. Se expande parámetro, y se reemplaza por cadena la coincidencia de patrón con el valor más largo. Si patrón comienza por ‘/’, todas las coincidencias de patrón son reemplazadas por cadena. La coincidencia se realiza según las reglas descritas abajo (véase la sección Coincidencia de Patrones). Normalmente solo se reemplaza la primera coincidencia. Si patrón comienza en ‘#’, debe coincidir al comienzo del valor expandido de parámetro. Si patrón comienza por ‘%’, debe coincidir al final del valor expandido de parámetro. Si cadena es nulo, las coincidencias de patrón son eliminadas y se puede omitir el / que sigue a patrón. Si está habilitada la opción del intérprete nocasematch (consulte la descripción de shopt en La Instrucción Integrada Shopt), la coincidencia se realiza sin importar las mayúsculas y minúsculas de caracteres alfabéticos. Si parámetro es ‘@’ o ‘*’, la operación de sustitución se aplica a cada parámetro posicional en orden y la expansión es la lista resultante. Si parámetro es una variable de vector subindexada con ‘@’ o ‘*’, se aplica la operación de sustitución a cada miembro del vector en orden y la expansión es la lista resultante.

${parámetro^patrón}

${parámetro^^patrón}

${parámetro,patrón}

${parámetro,,patrón}

La expansión modifica las mayúsculas y minúsculas de los caracteres alfabéticos. El patrón se expande para producir un patrón de la misma manera que en la expansión de nombre de archivo. Cada carácter en el valor expandido de parámetro es comprobado contra patrón, y, si coincide con el patrón, se alterna entre mayúsculas y minúsculas. El patrón no debería tratar de coincidir con más de un carácter. El operador ‘^’ convierte letras minúsculas que coinciden con patrón a mayúsculas; el operador ‘,’ convierte letras mayúsculas coincidentes a minúsculas. Las expansiones ‘^^’ y ‘,,’ convierten cada carácter coincidente en el valor expandido; las expansiones ‘^’ y ‘,’ coinciden y convierten solo el primer carácter en el valor expandido. Si se omite patrón, se trata como un ‘?’, que coincide con cualquier carácter. Si parámetro es ‘@’ o ‘*’, la operación de modificación de alternación entre mayúsculas y minúsculas se aplica a cada parámetro posicional en orden y la expansión es la lista resultante. Si parámetro es una variable de vector subindexada con ‘@’ o ‘*’, la operación de modificación de alternación entre mayúsculas y minúsculas se aplica a cada miembro en orden y la expansión es la lista resultante.

${parámetro@operador}

La expansión es o una transformación del valor de parámetro o información sobre parámetro en sí, dependiendo del valor de operador. Cada operador es una única letra:

Q

La expansión es una cadena que es el valor de parámetro entrecomillado en un formato que puede ser reutilizado como entrada.

E

La expansión es una cadena que es el valor de parámetro con secuencias de escape de barras bajas expandidas con el mecanismo de entrecomillado $'…'.

P

La expansión es una cadena que es el resultado de expandir el valor de parámetro como si fuera una cadena de prompt (véase la sección Controlando el Prompt).

A

La expansión es una cadena en forma de una sentencia de asignación o instrucción declare que, si se evalúa, recreará parámetro con sus atributos y valor.

a

La expansión es una cadena consistente en valores centinela que representan los atributos de parámetro.

Si parámetro es ‘@’ o ‘*’, se aplica la operación a cada parámetro posicional en orden y la expansión es la lista resultante. Si parámetro es una variable de vector subindexada con ‘@’ o ‘*’, la operación se aplica a cada miembro del vector en orden y la expansión es la lista resultante.

El resultado de la expansión está sujeto a la división de palabras y la expansión de nombre de archivo como se describe más abajo.

3.5.4 Sustitución de Instrucciones

La sustitución de instrucciones permite a la salida de una instrucción reemplazar a la propia instrucción. La sustitución de instrucción ocurre cuando se rodea una instrucción así:

$(instrucción)

o

`instrucción`

Bash realiza la expansión ejecutando instrucción en un entorno de subintérprete y reemplazando la sustitución de la instrucción con la salida estándar de la instrucción, con cualquier nueva línea final eliminada. Las nuevas líneas integradas no se eliminan, pero pueden ser borradas durante la división de palabras. La instrucción de sustitución $(cat file) puede ser reemplazada por el equivalente pero más rápido $(< archivo).

Cuando se usa la vieja forma de sustitución de comilla invertida, la barra invertida mantiene su significado literal excepto cuando es seguida por ‘$’, ‘`’ o ‘\’. La primera barra invertida no precedida por una barra invertida termina la sustitución de instrucción. Al usar la forma $(instrucción), todos los caracteres entre los paréntesis componen la instrucción; ninguno es tratado de forma especial.

Las sustituciones de instrucciones se pueden anidar. Para anidar usando la forma de comilla invertida, escape las comillas invertidas interiores con barras invertidas.

Si la sustitución aparece entre comillas dobles, la división de palabras y la expansión de nombre de archivo no se realizan en los resultados.

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

$(( expresión ))

La expresión se trata como si estuviera entre comillas dobles, pero una comilla doble dentro de los paréntesis no se trata de forma especial. Todos los símbolos en la expresión pasan por la expansión de parámetro y variable, sustitución de instrucción y eliminación de comillas. El resultado se trata como la expresión aritmética a evaluar. Las expansiones aritméticas pueden ser anidadas.

La evaluación se realiza de acuerdo a las reglas listadas abajo (véase la sección Aritmética del Intérprete). Si la expresión es inválida, Bash imprime un mensaje indicando fallo al error estándar y no ocurre ninguna sustitución.

3.5.6 Sustitución de Procesos

La sustitución de proceso permite hacer referencia a la entrada o salida de un proceso usando un nombre de archivo. Toma la forma de

<(lista)

o

>(lista)

La lista de proceso es ejecutada asíncronamente, y su entrada o salida aparece como un nombre de archivo. Este nombre de archivo es pasado como un argumento a la instrucción actual como el resultado de la expansión. Si se usa la forma >(lista), el archivo pasado como un argumento debería ser leído para obtener la salida de lista. Observe que no puede aparecer ningún espacio entre < o > y el paréntesis izquierdo, de lo contrario la construcción sería interpretada como una redirección. La sustitución de procesos está soportada en sistemas que admiten tuberías nombradas (FIFOs) o el método ‘/dev/fd’ de nombrar archivos abiertos.

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

3.5.7 División de Palabras

El intérprete escanea los resultados de la expansión de parámetros, la sustitución de instrucción y la expansión aritmética que no ocurrieron dentro de comillas dobles para división de palabras.

El intérprete trata cada carácter de $IFS como un delimitador y divide los resultados de las otras expansiones en palabras usando estos caracteres como terminadores de campos. Si IFS no está habilitado o su valor es exactamente <espacio><tabulación><nueva línea>, el predeterminado, las secuencias de <espacio>, <tabulación> y <nueva línea> al principio y el final de los resultados de las expansiones previas son ignorados, y cualquier secuencia de caracteres IFS que no estén al principio o al final sirve para delimitar palabras. Si IFS tiene un valor distinto al predeterminado, las secuencias de caracteres de espacios en blanco espacio, tabulación y nueva línea son ignoradas al principio y final de la palabra, mientras que el carácter de espacio en blanco esté en el valor de IFS (un carácter en blanco de IFS). Cualquier carácter en IFS que no sea un espacio en blanco de IFS, junto a algún carácter de espacio en blanco de IFS, delimita un campo. Una secuencia de caracteres de espacio en blanco de IFS también se trata como un delimitador. Si el valor de IFS es nulo, no ocurre ninguna división de palabra.

Los argumentos explícitamente nulos ("" o '') son conservados y pasados a instrucciones como cadenas vacías. Los argumentos nulos implícitos, resultantes de la expansión de parámetros que no tiene valores, son eliminados. Si un parámetro sin valor se expande entre comillas dobles, resulta en un argumento nulo y es retenido y pasado a una instrucción como una cadena vacía. Cuando un argumento nulo entrecomillado aparece como parte de una palabra cuya expansión no es nula, se elimina el argumento nulo. Es decir, la palabra -d" se convierte en -d después de la división de palabras y la eliminación de argumentos nulos.

Observe que si no ocurre ninguna expansión, no se realiza ninguna división.

3.5.8 Expansión de Nombre de Archivo

Después de la división de palabras, a no ser que la opción ‘-f’ haya sido establecida (véase la sección La Instrucción Integrada Set), Bash escanea cada palabra en busca de los caracteres ‘*’, ‘?’ y ‘[’. Si uno de estos caracteres aparece, la palabra es tratada como un patrón y reemplazada con una lista de nombres de archivo ordenada alfabéticamente que coincide con el patrón (véase la sección Coincidencia de Patrones). Si no se encuentra ningún nombre de archivo coincidente y está desactivada la opción del intérprete nullglob, la palabra se deja sin modificar. Si la opción nullglob está habilitada y no se encuentran coincidencias, la palabra es eliminada. Si la opción del intérprete failglob está establecida y no se encuentran coincidencias, se imprime un mensaje de error y no se ejecuta la instrucción. Si está habilitada la opción de intérprete nocaseglob, la coincidencia se realiza sin tener en cuenta las mayúsculas y minúsculas de caracteres alfabéticos.

Cuando se usa un patrón para la expansión de nombre de archivo, el carácter ‘.’ al principio de un nombre de archivo o inmediatamente siguiendo a una barra debe ser coincidido explícitamente, a no ser que la opción del intérprete dotglob esté habilitada. Los nombres de archivo ‘.’ y ‘..’ deben ser coincididos siempre explícitamente, incluso si dotglob está habilitada. En otros casos, el carácter ‘.’ no es tratado de forma especial.

Al coincidir con un nombre de archivo, el carácter de barra debe ser siempre coincidido explícitamente por una barra en el patrón, pero en otros contextos de coincidencia puede ser coincidido por un carácter de patrón especial como se describe abajo (véase la sección Coincidencia de Patrones).

Consulte la descripción de shopt en La Instrucción Integrada Shopt, para una descripción de las opciones nocaseglob, nullglob, failglob y dotglob.

La variable del intérprete GLOBIGNORE puede ser usada para restringir el conjunto de nombres de archivo que coinciden con un patrón. Si GLOBIGNORE está establecida, cada nombre de archivo coincidente que también coincida con uno de los patrones en GLOBIGNORE es eliminado de la lista de coincidencias. Si la opción nocaseglob está habilitada, la coincidencia con el patrón en GLOBIGNORE se realiza sin importar las mayúsculas y minúsculas. Los nombres de archivo ‘.’ y ‘..’ siempre se ignoran cuando GLOBIGNORE está establecida y no es nula. Sin embargo, establecer GLOBIGNORE a un valor no nulo tiene el efecto de activar la opción del intérprete dotglob, para que todos los otros nombres de archivo que empiezan por ‘.’ coincidan. Para obtener el viejo comportamiento de ignorar los nombres de archivo que comienzan por ‘.’, haz ‘.*’ uno de los patrones en GLOBIGNORE. La opción dotglob se desabilita cuando GLOBIGNORE no está establecida.

3.5.8.1 Coincidencia de Patrones

Cualquier carácter que aparezca en un patrón, distinto a los caracteres de patrón especial descritos más abajo, coincide con sí mismo. El carácter NUL no puede ocurrir en un patrón. Una barra invertida escapa el siguiente carácter; la barra invertida de escape se descarta durante la coincidencia. Los caracteres de patrones especiales deben ser entrecomillados si no van a ser coincididos literalmente.

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

*

Coincide con cualquier cadena, incluida la cadena nula. Cuando está habilitada la opción globstar y se usa ‘*’ en un contexto de expansión de nombre de archivo, dos ‘*’ adyacentes usados como un patrón único coincidirán con todos los archivos y cero o más directorios y subdirectorios. Detrás de una ‘/’, dos ‘*’ adyacentes solo coincidirán con directorios y subdirectorios.

?

Coincide con un único carácter.

[…]

Coincide con cualquiera de los patrones incluidos. Una pareja de patrones separada por un guion denota una expresión de rango; cualquier carácter que se encuentre entre esos dos caracteres, inclusive, usando la secuencia de ordenación y el conjunto de caracteres de la configuración regional actual, es coincidido. Si el primer carácter que sigue al ‘[’ es un ‘!’ o un ‘^’, es coincidido cualquier carácter no incluido. Un ‘-’ puede ser coincidido incluyéndolo como el primer o último carácter en el conjunto. Un ‘]’ puede ser coincidido incluyéndolo como el primer carácter en el conjunto. El orden de ordenación de caracteres en las expresiones de rango se determina por la configuración regional actual y los valores de las variables del intérprete LC_COLLATE y LC_ALL, si están establecidas.

Por ejemplo, en la configuración regional predeterminada C, ‘[a-dx-z]’ es equivalente a ‘[abcdxyz]’. Muchas configuraciones regionales ordenan los caracteres en orden de diccionario, y en estas configuraciones regionales ‘[a-dx-z]’ no es normalmente equivalente a ‘[abcdxyz]’; podría ser equivalente a ‘[aBbCcDdxXyYz]’, por ejemplo. Para obtener la interpretación tradicional de rangos en las expresiones de llaves, puede forzar el uso de la configuración regional C estableciendo la variable de entorno LC_COLLATE o LC_ALL al valor ‘C’, o habilitar la opción del intérprete globasciiranges.

Dentro de ‘[’ y ‘]’, se pueden especificar clases de caracteres usando la sintaxis [:clase:], donde clase es una de las siguientes clases definidas en el estándar POSIX:

alnum alpha ascii blank cntrl digit graph lower print punct space upper word xdigit

Una clase de carácter coincide cualquier carácter que perteneciente a esa clase. La clase de carácter word coincide con letras, dígitos y el carácter ‘_’.

Dentro de ‘[’ y ‘]’, se puede especificar una clase de equivalencia usando la sintaxis [=c=], que coincide con todos los caracteres con el mismo peso de ordenación (según esté definido en la configuración regional actual) como el carácter c.

Dentro de ‘[’ y ‘]’, la sintaxis [.símbolo.] coincide con el símbolo de ordenación símbolo.

Si la opción del intérprete extglob se habilita usando la instrucción integrada shopt, se reconocen varios operadores de coincidencia de patrón extendido. En la siguiente descripción, una lista-de-patrones es una lista de uno o más patrones separados por un ‘|’. Se pueden formar patrones compuestos usando uno o más de los siguientes subpatrones:

?(lista-de-patrones)

Coincide con cero o una ocurrencia de los patrones dados.

*(lista-de-patrones)

Coincide con cero o más ocurrencias de los patrones dados.

+(lista-de-patrones)

Coincide con una o más ocurrencias de los patrones dados.

@(lista-de-patrones)

Coincide con uno de los patrones dados.

!(lista-de-patrones)

Coincide con cualquier cosa menos uno de los patrones dados.

Las coincidencias extendidas de patrón complicadas con cadenas largas es lenta, especialmente cuando los patrones contienen alteraciones y las cadenas contienen varias coincidencias. Usar coincidencias separadas sobre cadenas más cortas o usar vectores de cadenas en vez de una única cadena larga, puede ser más rápido.

3.5.9 Eliminación de Comillas

Después de las expansiones precedentes, todas las ocurrencias sin entrecomillar de los caracteres ‘\’, ‘'’ y ‘"’ que no se produjeron a partir de una de las expresiones anteriores son eliminadas.

3.6 Redirecciones

Antes de que se ejecute una instrucción, su entrada y su salida pueden ser redirigidas usando una notación especial interpretada por el intérprete. La redirección permite a manejadores de archivos de instrucciones ser duplicados, abiertos, cerrados, referidos a otros archivos, y puede cambiar los archivos de los que la instrucción lee y a los que escribe. La redirección también se puede usar para modificar los manejadores de archivos en el actual entorno de ejecución del intérprete. Los siguientes operadores de redirección pueden preceder o aparecer en cualquier lugar dentro de una instrucción simple o pueden seguir a una instrucción. Las redirecciones se procesan en el orden en que aparecen, de izquierda a derecha.

Cada redirección que pueda ser precedida por un número de descriptor de archivo puede ser precedida en su lugar por una palabra de la forma {nombre-de-var. En este caso, para cada operador de redirección excepto >&- y <&-, el intérprete destinará un descriptor de archivo mayor que 10 y lo asignará a {nombre-de-var. Si >&- o <&- es precedido por {nombre-de-var}, el valor de nombre-de-var define el descriptor de archivo que cerrar. Si se proporciona {nombre-de-var}, la redirección persiste más allá del alcance de la instrucción, permitiendo al programador del intérprete manejar el descriptor de archivo por su cuenta.

En las siguientes descripciones, si se omite el número del descriptor de archivo y el primer carácter del operador de redirección es ‘<’, la redirección hace referencia a la entrada estándar (descriptor de archivo 0). Si el primer carácter del operador de redirección es ‘>’, la redirección hace referencia a la salida estándar (descriptor de archivo 1).

La palabra que sigue al operador de redirección en las siguientes descripciones, a no ser que se indique lo contrario, está sujeta a la expansión de llaves, expansión de virgulilla, expansión de parámetros, sustitución de instrucciones, expansión aritmética, eliminación de comillas, expansión de nombre de archivo y división de palabras. Si se expande a más de una palabra, Bash informa de un error.

Observe que el orden de las redirecciones es importante. Por ejemplo, la instrucción

ls > lista-de-dir 2>&1

dirige tanto la salida estándar (descriptor de archivo 1) como el error estándar (descriptor de archivo 2) al archivo lista-de-dir, mientras que la instrucción

ls 2>&1 > lista-de-dir

dirige solo la salida estándar al archivo lista-de-dir, porque el error estándar fue convertido en una copia de la salida estándar antes de que la salida estándar fuera redirigida a lista-de-dir.

Bash maneja varios nombres de archivos de forma especial cuando son usados en redirecciones, como se describe en la siguiente tabla. Si el sistema operativo en que Bash se ejecuta proporciona estos archivos especiales, Bash los usará; en caso contrario, los emulará internamente con el comportamiento descrito a continuación.

/dev/fd/da

Si da es un entero válido, se duplica el descriptor de archivo da.

/dev/stdin

Se duplica el descriptor de archivo 0.

/dev/stdout

Se duplica el descriptor de archivo 1.

/dev/stderr

Se duplica el descriptor de archivo 2.

/dev/tcp/anfitrión/puerto

Si anfitrión es un nombre válido de anfitrión o dirección de Internet y puerto es un número entero de puerto o nombre de servicio, Bash trata de abrir el socket TCP correspondiente.

/dev/udp/anfitrión/puerto

Si anfitrión es un nombre válido de anfitrión o dirección de Internet y puerto es un número entero de puerto o nombre de servicio, Bash trata de abrir el socket UDP correspondiente.

Un fallo al crear o abrir un archivo hace que la redirección falle.

Las redirecciones usando descriptores de archivo mayores que 9 deberían ser usadas con cuidado, ya que pueden entrar en conflicto con descriptores de archivo que el intérprete usa internamente.

3.6.1 Redirigiendo Entrada

La redirección de entrada hace que los archivos cuyo nombre deriva de la expansión de palabra sean abiertos para lectura en el descriptor de archivo n, o la entrada estándar (descriptor de archivo 0) si n no está especificado.

El formato generar para redirigir una entrada es:

[n]<palabra

3.6.2 Redirigiendo Salida

La redirección de salida hace que el archivo cuyo nombre deriva de la expansión de palabra sea abierto para escritura en el descriptor de archivo n, o el error estándar (descriptor de archivo 1) si no se especifica n. Si el archivo no existe, se crea; si existe, es truncado a tamaño cero.

El formato general para redirigir una salida es:

[n]>[|]palabra

Si el operador de redirección es ‘>’ y la opción noclobber de la instrucción integrada set ha sido habilitada, la redirección fallará si el archivo cuyo nombre deriva de la expansión de palabra existe y es un archivo normal. Si el operador de redirección es ‘>|’ o si el operador de redirección es ‘>’ y no está habilitada la opción noclobber, la redirección se intenta incluso si el archivo nombrado por palabra existe.

3.6.3 Añadiendo Salida Redirigida

La redirección de salida de esta manera hace que el archivo cuyo nombre deriva de la expansión de palabra sea abierto para añadir en el descriptor de archivo n, o la salida estándar (descriptor de archivo 1), si no se especifica n. Si el archivo no existe, se crea.

El formato general para añadir una salida es:

[n]>>palabra

3.6.4 Redirigiendo Error Estándar y Salida Estándar

Esta construcción permite que sean redirigidas tanto la salida estándar (descriptor de archivo 1) como la salida de error estándar (descriptor de archivo 2) al archivo cuyo nombre es la expansión de palabra.

Hay dos formatos para redirigir error estándar y salida estándar:

&>palabra

y

>&palabra

De las dos formas, se prefiere la primera. Esto es equivalente semánticamente a

>palabra 2>&1

Al usar la segunda forma, puede que la palabra no se expanda a un número o a ‘-’. Si lo hace, se aplican otros operadores de redirección (véase Duplicando Descriptores de Archivo abajo) por razones de compatibilidad.

3.6.5 Añadiendo la Salida Estándar y el Error Estándar

Esta construcción permite que sean añadidas tanto la salida estándar (descriptor de archivo 1) como la salida de error estándar (descriptor de archivo 2) al archivo cuyo nombre es la expansión de palabra.

El formato para añadir la salida estándar y el error estándar es:

&>>palabra

Esto es equivalente semánticamente a

>>palabra 2>&1

(véase Duplicando Descriptores de Archivo abajo).

3.6.6 Documentos Aquí

Este tipo de redirección le ordena al intérprete leer la entrada de la fuente actual hasta que se encuentra una línea que contiene solo palabra (sin blancos al final). Todas las líneas leídas hasta ese punto son entonces usadas como la entrada estándar (o descriptor de archivo n si se especifica n) para una instrucción.

El formato del documento-aquí es:

[n]<<[-]palabra
        documento-aquí
delimitador

No se realiza expansión de parámetro y variable, sustitución de instrucción, expansión aritmética ni expansión de nombre de archivo en palabra. Si se entrecomilla alguna parte de palabra el delimitador es el resultado de la eliminación de comillas en palabra, y no se expanden las líneas en el documento-aquí. Si palabra no está entrecomillada, todas las líneas del documento aquí están sujetas a la expansión de parámetro, sustitución de instrucción y expansión aritmética, se ignora la secuencia de caracteres \nueva línea y ‘/’ se debe usar para mencionar los caracteres ‘\’, ‘$’ y ‘`’.

Si el operador de redirección es ‘<<-’, todos los caracteres de tabulación iniciales son eliminados de las líneas de entrada y la línea que contiene delimitador. Esto permite indentar documentos-aquí en guiones de forma natural.

3.6.7 Cadenas Aquí

Una variante de documentos aquí, el formato es:

[n]<<< palabra

La palabra experimenta la expansión de virgulilla, expansión de parámetro y variable, sustitución de instrucción, expansión aritmética y eliminación de comillas. No se realizan la expansión de nombre de ruta ni la división de palabras. El resultado es proporcionado como una cadena única, con una nueva línea añadida, a la instrucción en su entrada estándar (o descriptor de archivo n si se especifica).

3.6.8 Duplicando Descriptores de Archivo

El operador de redirección

[n]<&palabra

se usa para duplicar descriptores de archivo de entrada. Si palabra se expande a uno o más dígitos, el descriptor de archivo denotado por n se vuelve una copia de ese descriptor de archivo. Si los dígitos en palabra no especifican un descriptor de archivo abierto para entrada, ocurre un error de redirección. Si palabra se evalúa a ‘-’, se cierra el descriptor de archivo n. Si no se especifica n, se usa la entrada estándar (descriptor de archivo 0).

El operador

[n]>&palabra

se usa de forma parecida para duplicar la salida de descriptores de archivo. Si no se especifica n, se usa la salida estándar (descriptor de archivo 1). Si los dígitos en palabra no especifican un descriptor de archivo abierto para salida, ocurre un error de redirección. Si palabra se evalúa a ‘-’, se cierra el descriptor de archivo n. Como caso especial, si se omite n y palabra no se expande a uno o más dígitos o ‘-’, la salida estándar y el error estándar son redirigidos como se describió anteriormente.

3.6.9 Moviendo Descriptores de Archivo

El operador de redirección

[n]<&dígito-

mueve el descriptor de archivo dígito al descriptor de archivo n, o a la entrada estándar (descriptor de archivo 0) si no se especifica n. dígito se cierra tras ser duplicado a n.

De forma similar, el operador de redirección

[n]>&dígito-

mueve el descriptor de archivo dígito al descriptor de archivo n, o a la salida estándar (descriptor de archivo 1) si no se especifica n.

3.6.10 Abriendo Descriptores de Archivo para Leer y Escribir

El operador de redirección

[n]<>palabra

hace que el archivo cuyo nombre es la expansión de palabra sea abierto tanto para leer como para escribir en el descriptor de archivo n o en el descriptor de archivo 0 si no se especifica n. Si el archivo no existe, se crea.

3.7 Ejecutando Instrucciones

3.7.1 Expansión de Instrucciones Simples

Cuando se ejecuta una instrucción simple, el intérprete realiza las siguientes expansiones, asignaciones y redirecciones, de izquierda a derecha.

1. Las palabras que el analizador ha marcado como asignaciones de variables (aquellas que preceden al nombre de la instrucción) y redirecciones se guardan para su tratamiento posterior.
2. Las palabras que no son asignaciones de variable o redirecciones son expandidas (véase la sección Expansiones del Intérprete). Si alguna palabra permanece tras la expansión, la primera palabra se toma como el nombre de la instrucción y las demás palabras son los argumentos.
3. Las redirecciones se realizan como se describió anteriormente (véase la sección Redirecciones).
4. El texto después del ‘=’ en cada asignación de variable experimenta la expansión de virgulilla, expansión de parámetro, sustitución de instrucciones, expansión aritmética y eliminación de comillas antes de ser asignado a una variable.

Si no se produce un nombre de instrucción, las asignaciones de variables afectan al entorno actual del intérprete. De lo contrario, las variables son añadidas al entorno de la instrucción ejecutada y no afectan al entorno del intérprete actual. Si cualquiera de las asignaciones intenta asignar un valor a una variable de solo lectura, ocurre un error y la instrucción sale con un estado de error distinto a cero.

Si no se produce un nombre de instrucción, se realizan redirecciones, pero no afectan al entorno actual del intérprete. Un error de redirección hace que la instrucción se cierre con un estado distinto de cero.

Si hay un nombre de instrucción sobrante después de la expansión, la ejecución procede como se describe más adelante. De lo contrario, la instrucción finaliza. Si una de las expansiones contenía una sustitución de instrucción, el estado de salida de la instrucción es el estado de salida de la última sustitución de instrucción realizada. Si no había ninguna sustitución, la instrucción finaliza con un estado de cero.

3.7.2 Búsqueda y Ejecución de Instrucciones

Después de que una instrucción haya sido dividida en palabras, si resulta en una instrucción simple y una lista opcional de argumentos, se toman las siguientes acciones.

1. Si el nombre de la instrucción no contiene barras, el intérprete trata de localizarla. Si existe una función del intérprete con ese nombre, esa función se llama como se describe en Funciones del Intérprete.
2. Si el nombre no coincide con una función, el intérprete lo busca en la lista de instrucciones integradas del intérprete. Si se encuentra una coincidencia, se llama a esa instrucción integrada.
3. Si el nombre no es ni una función del intérprete ni una instrucción integrada y no contiene barras, Bash busca un directorio que contenga un archivo ejecutable con ese nombre en cada elemento de $PATH. Bash usa una tabla hash para recordar los nombres de ruta completos de archivos ejecutables para evitar múltiples búsquedas PATH (vea la descripción de hash en Instrucciones Integradas del Bourne Shell). Solo se realiza una búsqueda de los directorios en $PATH si la instrucción no se encontró en la tabla hash. Si la búsqueda es infructuosa, el intérprete busca una función del intérprete definida llamada command_not_found_handle. Si esa función existe, se llama en un entorno de ejecución separado con la instrucción original y los argumentos de la instrucción original como sus argumentos, y el estado de salida de la función se convierte en el estado de salida de ese subintérprete. Si no está definida esa función, el intérprete imprime un mensaje de error y devuelve un estado de salida de 127.
4. Si la búsqueda es exitosa o si el nombre de la instrucción contiene una o más barras, el intérprete ejecuta el programa nombrado en un entorno de ejecución aislado. El argumento 0 se establece al nombre dado, y el resto de argumentos para la instrucción se establecen a los argumentos proporcionados, si hay.
5. Si esta ejecución falló porque el archivo no está en formato ejecutable, y el archivo no es un directorio, se toma por un guion de intérprete y el intérprete lo ejecuta como se describe en Guiones del Intérprete.
6. Si la instrucción no fue iniciada asíncronamente, el intérprete espera a que la instrucción se complete y recoge su estado de salida.

3.7.3 Entorno de Ejecución de Instrucciones

El intérprete tiene un entorno de ejecución, que consta de lo siguiente:

• abre archivos heredados por el intérprete durante la llamada, como se modificaron por redirecciones proporcionadas a la instrucción integrada exec
• el directorio de trabajo actual como fue establecido por cd, pushd o popd, o heredado por el intérprete durante la llamada
• el modo de máscara de creación de archivo como fue establecido por umask o heredado del padre del intérprete
• traps actuales establecidas por trap
• parámetros del intérprete que son establecidos mediante asignación de variables o con set o heredados del padre del intérprete en el entorno
• funciones del intérprete definidas durante la ejecución o heredadas del padre del intérprete en el entorno
• opciones habilitadas en la llamada (o predeterminadas o con argumentos de línea de órdenes) o mediante set
• opciones habilitadas por shopt (véase la sección La Instrucción Integrada Shopt)
• aliases del intérprete definidos con alias (véase la sección Aliases)
• varios IDs de procesos, incluyendo aquellos de las tareas en segundo plano (véase la sección Listas de Instrucciones), el valor de $$ y el valor de $PPID

Cuando una instrucción simple distinta de una instrucción integrada o una función del intérprete va a ser ejecutada, es llamada en un entorno de ejecución aislado que consta de lo siguiente. A no ser que se indique lo contrario, los valores se heredan del intérprete.

• los archivos abiertos del intérprete, más las modificaciones y adiciones especificadas por redirecciones a la instrucción
• el directorio de trabajo actual
• el modo de la máscara de creación de archivos
• las variables y funciones del intérprete marcadas para exportar, junto a variables exportadas para la instrucción, pasadas en el entorno (véase la sección Entorno)
• las traps atrapadas por el intérprete son restablecidas a los valores heredados del padre del intérprete, y las traps ignoradas por el intérprete son ignoradas

Una instrucción llamada en este entorno aislado no puede afectar al entorno de ejecución del intérprete.

La sustitución de instrucciones, las instrucciones agrupadas con paréntesis y las instrucciones asíncronas son llamadas en un entorno de subintérprete que es una copia del entorno del intérprete, a excepción de que las traps atrapadas por el intérprete son restablecidas a los valores que el intérprete heredó de su padre durante la llamada. Las instrucciones integradas que son llamadas como parte de una tubería también son ejecutadas en un entorno de subintérprete. Los cambios hechos al entorno del subintérprete no pueden afectar al entorno de ejecución del intérprete.

Los subintérpretes generados para ejecutar sustituciones de instrucciones heredan el valor de la opción ‘-e’ del padre del intérprete. Cuando no está en modo POSIX, Bash borra la opción ‘-e’ en dichos subintérpretes.

Si una instrucción es seguida por un ‘&’ y no está activado el control de tareas, la entrada estándar para el instrucción es el archivo vacío ‘/dev/null’. De lo contrario, la instrucción llamada hereda los descriptores de archivo del intérprete ejecutor según se modifican mediante redirección.

3.7.4 Entorno

Cuando se llama un programa se le pasa un vector de cadenas llamado el entorno. Esto es una lista de pares nombre-valor, de la forma nombre=valor.

Bash proporciona varias formas de manipular el entorno. Durante la llamada, el intérprete escanea su propio entorno y crea un parámetro para cada nombre encontrado, automáticamente marcándolo para exportar a los procesos hijos. Las instrucciones ejecutadas heredan el entorno. Las instrucciones export y ‘declare -x’ permiten añadir y eliminar parámetros y funciones en el intérprete. Si se modifica el valor de un parámetro en el intérprete, el nuevo valor se vuelve parte del entorno, reemplazando al viejo. El entorno heredado por cualquier instrucción ejecutada consta del entorno inicial del intérprete, cuyos valores pueden ser modificados en el intérprete, menos las parejas eliminadas mediante las instrucciones unset y ‘export -n’, más las adiciones mediante las instrucciones export y ‘declare -x’.

El entorno para cualquier instrucción simple o función puede ser aumentado temporalmente prefijándolo con asignaciones de parámetros, como se describe en Parámetros del Intérprete. Estas sentencias de asignación afectan solo al entorno visto por esa instrucción.

Si está habilitada la opción ‘-k’ (véase la sección La Instrucción Integrada Set), todas las asignaciones de parámetros son ubicadas en el entorno para una instrucción, no solo aquellas que preceden al nombre de la instrucción.

Cuando Bash llama a una instrucción externa, la variable ‘$_’ es establecida al nombre de ruta completo de la instrucción y pasado a esa instrucción en su entorno.

3.7.5 Estado de Salida

El estado de salida de una instrucción ejecutada es el valor devuelto por la llamada de sistema waitpid o función equivalente. Los estados de salida se sitúan entre 0 y 255, sin embargo, como se explica a continuación, el intérprete puede usar los valores encima de 125 de forma especial. Los estados de salida de instrucciones integradas del intérprete y instrucciones compuestas también están limitadas a este rango. Bajo ciertas condiciones, el intérprete usará valores especiales para indicar modos de fallo específicos.

Para propósitos del intérprete, una instrucción que salga con un estado de salida de cero ha tenido éxito. Un estado de salida distinto de cero indica fallo. Este esquema aparentemente en contra del sentido común se usa para que haya un modo bien definido de indicar éxito y una variedad de formas de indicar varios modos de fallo. Cuando una instrucción termina con una señal fatal cuyo número es N, Bash usa el valor 128+N como el estado de salida.

Si no se encuentra una instrucción, el proceso hijo creado para ejecutarla devuelve un estado de 127. Si se encuentra una instrucción pero no es ejecutable, el estado de retorno es 126.

Si una instrucción falla a causa de un error durante la expansión o redirección, el estado de salida es mayor que cero.

El estado de salida es usado por las instrucciones condicionales de Bash (véase la sección Construcciones Condicionales) y algunas de las construcciones de listas (véase la sección Listas de Instrucciones).

Todas las instrucciones integradas de Bash devuelven un estado de salida de cero si tienen éxito y un estado de salida distinto de cero en caso de fallo, de forma que pueden ser usados por las construcciones condicionales y de listas. Todas las instrucciones integradas devuelven un estado de salida de 2 para indicar un uso incorrecto, generalmente opciones inválidas o argumentos que faltan.

3.7.6 Señales

Cuando Bash es interactivo, en ausencia de traps, ignora SIGTERM (de forma que ‘kill 0’ no mate un intérprete interactivo) y SIGINT se atrapa y se maneja (de forma que la instrucción integrada wait no se pueda interrumpir). Cuando Bash recive una SIGINT, sale de cualquier bucle que se ejecute. En todos los casos, Bash ignora SIGQUIT. Si está en efecto el control de tareas (véase la sección Control de Tareas), Bash ignora SIGTTIN, SIGTTOU y SIGTSTP.

Las instrucciones que no son integradas iniciadas por Bash tienen manejadores de señales establecidos a los valores heredados por el intérprete de su padre. Cuando no está en efecto el control de tareas, las instrucciones asíncronas ignoran SIGINT y SIGQUIT además de estos manejadores heredados. Las instrucciones ejecutadas como un resultado de la sustitución de instrucciones ignoran las señales de control de tareas generadas con el teclado SIGTTIN, SIGTTOU y SIGTSTP.

El intérprete se cierra por defecto al recibir un SIGHUP. Antes de cerrarse, un intérprete interactivo reenvía la SIGHUB a todas las tareas, en ejecución o detenidas. A las tareas detenidas se les envía SIGCONT para asegurarse de que reciben la SIGHUB. Para evitar que el intérprete envíe la señal SIGHUB a una tarea concreta, debería ser eliminada de la tabla de tareas con la instrucción integrada disown (véase la sección Instrucciones Integradas de Control de Tareas) o marcada para no recibir SIGHUB usando disown -h.

Si se ha habilitado la opción huponexit con shopt (véase la sección La Instrucción Integrada Shopt), Bash manda una SIGHUB a todas las tareas cuando se cierra un intérprete de acceso interactivo.

Si Bash está esperando a que una instrucción se complete y recibe una señal para la cual una trap ha sido establecida, el trap no será ejecutada hasta que la instrucción se complete. Cuando Bash está esperando a una instrucción asíncrona mediante la instrucción integrada wait, la recepción de una señal para la cual una trap ha sido establecida hará que la instrucción integrada wait retorne inmediatamente con un estado de salida mayor que 128, inmediatamente después se ejecuta la trap.

3.8 Guiones del Intérprete

Un guion del intérprete es un archivo de texto que contiene instrucciones del intérprete. Cuando se usa tal archivo como el primer argumento no opcional al llamar a Bash, y ni la opción ‘-c’ ni la ‘-s’ es proporcionada (véase la sección Llamando a Bash), Bash lee y ejecuta instrucciones del archivo, después se cierra. Este modo de operación crea un intérprete no interactivo. El intérprete busca primero el archivo en el directorio actual, y busca en los directorios en PATH si no es encontrado ahí.

Cuando Bash ejecuta un guion del intérprete, establece el parámetro especial 0 al nombre del archivo, en vez de al nombre del intérprete, y los argumentos restantes se asignan a los parámetros posicionales, si se pasa alguno. Si no se proporcionan argumentos adicionales, se eliminan los parámetros posicionales.

Un guion del intérprete puede hacerse ejecutable usando la instrucción chmod para activar el bit de ejecución. Cuando Bash encuentra tal archivo al buscar una instrucción en el $PATH, genera un subintérprete para ejecutarlo. En otras palabras, ejecutar

nombre-de-archivo argumentos

es equivalente a ejecutar

bash nombre-de-archivo argumentos

si nombre-de-archivo es un guion del intérprete ejecutable. Este subintérprete se reinicializa, para que el efecto sea como si un nuevo intérprete hubiera sido llamado para interpretar el guion, con la excepción de que las ubicaciones de las instrucciones recordadas por el padre (lea la descripción de hash en Instrucciones Integradas del Bourne Shell) son retenidas por el hijo.

La mayoría de versiones de Unix hacen esto parte del mecanismo de ejecución de instrucciones del sistema operativo. Si la primera línea del guion empieza por los dos caracteres ‘#!’, el resto de la línea especifica un intérprete para el programa. Así, puede especificar Bash, awk, Perl o cualquier otro intérprete y escribir el resto del archivo de guion en ese lenguaje.

Los argumentos para el intérprete constan de un único argumento opcional que sigue al nombre del intérprete en la primera línea del archivo de guion, seguido del nombre del archivo del guion, seguido del resto de argumentos. Bash realizará está acción en sistemas operativos que no la manejan por sí mismos. Tenga en cuenta que algunas versiones antiguas de Unix limitan el nombre y argumento del intérprete a un máximo de 32 caracteres.

Los guiones de Bash empiezan normalmente por #! /bin/bash (asumiendo que Bash ha sido instalado en ‘/bin’), ya que se asegura que Bash será usado para interpretar el guion, incluso si es ejecutado desde otro intérprete.

4. Instrucciones Integradas del Intérprete

Las instrucciones integradas están incluidas en el propio intérprete. Cuando el nombre de una instrucción integrada se usa como la primera palabra de una instrucción simple (véase la sección Instrucciones Simples), el intérprete ejecuta la orden directamente, sin invocar otro programa. Las instrucciones integradas son necesarias para implementar funcionalidad imposible o inconveniente de obtener con utilidades separadas.

Esta sección describe brevemente las instrucciones integradas que Bash hereda del Bourne Shell, así como las instrucciones integradas que son únicas o han sido extendidas en Bash.

En otros capítulos se describen varias instrucciones integradas: las instrucciones integradas que proporcionan la interfaz de Bash para las utilidades del control de tareas (véase la sección Instrucciones Integradas de Control de Tareas), la pila de directorio (véase la sección Instrucciones Integradas de la Pila de Directorios), el historial de instrucciones (véase la sección Instrucciones Integradas del Historial de Bash) y las utilidades de completado programables (véase la sección Instrucciones Integradas de Compleción Programable).

Muchas de las instrucciones integradas han sido extendidas por POSIX o Bash.

A no ser que se indique lo contrario, cada instrucción integrada documentada como que acepta opciones precedidas por ‘-’ acepta ‘--’ para indicar el fin de las opciones. Las instrucciones integradas :, true, false y test / [ no aceptan opciones y no tratan ‘--’ de forma especial. Las instrucciones integradas exit, logout, return, break, continue, let y shift aceptan y procesan argumentos que empiezan con ‘-’ sin requerir ‘--’. Otras instrucciones integradas que aceptan argumentos pero no especifican que aceptan opciones, interpretan argumentos que empiezan con ‘-’ como opciones inválidas y requieren ‘--’ para evitar esta interpretación.

4.1 Instrucciones Integradas del Bourne Shell

Las siguientes instrucciones integradas del intérprete son heredadas del Bourne Shell. Estas órdenes se implementan como está especificado en el estándar POSIX.

: (dos puntos)

: [argumentos]

No hace nada más allá de expandir argumentos y realizar redirecciones. El estado de retorno es cero.

. (un punto)

. nombre-de-archivo [argumentos]

Lee y ejecuta instrucciones del argumento nombre-de-archivo en el actual contexto del intérprete. Si nombre-de-archivo no contiene una barra, la variable PATH se usa para encontrar nombre-de-archivo. Cuando Bash no está en modo POSIX, se explora el directorio actual si nombrearchivo no se encuentra en PATH. Si se pasan argumentos, se convierten en los argumentos posicionales cuando se ejecuta nombre-de-archivo. De modo contrario, los argumentos posicionales no se cambian. Si la opción ‘-T’ está habilitada, source hereda cualquier trap en DEBUG; si no, cualquier cadena de DEBUG trap se guarda y se restaura alrededor de la llamada a source, y source elimina la trap DEBUG mientras se ejecuta. Si ‘-T’ no está establecido, y el archivo leído cambia el trap DEBUG, el nuevo valor se almacena cuando source termina. El estado de retorno es el estado de salida de la última instrucción ejecutada, o cero si no se ejecuta ninguna orden. Si no se encuentra nombre-de-archivo, o no se puede leer, el estado de retorno es diferente de cero. Esta instrucción integrada es equivalente a source.

break

break [n]

Sale de un bucle for, while, until o select. Si se proporciona n, se sale del nivel n de anidación del bucle. n debe ser mayor o igual a 1. El estado de salida es cero a no ser que n no sea mayor o igual a 1.

cd

cd [-L|[-P [-e]] [-@] [directorio]

Cambia el actual directorio de trabajo a directorio. Si no se proporciona directorio, se usa el valor de la variable del intérprete HOME. Cualquier argumento adicional que siga a directorio es ignorado. Si la variable de intérprete CDPATH existe, es usada como ruta de búsqueda: en cada nombre de directorio de CDPATH se busca directorio, con los nombres alternativos de directorios en CDPATH separados por dos puntos (‘:’). Si directorio empieza por una barra, CDPATH no se usa.

La opción ‘-P’ significa que no sigue los enlaces simbólicos: los enlaces simbólicos son resueltos mientras cd está recorriendo directorio y antes de procesar una instancia de ‘..’ en directorio.

Por defecto, o cuando se proporciona la opción ‘-L’, los enlaces simbólicos en directorio son resueltos después de que cd procesa una instancia de ‘..’ en directorio.

Si ‘..’ aparece en directorio, se procesa eliminando el componente de nombre de ruta que le precede inmediatamente, de vuelta a una barra o al inicio de directorio.

Si la opción ‘-e’ es proporcionada junto a ‘-P’ y el directorio de trabajo actual no se puede determinar con éxito después de un exitoso cambio de directorio, cd revolverá un estado de retorno no exitoso.

En sistemas que lo soportan, la opción ‘-@’ presenta los atributos extendidos asociados a un archivo como directorio.

Si directorio es ‘-’, este se convierte en $OLDPWD antes de que se intente el cambio de directorio.

Si se usa un nombre de directorio de CDPATH no vacío o si ‘-’ es el primer argumento y el cambio de directorio es exitoso, el nombre de ruta absoluto del nuevo directorio de trabajo se escribe a la salida estándar.

El código de retorno es cero si el directorio es cambiado exitosamente, distinto de cero de no ser así.

continue

continue [n]

Reanuda la siguiente iteración de un bucle for, while, until o select que lo contiene. Si se proporciona n, reanuda la ejecución del bucle de nivel de anidamiento n que lo contiene. n debe ser mayor o igual a 1. El código de retorno es cero a no ser que n no sea mayor o igual a 1.

eval

eval [arguments]

Los argumentos son concatenados juntos en una única instrucción, que entonces es leída y ejecutada, y su estado de salida devuelto como el estado de salida de eval. Si no hay argumentos o solo argumentos vacíos, el estado de retorno es cero.

exec

exec [-cl] [-a nombre] [instrucción [argumentos]]

Si se proporciona instrucció, reemplaza el intérprete sin crear un nuevo proceso. Si se proporciona la opción ‘-l’, el intérprete pone una barra al comienzo del argumento número cero pasado a instrucción. Esto es lo que hace el programa login. La opción ‘-c’ hace que instrucción sea ejecutada con un entorno vacío. Si se proporciona ‘-a’, el intérprete pasa nombre como el argumento número cero a instrucción. Si por alguna razón no se puede ejecutar instrucción, se cierra un intérprete no interactivo, a no ser que esté habilitada la opción del intérprete execfail. En ese caso devuelve fallo. Un intérprete interactivo devuelve fallo si el archivo no puede ser ejecutado. Un subintérprete finaliza de forma incondicional si exec falla. Si no se especifica ninguna instrucción, se pueden usar redirecciones para afectar al entorno actual del intérprete. Si no hay errores de redirección, el estado de retorno es cero; de lo contrario, el estado de retorno es distinto a cero.

exit

exit [n]

Sale del intérprete, devolviendo un estado de n al padre del intérprete. Si se omite n, el estado de salida es el mismo de la última orden ejecutada. Cualquier trap en EXIT se ejecuta antes de que el intérprete termine.

export

export [-fn] [-p] [nombre[=valor]]

Marca cada nombre para que sea pasado a los procesos hijos en el entorno. Si se proporciona la opción ‘-f’, los nombres se refieren a funciones del intérprete; de lo contrario, los nombres se refieren a variables del intérprete. La opción ‘-n’ equivale a dejar de marcar cada nombre para exportación. Si no se proporcionan nombres, o si se pasa la opción ‘-p’, se muestra una lista de nombres de todas las variables exportadas. La opción ‘-p’ muestra la salida en una forma que puede ser reusada como entrada. Si a un nombre de variable sigue =valor, el valor de la variable se establece a valor.

El estado de retorno es cero a no ser que se proporcione una opción inválida, uno de los nombres no sea un nombre de variable de intérprete válido o se proporcione ‘-f’ con un nombre que no sea una función del intérprete.

getopts

getopts cadenaopc nombre [args]

getopts se usa por los guiones del intérprete para analizar parámetros posicionales. cadenaopc contiene los caracteres de opción que serán reconocidos; si a un carácter le siguen dos puntos, se espera que la opción tenga un argumento, que debería estar separado de ese por un espacio. Los dos puntos (‘:’) y el símbolo de interrogación (‘?’) no pueden ser usados como caracteres de opción. Cada vez que se invoca, getopts ubica la siguiente opción en la variable de intérprete nombre, inicializando nombre si no existe, y el índice del siguiente argumento a ser procesado en la variable OPTIND. OPTIND es inicializado a 1 cada vez que el intérprete o un guion de intérprete es invocado. Cuando una opción requiere un parámetro, getopts ubica ese argumento en la variable OPTARG. El intérprete no elimina OPTIND automáticamente; tiene que ser eliminado manualmente entre múltiples llamadas a getopts dentro de la misma invocación del intérprete si se pretende usar un nuevo conjunto de parámetros.

Cuando se encuentra el fin de las opciones, getopts sale con un valor de retorno mayor que cero. Se establece OPTIND al índice del primer argumento que no sea una opción y nombre se establece a ‘?’.

getopts normalmente analiza los parámetros posicionales, pero si se pasan más argumentos en args, getopts analiza esos en su lugar.

getopts puede informar de errores de dos formas. Si el primer carácter de cadenaopc es dos puntos, se usa el aviso de errores silencioso. En funcionamiento normal, los mensajes de diagnóstico se imprimen cuando se encuentran opciones inválidas o argumentos de opción que faltan. Si se establece la variable OPTERR a 0, no se mostrarán mensajes de error, incluso si el primer carácter de cadenaopc no es dos puntos.

Si se detecta una opción inválida, getopts guarda ‘?’ en nombre y, si no es silencioso, imprime un mensaje de error y elimina OPTARG. Si getopts es silencioso, el carácter de opción encontrado se guarda en OPTARG y no se muestra ningún mensaje de diagnóstico.

Si no se encuentra un argumento requerido, y getopts no es silencioso, se guarda un símbolo de interrogación (‘?’) en nombre, OPTARG se elimina, y se imprime un mensaje de diagnóstico. Si getopts es silencioso, se guardan dos puntos (‘:’) en nombre y OPTARG se establece al carácter de opción encontrado.

hash

hash [-r] [-p nombre-de-archivo] [-dt] [nombre]

Cada vez que se invoca hash, recuerda los nombres de ruta completos de las órdenes especificadas como argumentos nombre, de forma que no deben ser buscados en las próximas invocaciones. Las instrucciones se encuentran buscando a través de los directorios listados en $PATH. Cualquier nombre de ruta recordado previamente es descartado. La opción ‘-p’ inhibe la búsqueda por ruta, y nombre-de-archivo se usa como la ubicación de nombre. La opción ‘-r’ hace que el intérprete se olvide de todas las ubicaciones recordadas. La opción ‘-d’ hace que el intérprete se olvide de la ubicación recordada de cada nombre. Si se proporciona la opción ‘-t’, se imprime el nombre de ruta completo al que corresponde cada nombre. Si se proporcionan múltiples argumentos nombre con ‘-t’, el nombre se imprime antes del nombre ruta completo hecho hash. La opción ‘-l’ hace que la salida se muestre en un formato que puede ser reutilizado como entrada. Si no se pasan argumentos, o si solo se proporciona ‘-l’, se imprime información sobre instrucciones recordadas. El estado de retorno es cero a no ser que nombre no se encuentre o se proporcione una opción inválida.

pwd

pwd [-LP]

Imprime el nombre de ruta absoluto del actual directorio de trabajo. Si se proporciona la opción ‘-P’, el nombre de ruta imprimido no contendrá enlaces simbólicos. Si se proporciona la opción ‘-L’, el nombre de ruta impreso puede contener enlaces simbólicos. El estado de retorno es cero a no ser que se produzca un error mientras se determina el nombre del directorio actual o se proporcione una opción inválida.

readonly

readonly [-aAf] [-p] [nombre[=valor]] …

Marca cada nombre como de solo lectura. Los valores de estos nombres no pueden ser cambiados en asignaciones posteriores. Si se proporciona la opción ‘-f’, cada nombre se refiere a una función del intérprete. La opción ‘-a’ significa que cada nombre se refiere a una variable del tipo vector indexado; la opción ‘-A’ significa que cada nombre se refiere a una variable del tipo vector asociativo. Si se proporcionan ambas opciones, ‘-A’ tiene precedencia. Si no se pasan argumentos nombre, o si se proporciona la opción ‘-p’, se imprime una lista de todos los nombres de solo lectura. Las otras opciones pueden ser usadas para restringir la salida a un subconjunto de los nombres de solo lectura. La opción ‘-p’ hace que la salida sea mostrada en un formato que puede ser reutilizado como entrada. Si nombre de variable está seguido de =valor, el valor de la variable se establece a valor. El estado de retorno es cero a no ser que se proporcione una opción inválida, uno de los argumentos nombre no sea un nombre válido de variable de intérprete o de función o la opción ‘-f’ se proporcione con un nombre que no sea una función del intérprete.

return

return [n]

Hace que una función del intérprete se deje de ejecutar y devuelva el valor n a su ejecutor. Si no se proporciona n, el valor de retorno es el estado de salida de la última instrucción ejecutada en la función. Si return es ejecutado por un manejador trap, la última instrucción usada para determinar el estado es la última instrucción ejecutada antes del manejador trap. Si se ejecuta return durante una trap del tipo DEBUG, la última instruccion usada para determinar el estado es la última instrucción ejecutada por el manejador trap antes de que return fuera invocado. return puede ser usado también para terminar la ejecución de un guion que está siendo ejecutado con la función integrada . (source), devolviendo o n o el estado de salida de la última instrucción ejecutada dentro del guion como el estado de salida del guion. Si se proporciona n, el valor de retorno es sus 8 bits menos significativos. Cualquier instrucción asociada a la trap RETURN es ejecutada antes de que se reanude la ejecución tras la función o el guion. El estado de retorno es distinto a cero si return es proporcionado como un argumento no número o es usado fuera de una función y no durante la ejecución de un guion por . o source.

shift

shift [n]

Mueve los argumentos posicionales a la izquierda por n. Los argumentos posicionales de n+1 … $# son renombrados a $1 … $#-n. Los argumentos representados por los números $# a $#-n+1 son eliminados. n tiene que ser un número no negativo menor o igual a $#. Si n es cero o mayor que $#, los argumentos posicionales no se cambian. Si no se proporciona n, se asume que es 1. El código de retorno es cero a no ser que n sea mayor que $# o menor que cero, distinto de cero de no ser así.

test

[

test expr

Evalúa una expresión condicional expr y devuelve un estado de 0 (verdadero) o 1 (falso). Cada operador y operando debe ser un argumento separado. Las expresiones están compuestas de las opciones primarias descritas más abajo en Expresiones Condicionales de Bash. test no acepta ninguna opción, tampoco acepta e ignora un argumento de ‘--’ como el significado del fin de las opciones.

Cuando se usa la forma [, el último argumento de la instrucción debe ser un ].

Las expresiones pueden ser combinadas usando los siguientes operadores, listados en orden descendente de precedencia. La evaluación depende del número de argumentos; consulta más abajo. La precedencia de operador se usa cuando hay cinco o más argumentos.

! expr

Verdadero si expr es falso.

( expr )

Devuelve el valor de expr. Esto puede ser usado para sobreescribir la precedencia normal de operadores.

expr1 -a expr2

Verdadero si tanto expr1 y expr2 son verdadero.

expr1 -o expr2

Verdadero si expr1 o expr2 es verdadero.

Las instrucciones internas test y [ evalúan expresiones condicionales usando un conjunto de reglas basado en el número de argumentos.

0 argumentos

La expresión es falsa.

1 argumento

La expresión es verdadera solo si el argumento no es nulo.

2 argumentos

Si el primer argumento es ‘!’, la expresión es verdadera solamente si el segundo argumento es nulo. Si el primer argumento es uno de los operadores condicionales unarios (véase la sección Expresiones Condicionales de Bash), la expresión es verdadera si la comprobación unaria es verdadera. Si el primer argumento no es un operador unario válido, la expresión es falsa.

3 argumentos

Las siguientes condiciones se aplican en el orden listado.

1. Si el segundo argumento es alguno de los operadores binarios condicionales (véase la sección Expresiones Condicionales de Bash), el resultado de la expresión es el resultado de la comprobación binaria que usa el primer argumento y el tercero como operadores. Los operadores ‘-a’ y ‘-o’ son considerados operadores binarios cuando hay tres argumentos.
2. Si el primer argumento es ‘!’, el valor es la negación de la comprobación de dos argumentos usando el segundo argumento y el tercero.
3. Si el primer argumento es exactamente ‘(’ y el tercer argumento es exactamente ‘)’, el resultado es la comprobación de un argumento del segundo argumento.
4. De lo contrario, la expresión es falsa.

4 argumentos

Si el primer argumento es ‘!’, el resultado es la negación de la expresión de tres argumentos compuesta de los argumentos restantes. De lo contrario, la expresión es analizada y evaluada según la precedencia usando las reglas listadas anteriormente.

5 o más argumentos

La expresión es analizada y evaluada según la precedencia usando las reglas listadas anteriormente.

Cuando se usa con test o ‘[’, los operadores ‘<’ y ‘>’ ordenan lexicográficamente usando el orden ASCII.

times

times

Imprime los tiempos de usuario y de sistema usados por el intérprete y sus hijos. El estado de retorno es cero.

trap

trap [-lp] [arg] [id_señal …]

Las instrucciones en arg están pensadas para ser leídas y ejecutadas cuando el intérprete recibe la señal id_señal. Si falta parám (y hay una señal id_señal) o es igual a ‘-’, cada disposición de señal especificada es restablecida al valor que tenía cuando el intérprete fue iniciado. Si arg es la cadena nula, se ignora la señal especificada por cada id_señal y las instrucciones que ejecuta. Si arg no está presente y ‘-p’ ha sido proporcionado, el intérprete muestra las instrucciones trap asociadas con cada id_señal. Si no se proporcionan argumentos, o solo se proporciona ‘-p’, trap imprime la lista de instrucciones asociadas con cada número de señal en una forma que puede ser reusada como entrada para el intérprete. La opción ‘-l’ hace que el intérprete imprima una lista de nombres de señales y sus números correspondientes. Cada id_señal es o bien un nombre de señal o un número de señal. Los nombres de señales no distinguen entre mayúsculas y minúsculas y el prefijo SIG es opcional.

Si una id_señal es 0 o EXIT, arg se ejecuta cuando el intérprete se cierra. Si un id_señal es DEBUG, se ejecuta la instrucción arg antes de cada instrucción simple, instrucción for, instrucción case, instrucción select, cada instrucción for aritmética y antes de que se ejecute la primera instrucción en una función del intérprete. Consulte la descripción de la opción extdebug de la instrucción integrada shopt (véase la sección La Instrucción Integrada Shopt) para encontrar detalles de su efecto sobre la trap DEBUG. Si un id_señal es RETURN, la instrucción arg se ejecuta cada vez que una instrucción del intérprete o un guion ejecutado con las instrucciones integradas . o source terminan de ejecutarse.

Si el sigspec es ERR, la instrucción arg se ejecuta cada vez que una tubería (que puede consistir de una única instrucción simple), una lista o una instrucción compuesta devuelve un estado diferente de cero, de acuerdo a las siguientes condiciones. El trap ERR no es ejecutado si la instrucción fallida es parte de la lista de instrucciones inmediatamente después de una palabra clave until o while, parte de la condición que sigue a las palabras reservadas if o elif, parte de una instrucción ejecutada en una lista && o || excepto la instrucción que sigue al último && o ||, cualquier instrucción en una tubería excepto la última o si el estado de retorno de la instrucción está siendo invertido usando !. Estas son las mismas condiciones cumplidas por la opción errexit (‘-e’).

Las señales ignoradas en la entrada al intérprete no pueden ser atrapadas o eliminadas. Las señales atrapadas que no están siendo ignoradas son restablecidas a sus valores originales en un subintérprete o un entorno de subintérprete cuando se crea una.

El estado de retorno es cero a no ser que sigspec no especifique una señal válida.

umask

umask [-p] [-S] [modo]

Establece el proceso del intérprete de la máscara de creación de archivos a modo. Si modo comienza por un dígito, es interpretado como un número octal; si no, es interpretado como una máscara de modo simbólico similar a la aceptada por la instrucción chmod. Si se omite modo, se imprime el valor actual de la máscara. Si se proporciona la opción ‘-S’ sin un argumento modo, la máscara se imprime en un formato simbólico. Si se proporciona la opción ‘-p’, y se omite modo, la salida es de forma que puede reusarse como entrada. El estado de retorno es cero si el modo se cambia exitosamente o si no se proporciona un argumento modo, y distinto a cero de no ser así.

Ten en cuenta que cuando el modo es interpretado como un número octal, cada número de umask es restado de 7. Así, un umask de 022 resulta en permisos de 755.

unset

unset [-fnv] [nombre]

Elimina cada variable o función nombre. Si se pasa la opción ‘-v’, cada nombre se refiere a una variable del intérprete, y esa variable se elimina. Si se pasa la opción ‘-f’, los nombres se refieren a funciones del intérprete, y se elimina la definición de la función. Si se proporciona la opción ‘-n’, y nombre es una variable con el atributo nameref, nombre se eliminará en vez de la variable a la que hace referencia. ‘-n’ no tiene efecto si se proporciona la opción ‘-f’. Si no se proporcionan opciones, cada nombre se refiere a una variable; si no haya variable con ese nombre, cualquier función con ese nombre se elimina. Las variables y funciones de solo lectura no pueden ser eliminadas. El estado de retorno es cero a no ser que nombre sea de solo lectura.

4.2 Instrucciones Integradas de Bash

Esta sección describe las instrucciones integradas que son únicas de o han sido extendidas en Bash. Algunas de estas instrucciones son especificadas en el estándar POSIX.

alias

alias [-p] [nombre[=valor] …]

Sin argumentos o con la opción ‘-p’, alias imprime la lista de aliases en la salida estándar en una forma que permite que sean reutilizados como entrada. Si se proporcionan argumentos, se define un alias por cada nombre cuyo valor sea especificado. Si no se pasa un valor, se imprime el nombre y el valor del alias. Los aliases se describen en Aliases

bind

bind [-m mapa-de-teclas] [-lpsvPSVX] bind [-m mapa-de-teclas] [-q función] [-u función] [-r secuencia-de-teclas] bind [-m mapa-de-teclas] -f nombre-archivo bind [-m mapa-de-teclas] -x secuencia-de-teclas:instrucción-de-intérprete bind [-m mapa-de-teclas] secuencia-de-teclas:nombre-función bind [-m mapa-de-teclas] secuencia-de-teclas:instrucción-readline

Muestra las asociaciones actuales de teclas y funciones Readline (véase la sección Edición en Línea de Órdenes), asocia una secuencia de teclas a una función o macro de Readline o establece una variable de Readline. Cada argumento que no es una opción es una instrucción tal como aparecería en un archivo de inicialización de Readline (véase la sección Archivo de Inicialización de Readline), pero cada asociación o instrucción tiene que ser pasada como un argumento independiente; p. ej., ‘"\C-x\C-r":re-read-init-file’.

La opciones, si se proporcionan, tienen los siguientes significados:

-m mapa-de-teclas

Usa mapa-de-teclas como el mapa de teclas afectado por las siguientes asociaciones. Son nombres aceptables de mapa-de-teclas emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-move, vi-command y vi-insert. vi es equivalente a vi-command (vi-move es también un sinónimo); emacs es equivalente a emacs-standard.

-l

Lista los nombres de todas las funciones de Readline.

-p

Muestra los nombres de las funciones y asociaciones de Readline de manera que puedan ser usadas como entrada o en una archivo de inicialización de Readline.

-P

Lista los nombres de funciones y las asociaciones de Readline.

-v

Muestra los nombres de variable y valores de Readline de una manera que puedan ser usados como entrada o en un archivo de inicialización de Readline.

-V

Lista los nombres de variable y los valores actuales de Readline.

-s

Muestra la secuencia de caracteres de Readline asociada a macros y las cadenas que producen de manera que pueda ser usada como entrada o en un archivo de inicialización Readline.

-S

Muestra las secuencias de teclas de Readline asociadas a macros y las cadenas que producen.

-f nombre-de-archivo

Lee asociaciones de teclas de nombre-de-archivo

-q función

Consulta sobre las teclas que llaman a la función nombrada.

-u función

Desasocia todas las teclas asociadas a la función nombrada.

-r secuencia-de-teclas

Elimina cualquier asociación actual para secuencia-de-teclas

-x secuencia-de-teclas:instrucción-intérprete

Hace que se ejecute instrucción-intérprete cada vez que se introduzca secuencia-de-teclas. Cuando se ejecuta instrucción-intérprete, el intérprete establece la variable READLINE_LINE al contenido del búfer y la variable READLINE_POINT a la ubicación actual del punto de inserción. Si la instrucción ejecutada cambia el valor de READLINE_LINE o READLINE_POINT, se reflejarán esos nuevos valores en el estado de edición.

-X

Lista todas las secuencias de teclas asociadas a instrucciones del intérprete y las instrucciones asociadas en un formato que puede ser reutilizado como entrada.

El estado de retorno es cero a no ser que se proporcione una opción inválida u ocurra un error.

instrucción integrada

builtin [instrucción-integrada [paráms]]

Ejecuta una instrucción integrada, pasándole paráms, y devuelve su estado de salida. Esto es útil cuando se define una función del intérprete con el mismo nombre que una función integrada del intérprete, conservando la funcionalidad de la instrucción integrada dentro de la función. El estado de retorno es distinto de cero si instrucción-integrada no es una instrucción integrada del intérprete.

caller

caller [expr]

Devuelve el contexto de cualquier llamada a una subrutina activa (una instrucción del intérprete o un guion ejecutado con las instrucciones integradas . o source).

Sin expr, caller muestra el número de línea y el nombre de archivo fuente de la actual llamada de subrutina. Si se proporciona un entero negativo como expr, caller muestra el número de línea, el nombre de subrutina y el archivo fuente correspondiente a esa posición en la actual pila de llamadas de ejecución. Esta información extra puede ser usada, por ejemplo, para imprimir un volcado de pila. El marco actual es el marco 0.

El valor de retorno es 0 a no ser que el intérprete no esté ejecutando una llamada de subrutina o expr no corresponda a una posición válida en la pila de llamadas.

command

command [-pVv] instrucción [argumentos …]

Ejecuta instrucción con argumentos ignorando cualquier instrucción del intérprete llamada instrucción. Solo se ejecutan las instrucciones integradas del intérprete o las instrucciones encontradas al inspeccionar el PATH. Si hay una instrucción del intérprete llamada ls, ejecutar ‘command ls’ dentro de la función ejecutará la instrucción externa ls en vez de llamar a la función recursivamente. La opción ‘-p’ equivale a usar un valor por defecto para PATH que garantiza encontrar todas las utilidades estándares. El estado de retorno en este caso es 127 si no se puede encontrar instrucción u ocurrió un error, y el estado de salida de instrucción en caso contrario.

Si se proporciona la opción ‘-V’ o la ‘-v’, se imprime una descripción de instrucción. La opción ‘-v’ hace que se muestre una única palabra indicando el nombre de la instrucción o archivo utilizado para llamar a instrucción; la opción ‘-V’ produce una descripción más extensa. En este caso, el estado de retorno es cero si instrucción es encontrada, y distinto a cero en si no.

declare

declare [-aAfFgilnrtux] [-p] [nombre[=valor] …]

Declara variables y les da atributos. Si no se pasan nombres, entonces muestra los valores de las variables en su lugar.

La opción ‘-p’ mostrará los atributos y valores de cada nombre. Cuando se usa la opción ‘-p’ con argumentos nombre, se ignoran opciones adicionales, excepto ‘-f’ y ‘-F’.

Cuando se proporciona ‘-p’ sin argumentos nombre, declare mostrará los atributos y valores de todas las variables con los atributos especificados por las opciones adicionales. Si no se proporcionan otras opciones con ‘-p’, declare mostrará los atributos y valores de todas las variables del intérprete. La opción ‘-f’ restringirá la salida a funciones del intérprete.

La opción ‘-F’ inhibe la salida de las definiciones de funciones; solo se imprimen el nombre de función y los atributos. Si se habilita la opción del intérprete extdebug usando shopt (véase la sección La Instrucción Integrada Shopt), se muestra también el archivo fuente y el número de línea donde cada nombre está definido. ‘-F’ supone ‘-f’.

La opción ‘-g’ obliga a que las variables sean creadas o modificadas en el alcance global, incluso cuando declare es ejecutado en una función del intérprete. Es ignorada en todos los demás casos.

Las siguientes opciones pueden ser usadas para restringir la salida a variables con los atributos especificados o para dar a las variables atributos:

-a

Cada nombre es una variable de vector indexado (véase la sección Vectores).

-A

Cada nombre es una variable de vector asociativo (véase la sección Vectores).

-f

Usa solo nombres de función.

-i

La variable será tratada como un entero; la evaluación aritmética (véase la sección Aritmética del Intérprete) se realiza cuando se asigna un valor a la variable.

-l

Cuando se le asigna un valor a la variable, todos los caracteres en mayúscula son convertidos a minúscula. El atributo upper-case es deshabilitado.

-n

Da a cada nombre el atributo nameref, convirtiéndolo en una referencia de nombre a otra variable. Esa otra variable está definida por el valor de nombre. Todas las referencias, asignaciones y modificaciones de atributo a nombre, excepto para aquellas que usan o cambian el mismo atributo ‘-n’, son realizadas en la variable referenciada por el valor nombre. El atributo nameref no puede ser aplicado a variables de vector.

-r

Hace que nombres sean de solo lectura. Después no se pueden asignar valores a estos nombres usando sentencias de asignación o eliminación.

-t

Da a cada nombre el atributo trace. Las funciones rastreadas heredan las traps DEBUG y RETURN del intérprete ejecutor. El atributo trace no tiene ningún significado especial para variables.

-u

Cuando se asigna un valor a una variable, todos los caracteres en minúscula son convertidos a mayúscula. El atributo lower-case es deshabilitado.

-x

Marca cada nombre para exportar a posteriores instrucciones mediante el entorno.

Usar ‘+’ en vez de ‘-’ desactiva el atributo, con las excepciones de que ‘+a’ y ‘+A’ no pueden ser usados para destruir variables de vector y ‘+r’ no eliminará el atributo readonly. Cuando se usa en una función, declare hace cada nombre local, como con la instrucción local, a no ser que se use la opción ‘-g’. Si un nombre de variable es seguido de =valor, se establece el valor de la variable a valor.

Cuando se usa ‘-a’ o ‘-A’ y la sintaxis de asignación compuesta para crear variables de vector, los atributos adicionales no tienen efecto hasta siguientes asignaciones.

El estado de retorno es cero a no ser que se encuentre una opción inválida, se realice un intento para definir una función usando ‘-f foo=bar’, se realice un intento de asignar un valor a una variable de solo lectura, se realice un intento de asignar un valor a una variable de vector sin usar la sintaxis de asignaciones compuestas (véase la sección Vectores), uno de los nombres no sea un nombre de variable de intérprete válido, se realice un intento de desactivar el estado de solo lectura de una variable de solo lectura, se realice un intento de desactivar el estado de vector de una variable de vector o se realice un intento para mostrar una función inexistente con ‘-f’.

echo

echo [-neE] [arg …]

Muestra los args, separados por espacios, terminado en una nueva línea. El estado de retorno es 0 a no ser que ocurra un error de escritura. Si se especifica ‘-n’, la nueva línea adicional se suprime. Si se pasa la opción ‘-e’, se habilita la interpretación de los siguientes caracteres escapados por barras invertidas. La opción ‘-E’ deshabilita la interpretación de estos caracteres de escape, incluso en sistemas en los que son interpretados por defecto. La opción del intérprete xpg_echo puede ser usada para determinar dinámicamente si echo expande estos caracteres de escape por defecto o no. echo no interpreta ‘--’ para indicar el final de las opciones.

echo interpreta las siguientes secuencias de escape:

\a

alerta (timbre)

\b

retroceso

\c

suprime salida adicional

\e

\E

escape

\f

salto de página

\n

nueva línea

\r

retorno de carro

\t

tabulación horizontal

\v

tabulación vertical

\\

barra invertida

\0nnn

el carácter de ocho bits cuyo valor es el valor octal nnn (de cero a tres dígitos octales).

\xHH

el carácter de ocho bits cuyo valor es el valor hexadecimal HH (uno o dos dígitos hexadecimales)

\uHHHH

el carácter Unicode (ISO/IEC 10646) cuyo valor es el valor hexadecimal HHHH (de uno a cuatro dígitos hexadecimales)

\UHHHHHHHH

el carácter Unicode (ISO/IEC 10646) cuyo valor es el valor hexadecimal HHHHHHHH (de uno a ocho dígitos hexadecimales)

enable

enable [-a] [-dnps] [-f nombre-de-archivo] [nombre …]

Habilita y deshabilita instrucciones integradas del intérprete. Deshabilitar una instrucción integrada permite que una instrucción del disco que tiene el mismo nombre que una instrucción integrada del intérprete sea ejecutada sin especificar un nombre de ruta completo, a pesar de que el intérprete normalmente busca instrucciones integradas antes que instrucciones del disco. Si se usa ‘-n’, se deshabilitan los nombres. De lo contrario, son habilitados nombres. Por ejemplo, para usar el binario test encontrado a través de $PATH en vez de la versión integrada del intérprete, escribe ‘enable -n test’.

Si se proporciona la opción ‘-p’, o no aparecen argumentos nombre, se imprime una lista de instrucciones del intérprete. Sin ningún otro argumento, la lista consta de todas las instrucciones habilitadas del intérprete. La opción ‘-a’ equivale a listar cada instrucción integrada con una señal de si está o no habilitada.

La opción ‘-f’ equivale a cargar la nueva instrucción integrada nombre del objeto compartido nombre-de-archivo, en sistemas que soportan carga dinámica. La opción ‘-d’ borrará una instrucción integrada cargada con ‘-f’.

Si no hay opciones, se muestra una lista de todas las instrucciones integradas. La opción ‘-s’ limita enable a las instrucciones integradas especiales POSIX. Si ‘-s’ se usa con ‘-f’, la nueva instrucción integrada se convierte en una instrucción integrada especial (véase la sección Instrucciones Integradas Especiales).

El estado de retorno es cero a no ser que nombre no sea una instrucción integrada del intérprete o haya un error cargando una nueva instrucción integrada de un objeto compartido.

help

help [-dms] [patrón]

Muestra información útil sobre instrucciones integradas. Si se especifica patrón, help muestra información detallada sobre todas las instrucciones que coincidan con patrón, sino se imprime una lista de las instrucciones integradas.

La opciones, si se proporcionan, tienen los siguientes significados:

-d

Muestra una descripción corta de cada patrón

-m

Muestra la descripción de cada patrón en un formato tipo página-man

-s

Muestra solo un resumen de uso corto por cada patrón

El estado de retorno es cero a no ser que ninguna instrucción coincida con patrón.

let

let expression [expresión …]

La instrucción integrada let permite realizar operaciones aritméticas en variables del intérprete. Cada expresión se evalúa de acuerdo a las reglas detalladas adelante en Aritmética del Intérprete. Si la última expresión evalúa a 0, let devuelve 1; de lo contrario, devuelve cero.

local

local [opción] nombre[=valor] …

Por cada argumento, se crea una variable local llamada nombre, y se le asigna valor. La opción puede ser cualquiera de las opciones aceptadas por declare. local solo puede ser usado dentro de una función; hace que la variable nombre tenga un alcance de visibilidad restringido a esa función y a sus hijos. Si nombre es ‘-’, el conjunto de las opciones del intérprete se hace local a la función en la que local es llamado: las opciones del intérprete cambiadas usando la instrucción integrada set dentro de la función son restablecidas a sus valores originales cuando la función retorna. El estado de retorno es cero a no ser que local se use fuera de una función, se proporcione un nombre inválido o nombre sea una variable de solo lectura.

logout

logout [n]

Sale de un intérprete de acceso, devolviendo un estado de n al padre del intérprete.

mapfile

mapfile [-d delim] [-n cuenta] [-O origen] [-s cuenta] [-t] [-u da] [-C retrollamada] [-c cuantía] [vector]

Lee líneas de la entrada estándar en la variable de vector indexado vector, o del descriptor de archivo da si se proporciona la opción ‘-u’. La variable MAPFILE es el vector predeterminado. Si se proporcionan, las opciones tienen el siguiente significado:

-d

Se usa el primer carácter de delim para terminar cada línea de entrada, en vez de nueva línea. Si delim es la cadena vacía, mapfile terminará una línea cuando lea un carácter NUL.

-n

Copia como máximo cuenta líneas. Si cuenta es 0, se copian todas las líneas.

-O

Empieza asignando a vector en el índice origen. El índice predeterminado es 0.

-s

Descarta las primeras cuenta líneas leídas.

-t

Elimina un delim al final (nueva línea predeterminada) de cada línea leída.

-u

La líneas son leídas del descriptor de archivo da en vez de la entrada estándar.

-C

Evalúa retrollamada cada vez que cuantía líneas son leídas. La opción ‘-c’ especifica cuantía.

-c

Especifica el número de líneas leídas entre cada llamada a retrollamada.

Si ‘-C’ se proporciona sin ‘-c’, la cuantía por defecto es 5000. Cuando se evalúa retrollamada, es proporcionado el índice del siguiente elemento vector a ser asignado y la línea a ser asignada a ese elemento como argumentos adicionales. retrollamada se evalúa después de que la línea sea leída, pero antes de que el elemento vector sea asignado.

Si no se proporciona con un origen explícito, mapfile liberará el vector antes de asignar a él.

mapfile retorna exitosamente a no ser que se proporcione una opción inválida, vector sea inválido o inasignable o vector no sea un vector indexado.

printf

printf [-v var] formato [argumentos]

Escribe los argumentos formateados en la salida estándar bajo el control del format. La opción ‘-v’ hace que la salida sea asignada a la variable var en vez de ser imprimida a la salida estándar.

El format es una cadena de caracteres que contiene tres tipos de objetos: caracteres sencillos, que son simplemente copiados a la salida estándar; secuencias de caracteres de escape, que son convertidos y copiados a la salida estándar; y especificaciones de formato, cada una de las cuales provoca la impresión del siguiente argumento sucesivo. Además de los formatos estándares de printf(1), printf interpreta las siguientes extensiones:

%b

Hace que printf expanda las secuencias de barras invertidas de escape en el argumento correspondiente de la misma forma que echo -e (véase la sección Instrucciones Integradas de Bash).

%q

Hace que printf muestre el argumento correspondiente en un formato que puede ser reusado como entrada del intérprete.

%(datefmt)T

Hace que printf muestre la cadena fecha-tiempo resultante de usar datefmt como una cadena de formato para strftime(3). El argumento correspondiente es un entero que representa el número de segundos desde la época. Se pueden usar dos argumentos especiales: -1 representa el tiempo actual, y -2 representa el tiempo en que el intérprete fue invocado. Si no se especifican parámetros, la conversión se comporta como si se le hubiera pasado -1. Esto es una excepción al comportamiento usual de printf.

Los argumentos para especificadores de formato que no son cadenas son tratados como constantes del lenguaje C, excepto que se permite un signo de mayor o menor como prefijo, y si el carácter prefijado es una comilla simple o doble, el valor es el valor ASCII del siguiente carácter.

El formato es reusado según sea necesario para consumir todos los argumentos. Si el format requiere más parámetros que los proporcionados, las especificaciones extra de formato se comportan como si un valor cero u nulo, según la conveniencia, hubiera sido proporcionado. El valor de retorno es cero en caso de éxito, distinto a cero en caso de fallo.

read

read [-ers] [-a nombrev] [-d delim] [-i texto] [-n ncaracts] [-N ncaracts] [-p prompt] [-t tiempo-límite] [-u da] [nombre …]

Se lee una línea de la entrada estándar, o del descriptor de archivo da proporcionado como un argumento de la opción ‘-u’, dividida en palabras como se describe anteriormente en División de Palabras, y la primera palabra se asigna al primer nombre, la segunda palabra, al segundo nombre, etc. Si hay más palabras que nombres, las palabras restantes y sus delimitadores interpuestos se asignan al último nombre. Si hay menos palabras leídas del flujo de entrada que nombres, son asignados valores vacíos a los nombres sobrantes. Se usan los caracteres en el valor de la variable IFS para dividir la línea en palabras usando las mismas reglas que usa el intérprete para la expansión (descritas anteriormente en División de Palabras). El carácter de barra invertida ‘\’ puede ser usado para eliminar cualquier significado especial para el siguiente carácter leído y para la continuación de línea. Si no se proporcionan nombres, la línea leída se asigna a la variable REPLY. El estado de salida es cero, a no ser que se encuentre el fin-de-archivo, a read se le acabe el límite de tiempo (en cuyo caso el estado es mayor que 128), ocurra un error de asignación de variable (tal como asignar a una variable de solo lectura) o se proporcione un descriptor de archivo inválido como argumento de ‘-u’.

La opciones, si se proporcionan, tienen los siguientes significados:

-a nombrev

Las palabras son asignadas a los índices secuenciales de la variable de vector nombrev, empezando por 0. Todos los elementos son eliminados de nombrev antes de la asignación. Otros argumentos nombre son ignorados.

-d delim

Se usa el primer carácter de delim para terminar la línea de entrada, en vez de nueva línea. Si delim es la cadena vacía, read terminará una línea cuando lea un carácter NUL.

-e

Readline (véase la sección Edición en Línea de Órdenes) se usa para obtener la línea. Readline usa los ajustes de edición actuales (o predeterminados, si la edición de línea no estaba previamente activa), pero usa la compleción de nombre de archivo predeterminada de Readline.

-i texto

Si Readline está siendo usado para leer la línea, texto es colocado en el búfer de edición entes de que la edición comience.

-n ncaracts

read retorna después de leer ncaracts en vez de esperar a una línea de entrada completa, pero atiende al delimitador si son leídos menos de ncaracts antes del delimitador.

-N ncaracts

read retorna después de leer exactamente ncaracts caracteres en vez de esperar a una línea completa de entrada, a no ser que se encuentre EOF o read se quede sin tiempo. Los caracteres de delimitadores encontrados en la entrada no son tratados de forma especial y no hacen que read retorne hasta que son leídos ncaracts caracteres. El resultado no es dividido en los caracteres en IFS; la intención es que sean asignados a la variable exactamente los caracteres leídos (con la excepción de la barra invertida; consulta la opción ‘-r’ abajo).

-p prompt

Muestra prompt, sin una nueva línea al final, antes de tratar de leer alguna entrada. El prompt se muestra solo si la entrada procede de una terminal.

-r

Si se pasa esta opción, la barra invertida no actúa como un carácter de escape. Se considera que la barra invertida es parte de la línea. En concreto, una pareja barra invertida-nueva línea no puede ser usada entonces como una continuación de línea.

-s

Modo silencioso. Si la entrada procede de una terminal, no muestra los caracteres escritos.

-t tiempo-límite

Hace que read tenga un límite de tiempo y devuelva fallo si una línea de entrada completa (o un número especificado de caracteres) no es leída en tiempo-límite segundos. tiempo-límite puede ser un número decimal con una porción fraccionaria siguiendo la coma decimal. Esta opción solo es efectiva si read está leyendo entrada de una terminal, tubería u otro archivo especial; no tiene efecto cuando lee de archivos normales. Si a read se le acaba el tiempo, read guarda cualquier entrada parcial leída en la nombre variable especificada. Si tiempo-límite es 0, read retorna inmediatamente, sin tratar de leer ningún dato. El estado de salida es 0 si la entrada está disponible en el descriptor de archivo especificado, distinto de cero en caso contrario. El estado de salida es mayor que 128 si se excede el tiempo límite.

-u da

Lee entrada del descriptor de archivo da.

readarray

readarray [-d delim] [-n cuenta] [-O origen] [-s cuenta] [-t] [-u da] [-C retrollamada] [-c cuantía] [vector]

Lee líneas de la entrada estándar en la variable de vector indexada vector, o del descriptor de archivo da si se proporciona la opción ‘-u’.

Un sinónimo de mapfile.

source

source nombre-de-archivo

Un sinónimo de . (véase la sección Instrucciones Integradas del Bourne Shell).

type

type [-afptP] [nombre …]

Por cada nombre, indica como sería interpretado si es usado como nombre de instrucción.

Si se usa la opción ‘-t’, type imprime una solo palabra que es una de ‘alias’, ‘function’, ‘builtin’, ‘file’ o ‘keyword’, si nombre es un alias, función del intérprete, instrucción integrada del intérprete, archivo de disco o palabra reservada del intérprete respectivamente. Si no se encuentra el nombre, no se imprime nada y type devuelve un estado de fallo.

Si se usa la opción ‘-p’, type devuelve o el nombre del archivo de disco que sería ejecutado o nada si ‘-t’ no devolviera ‘file’.

La opción ‘-P’ fuerza una búsqueda de ruta por cada nombre, incluso si ‘-t’ no devolviera ‘file’.

Si se crea el resumen criptográfico de una instrucción, ‘-p’ y ‘-P’ imprimen el valor del resumen criptográfico creado, que no es necesariamente el archivo que aparece primero en $PATH.

Si se usa la opción ‘-a’, type devuelve todos los lugares que contienen un ejecutable llamado file. Esto incluye aliases y funciones, solo si la opción ‘-p’ no se usa también.

Si se usa la opción ‘-f’, type no intenta buscar instrucciones del intérprete, como con la instrucción integrada command.

El estado de retorno es cero si se encuentran todos los nombres, distinto a cero si alguno no es encontrado.

typeset

typeset [-afFgrxilnrtux] [-p] [nombre[=valor] …]

La instrucción typeset se proporciona por compatibilidad con el intérprete Korn. Es un sinónimo de la instrucción integrada declare.

ulimit

ulimit [-HSabcdefiklmnpqrstuvxPT] [límite]

ulimit proporciona control sobre los recursos disponibles para los procesos iniciados por el intérprete, en sistemas que permiten tal control. Si se pasa una opción, se interpreta de la siguiente forma:

-S

Cambia e informa el límite suave asociado con un recurso.

-H

Cambia e informa sobre el límite duro asociado con un recurso.

-a

Se informa de todos los límites actuales.

-b

El tamaño máximo de búfer de socket.

-c

El tamaño máximo de archivos de núcleo creados.

-d

El tamaño máximo de un segmento de datos de proceso.

-e

La prioridad máxima de planificación ("nice").

-f

El tamaño máximo de archivos escritos por el intérprete y sus hijos.

-i

El tamaño máximo de señales pendientes.

-k

El número máximo de kqueues que pueden ser asignadas.

-l

El máximo tamaño que puede ser bloqueado en memoria.

-m

El máximo tamaño residente establecido (muchos sistemas no respetan este límite).

-n

El máximo número de descriptores de archivo abiertos (la mayoría de sistemas no permiten que este valor sea establecido)

-p

El tamaño del búfer de la tubería.

-q

El máximo número de bytes en colas de mensaje POSIX.

-r

La máxima prioridad de planificación en tiempo real.

-s

El tamaño máximo de pila.

-t

La cantidad máxima de tiempo de cpu en segundos.

-u

El máximo número de procesos disponibles para un único usuario.

-v

La máxima cantidad de memoria virtual disponible para el intérprete, y, en algunos sistemas, para sus hijos.

-x

El máximo número de bloqueos de archivo.

-P

El máximo número de pseudoterminales.

-T

El máximo número de procesos.

Si se proporciona límite, y la opción ‘-a’ no es usada, límite es el nuevo valor del recurso especificado. Los valores límite especiales hard, soft y unlimited representan el límite duro actual, el límite blando actual y sin límite, respectivamente. Un límite duro no puede ser aumentado por un usuario distinto a root una vez establecido; un límite blando puede ser aumentado hasta el valor del límite duro. De lo contrario, el valor actual del límite blando para el recurso especificado es imprimido, a no ser que se proporcione la opción ‘-H’. Cuando se establecen nuevos límites, si no se proporciona ni ‘-H’ ni ‘-S’, tanto el límite duro como el blando son establecidos. Si no se pasan opciones, entonces se asume ‘-f’. Los valores son en incrementos de 1024 bytes, excepto para ‘-t’, que es en segundos; ‘-p’, que es en unidades de bloques de 512 bytes; ‘-P’, ‘-T’, ‘-b’, ‘-k’, ‘-n’ y ‘-u’, que son valores no escalados; y, durante modo POSIX (véase la sección Modo POSIX de Bash), ‘-c’ y ‘-f’, que son en incrementos de 512 bytes.

El estado de retorno es cero a no ser que se proporcione un argumento u opción inválida, u ocurra un error al establecer un nuevo límite.

unalias

unalias [-a] [nombre … ]

Elimina cada nombre de la lista de aliases. Si se proporciona ‘-a’, todos lo aliases son eliminados. Los aliases son descritos en Aliases.

4.3 Modificando el Comportamiento del Intérprete

4.3.1 La Instrucción Integrada Set

Esta instrucción integrada es tan complicada que se merece su propia sección. set te permite cambiar los valores de las opciones del intérprete y establecer los parámetros posicionales, o mostrar los nombres y valores de las variables del intérprete.

set

set [--abefhkmnptuvxBCEHPT] [-o nombre-de-opción] [argumento …] set [+abefhkmnptuvxBCEHPT] [+o nombre-de-opción] [argumento …]

Si no se proporcionan opciones o argumentos, set muestra los nombres y valores de todas las variables y funciones del intérprete, ordenadas según la actual configuración regional, en un formato que puede ser reutilizado como entrada para establecer o eliminar las variables actualmente establecidas. Las variables de solo lectura no pueden ser eliminadas. En modo POSIX, solo son listadas las variables del intérprete.

Cuando se proporcionan opciones, establecen o eliminan los atributos del intérprete. Las opciones, si se especifican, tienen los siguientes significados:

-a

A cada variable o función que es creada o modificada se le da el atributo de exportación y es marcada para exportar al entorno de las posteriores instrucciones.

-b

Hace que se informe inmediatamente del estado de las tareas en segundo plano terminadas, en vez de imprimir antes del siguiente prompt primario.

-e

Sale del intérprete inmediatamente si una tubería (véase la sección Tuberías), que puede consistir en una única instrucción simple (véase la sección Instrucciones Simples), una lista (véase la sección Listas de Instrucciones) o una instrucción compuesta (véase la sección Instrucciones Compuestas) devuelve un estado distinto de cero. El intérprete no se cierra si la instrucción que falla es parte de la lista de instrucciones que sigue inmediatamente una palabra clave while o until, parte de una comprobación en un oración if, parte de cualquier instrucción ejecutada en una lista && o || excepto la instrucción que sigue al último && o ||, cualquier instrucción en una tubería excepto la última, o si el estado de retorno es invertido con !. Si una instrucción compuesta distinta de un subintérprete retorna un estado distinto a cero porque una instrucción falló mientras se ignoraba ‘-e’, no se cierra el intérprete. Se ejecuta una trap en ERR, si está establecida, antes de que el intérprete salga.

Esta opción se aplica al entorno del intérprete y a cada entorno de subintérprete de forma separada (véase la sección Entorno de Ejecución de Instrucciones), y puede provocar que los subintérpretes se cierren antes de ejecutar todas las instrucciones en el subintérprete.

Si una instrucción compuesta o una función del intérprete se ejecuta en un contexto en el que ‘-e’ esté siendo ignorado, ninguna de las instrucciones ejecutadas dentro de la instrucción compuesta o cuerpo de la función se verá afectada por el ajuste ‘-e’, incluso si ‘-e’ está establecido y una instrucción devuelva un estado de fallo. Si una instrucción compuesta o función del intérprete establece ‘-e’ es ignorado, ese ajuste no tendrá ningún efecto hasta que la instrucción compuesta o la instrucción que contiene la llamada a la función se complete.

-f

Deshabilita la expansión de nombre de archivo (globbing).

-h

Ubica y recuerda instrucciones (resumen criptográfico) mientras son consultadas para su ejecución. Esta opción está habilitada por defecto.

-k

Todos los argumentos en forma de sentencias de asignación son ubicados en el entorno para una instrucción, no solo aquellos que preceden al nombre de la instrucción.

-m

Es habilitado el control de tareas (véase la sección Control de Tareas). Todos los procesos se ejecutan en un grupo de procesos separado. Cuando se completa una tarea en segundo plano, el intérprete imprime una línea que contiene su estado de salida.

-n

Lee instrucciones pero no las ejecuta. Esto puede ser utilizado para comprobar un guion en busca de errores de sintaxis. Esta opción es ignorada por los intérpretes interactivos.

-o nombre-de-opción

Establece la opción correspondiente a nombre-de-opción:

allexport

Equivalente a -a.

braceexpand

Equivalente a -B.

emacs

Usa una interfaz de edición de línea (véase la sección Edición en Línea de Órdenes) estilo emacs. Esto también afecta a la interfaz de edición usada para read -e.

errexit

Equivalente a -e.

errexit

Equivalente a -E.

functrace

Equivalente a -T.

hashall

Equivalente a -h.

histexpand

Equivalente a -H.

history

Habilita el historial de instrucciones, como se describe en Servicios del Historial de Bash. Esta opción está activada por defecto en intérpretes interactivos.

ignoreeof

No se saldrá de un intérprete interactivo al leer EOF.

keyword

Equivalente a -k.

monitor

Equivalente a -m.

noclobber

Equivalente a -C.

noexec

Equivalente a -n.

noglob

Equivalente a -f.

nolog

Actualmente ignorado.

notify

Equivalente a -b.

nounset

Equivalente a -u.

onecmd

Equivalente a -t.

physical

Equivalente a -P.

pipefail

Si se habilita, el valor de retorno de una tubería es el valor de la última (la más a la derecha) instrucción que finalice con un estado distinto de cero, o cero si todas las instrucciones en la tubería finalizan con éxito. Esta opción está deshabilitada por defecto.

posix

Cambia el comportamiento de Bash donde la operación por defecto difiere del estándar POSIX para cumplir el estándar (véase la sección Modo POSIX de Bash). Esto está pensado para hacer que Bash se comporte como un componente preciso de ese estándar.

privileged

Equivalente a -p.

verbose

Equivalente a -v.

vi

Usa la interfaz de edición de línea estilo vi. Esto también afecta a la interfaz de edición usada por read -e.

xtrace

Equivalente a -x.

-p

Activa el modo privilegiado. En este modo los archivos $BASH_ENV y $env no son procesados, las funciones no son heredadas del entorno y las variables SHELLOPTS, BASHOPTS, CDPATH y GLOBIGNORE, si aparecen en el entorno, son ignoradas. Si el intérprete se inicia con el identificador efectivo del usuario (grupo) diferente del identificador del usuario (grupo) real y no se proporciona la opción ‘-p’, se llevan estas acciones, y el id efectivo del usuario se establece al id real del usuario. Si la opción ‘-p’ se proporciona durante el inicio, no se restablece el id de usuario efectivo. Desactivar esta opción hace que los identificadores del usuario y el grupo efectivos sean establecidos a los identificadores del usuario y el grupo reales.

-t

Sale después de leer y ejecutar una instrucción.

-u

Trata las variables y parámetros sin establecer que sean distintos a ‘@’ o ‘*’ como un error cuando se realiza la expansión de parámetros. Se escribirá un mensaje de error a la salida de error estándar, y un intérprete no interactivo se cerrará.

-v

Imprime las líneas de entrada del intérprete según son leídas.

-x

Imprime un rastro de instrucciones simples, instrucciones for, instrucciones case, instrucciones select y instrucciones aritméticas for y sus argumentos o listas de palabras asociadas después de que sean expandidos y antes de que sean ejecutados. El valor de la variable PS4 es expandido, y el valor resultante es imprimido antes de la instrucción y sus argumentos expandidos.

-B

El intérprete realizará la expansión de llaves (véase la sección Expansión de Llaves). Está opción está activada por defecto.

-C

Evita que la redirección de salida usando ‘>’, ‘>&’ y ‘<>’ sobreescriba archivos existentes.

-E

Si está establecida, cualquier trap en ERR es heredada por funciones del intérprete, sustituciones de intrucciones e intrucciones ejecutadas en un entorno de subintérprete. La trap ERR no se hereda normalmente en tales casos.

-H

Habilita la sustitución de historial estilo ‘!’ (véase la sección Expansión del Historial). Está opción está activada por defecto en intérpretes interactivos.

-P

Si está habilitada, no resuelve enlaces simbólicos al realizar instrucciones como cd que cambian el directorio actual. Se usa el directorio físico en su lugar. Por defecto, Bash sigue la cadena lógica de directorios cuando realiza instrucciones que cambian el directorio actual.

Por ejemplo, si ‘/usr/sys’ es un enlace simbólico a ‘/usr/local/sys’, entonces:

$ cd /usr/sys; echo $PWD /usr/sys $ cd ..; pwd /usr

Si set -P está activada, entonces:

$ cd /usr/sys; echo $PWD /usr/local/sys $ cd ..; pwd /usr/local

-T

Si está establecida, cualquier trap en DEBUG y RETURN son heredadas por funciones del intérprete, sustituciones de instrucciones e instrucciones ejecutadas en un entorno de subintérprete. Las trampas DEBUG y RETURN no son heredadas normalmente en tales casos.

--

Si ningún argumento sigue a esta opción, los parámetros posicionales son eliminados. En caso contrario, los parámetros posicionales son establecidos a argumentos, incluso si algunos de ellos comienzan por ‘-’.

-

Señala el fin de las opciones, hace que todos los argumentos restantes sean asignados a los parámetros posicionales. Las opciones ‘-x’ y ‘-v’ son desactivadas. Si no hay argumentos, los parámetros posicionales no cambian.

Usar ‘+’ en vez de ‘-’ hace que estás opciones se desactiven. Las opciones también pueden ser usadas al invocar al intérprete. El conjunto actual de opciones se puede encontrar en $-.

Los N argumentos porsicionales restantes son parámetros posicionales y son asignados, en orden, a $1, $2, … $N. El parámetro especial # es establecido a N.

El estado de retorno siempre es cero a no ser que se proporcione una opción inválida.

4.3.2 La Instrucción Integrada Shopt

Esta instrucción integrada te permite cambiar el comportamiento adicional del intérprete.

shopt

shopt [-pqsu] [-o] [nombre-de-opción …]

Alterna los valores de los ajustes que controlan el comportamiento opcional del intérprete. Los ajustes pueden ser los listados a continuación o, si se usa la opción ‘-o’, aquellos disponibles con la opción ‘-o’ para la instrucción integrada set (véase la sección La Instrucción Integrada Set). Sin opciones, o con la opción ‘-p’, se muestra una lista de todas las opciones que pueden ser habilitadas, con una indicación de si está habilitada o no; si se proporcionan nombres-de-opciones, se limita la salida a esas opciones. La opción ‘-p’ hace que la salida se muestre de forma que pueda ser reutilizada como entrada. Las otras opciones tienen los siguientes significados:

-s

Activa (habilita) cada nombre-de-opción.

-u

Desactiva (deshabilita) cada nombre-de-opción.

-q

Suprime la salida normal; el estado de retorno indica si el nombre-de-opción está habilitado o deshabilitado. Si se pasan varios argumentos nombre-de-opción con ‘-q’, el estado de retorno es cero si todos los nombres-de-opción están habilitados; distinto de cero en caso contrario.

-o

Limita los valores de nombre-de-opción a aquellos definidos por la opción ‘-o’ para la instrucción integrada set (véase la sección La Instrucción Integrada Set).

Si ‘-s’ o ‘-u’ se usan sin argumentos nombre-de-opción, shopt muestra solo aquellas opciones que están habilitadas o deshabilitadas, respectivamente.

A no ser que se indique lo contrario, las opciones shopt están deshabilitadas (off) por defecto.

El estado de retorno al listar opciones es cero si todos los nombres-de-opciones están habilitados, diferente a cero en caso contrario. Al habilitar o deshabilitar opciones, el estado de retorno es cero a no ser que nombre-de-opción no sea una opción del intérprete válida.

La lista de opciones shopt es:

assoc_expand_once

Si está habilitada, el intérprete suprime la evaluación múltiple de superíndices de vectores durante la evaluación de una expresión aritmética, mientras ejecuta instrucciones integradas que pueden realizar asignaciones de variables y mientras ejecuta instrucciones integradas que realizan la desreferenciación de vectores.

autocd

Si está habilitada, un nombre de instrucción que es el nombre de un directorio es ejecutado como si fuera el argumento de la instrucción cd. Esta opción solo es usada por intérpretes interactivos.

cdable_vars

Si esto está habilitado, se asume que un argumento para la instrucción integrada cd que no es un directorio es el nombre de una variable cuyo valor es el directorio al que cambiar.

cdspell

Si está habilitada, serán corregidos los errores de escritura menores de un componente de directorio en una instrucción cd. Los errores comprobados son caracteres transpuestos, y un carácter de más. Si se encuentra una corrección, se imprime la ruta corregida, y la instrucción procede. Esta opción solo es usada por intérpretes interactivos.

checkhash

Si esto está habilitado, Bash comprueba que una instrucción encontrada en la tabla hash existe antes de intentar ejecutarla. Si una instrucción con un hash ya no existe, se realiza una búsqueda de ruta normal.

checkjobs

Si está habilitada, Bash lista el estado de cualquier tarea detenida o en ejecución antes de que salga de un intérprete interactivo. Si alguna tarea está en ejecución, esto hace que la salida sea pospuesta hasta que se intente una segunda salida sin una instrucción interviniente (véase la sección Control de Tareas). El intérprete siempre pospone la salida si se detiene cualquier tarea.

checkwinsize

Si está habilitada, Bash comprueba la tamaño de la ventana después de cada instrucción externa (no integrada) y, si es necesario, actualiza los valores de LINES y COLUMNS. Esta opción está habilitada por defecto.

cmdhist

Si está habilitada, Bash intenta guardar todas las líneas de una instrucción de varias líneas en la misma entrada del historial. Esto permite una reedición sencilla de instrucciones de varias líneas. Esta opción está habilitada por defecto, pero solo tiene efecto si el historial de instrucciones está habilitado (véase la sección Servicios del Historial de Bash).

compat31

Si está habilitada, Bash cambia su comportamiento al de la versión 3.1 con respecto a los argumentos entrecomillados para el operador de la instrucción condicional ‘=~’ y respecto a la comparación de cadenas de configuración regional específica cuando se usan los operadores ‘<’ y ‘>’ de la instrucción condicional [[. Las versiones de Bash anteriores a bash-4.1 usan la secuencia de ordenación de la actual configuración regional y strcoll(3).

compat32

Si está habilitada, Bash cambia su comportamiento al de la versión 3.2 con respecto a la comparación de cadenas de regionalización específica cuando se usan los operadores ‘<’ y ‘>’ de la instrucción condicional [[ (consulta elemento anterior) y el efecto de interrumpir una lista de instrucciones. Las versiones de Bash 3.2 y anteriores continúan con la siguiente instrucción en la lista después de que una termine debido a una interrupción.

compat40

Si está habilitada, Bash cambia su comportamiento al de la versión 4.0 con respecto a la comparación de cadenas de regionalización específica cuando se usan los operadores ‘<’ y ‘>’ de la instrucción condicional [[ (ve la descripción de compat31) y el efecto de interrumpir una lista de instrucciones. Las versiones de Bash 4.0 y posteriores interrumpen la lista como si el intérprete recibiera la interrupción; las versiones previas continúan con la siguiente instrucción en la lista.

compat41

Si está habilitada, Bash, en el modo POSIX, trata una comilla simple en una expansión de parámetros de comillas dobles como un carácter especial. Las comillas simples deben coincidir (un número par) y los caracteres entre las comillas simples se consideran entrecomillados. Este es el comportamiento del modo POSIX a través de la versión 4.1. El comportamiento por defecto de Bash permanece como en versiones anteriores.

compat42

Si está habilitada, no procesa la cadena de reemplazo en la expansión de palabra de sustitución de patrón usando la eliminación de comillas.

compat43

Si está habilitada, Bash no imprime un mensaje de advertencia si se realiza un intento de usar una asignación de vector compuesto entrecomillada como un argumento para declare, convierte los errores de expansión de palabra en errores no fatales que hacen fallar a la actual instrucción (el comportamiento por defecto es convertirlos en errores fatales que hacen que el intérprete se cierre), y no restablece el estado del bucle cuando se ejecuta una función del intérprete (esto permite que break o continue en una función del intérprete afecten a los bucles en el contexto del llamador).

compat44

Si está habilitada, Bash guarda los parámetros posicionales de BASH_ARGV y BASH_ARGC antes de que sean usados, sin importar si está habilitado o no el modo de depuración extendido.

complete_fullquote

Si está habilitada, Bash entrecomilla todos los metacaracteres del intérprete en nombres de archivo y nombre de directorio al realizar la compleción. Si no está habilitada, Bash elimina metacaracteres como el símbolo de dólar del conjunto de caracteres que será entrecomillado en los nombres de archivo completados cuando estos metacaracteres aparezcan en referencias de variables del intérprete en palabras que deben ser completadas. Esto significa que los símbolos de dólar en nombres de variable que expanden a directorios no serán entrecomillados; sin embargo, cualquier signo de dólar que aparezca en nombres de archivo no será entrecomillado, tampoco. Esto está activado solo cuando bash está usando barras invertidas para entrecomillar nombres de archivo completados. Esta variable está habilitada por defecto, que es el comportamiento habitual de Bash en versiones a partir de la 4.2.

direxpand

Si está establecida, Bash reemplaza los nombres de directorio con los resultados de la expansión de palabra al realizar la compleción de nombre de archivo. Esto cambia los contenidos del búfer de edición de readline. Si no está establecida, Bash trata de preservar lo que el usuario tecleó.

dirspell

Si está establecida, Bash intenta la corrección de escritura en nombres de directorios durante la compleción de palabras si el nombre del directorio proporcionado inicialmente no existe.

dotglob

Si está establecida, Bash incluye los nombres que empiezan por un ‘.’ en los resultados de la expansión de nombre de archivo. Los nombres de archivo ‘.’ y ‘..’ siempre tienen que ser coincididos explícitamente, incluso si está habilitada dotglob.

execfail

Si esto está establecido, un intérprete no interactivo no se cerrará si no puede ejecutar el archivo especificado como un argumento para la instrucción integrada exec. No se cierra un intérprete interactivo si exec falla.

expand_aliases

Si está establecida, los aliases son expandidos como se describe abajo en Aliases, Aliases. Esta opción está habilitada por defecto para intérpretes interactivos.

extdebug

Si se habilita durante la invocación del intérprete, dispone ejecutar el perfil del depurador antes de que se inicie el intérprete, idéntica a la opción ‘--debugger’. Si se habilita tras la invocación, se habilita el comportamiento pensando para el uso de depuradores:

1. La opción ‘-F’ para la instrucción integrada declare(véase la sección Instrucciones Integradas de Bash) muestra el nombre de archivo fuente y el número de línea correspondiente a cada nombre de función proporcionado como argumento.
2. Si la instrucción ejecutada por la trap DEBUG devuelve un valor distinto a cero, se salta el siguiente comando y no se ejecuta.
3. Si la instrucción ejecutada por la trap DEBUG devuelve un valor de 2, y el intérprete se está ejecutando en una subrutina (una función del intérprete o un guion del intérprete ejecutado por las instrucciones integradas . o source), el intérprete simula una llamada a return.
4. BASH_ARGC y BASH_ARGV son actualizados según lo descrito en sus descripciones (véase la sección Variables de Bash).
5. Se habilita el rastreo de funciones: la sustitución de instrucciones, las funciones del intérprete y los subintérpretes invocados con ( instrucción ) heredan las trap DEBUG y RETURN.
6. El rastreo de errores es habilitado: la sustitución de instrucciones, las funciones del intérprete y los subintérpretes invocados con ( instrucción ) heredan la trap ERR.

extglob

Si está habilitada, son habilitadas las funcionalidades extendidas de coincidencia de patrones descritas más arriba (véase la sección Coincidencia de Patrones).

extquote

Si está habilitada, el entrecomillado $'cadena' and $"cadena" es realizado dentro de expresiones ${parámetro} encerradas en comillas dobles. Esta opción está habilitada por defecto.

failglob

Si está habilitada, los patrones que no consigan coincidir con nombres de archivo durante la expansión de nombre de archivo producen un error de expansión.

force_fignore

Si está habilitada, los sufijos especificados por la variable del intérprete FIGNORE hacen que las palabras sean ignoradas al realizar la compleción de palabras incluso si las palabras ignoradas son las únicas compleciones posibles. Véase la sección Variables de Bash, para una descripción de FIGNORE. Esta opción está habilitada por defecto.

globasciiranges

Si está habilitada, las expresiones de rango usadas en las expresiones de llaves de coincidencia de patrones (véase la sección Coincidencia de Patrones) se comportan como en la configuración regional C tradicional al realizar comparaciones. Es decir, no se tiene en cuenta la actual secuencia de ordenación de configuración regional, por lo que ‘b’ no se ordena entre ‘A’ y ‘B’, y los caracteres ASCII en minúscula o mayúscula se ordenarán juntos.

globstar

Si está habilitada, el patrón ‘**’ usado en un contexto de expansión de nombre de archivo corresponderá a todos los archivos y cero o más directorios y subdirectorios. Si al patrón lo sigue un ‘/’, solo coinciden directorios y subdirectorios.

gnu_errfmt

Si está habilitada, los mensajes de error del intérprete son escritos en el formato de error estándar de GNU.

histappend

Si está habilitada, la lista del historial es añadida al nombre de archivo nombrado por el valor de la variable HISTFILE cuando el intérprete se cierra, en vez de sobreescribir el archivo.

histreedit

Si está habilitada, y se está usando Readline, se le da la oportunidad al usuario de reeditar una sustitución del historial fallida.

histverify

Si está habilitada, y se está usando Readline, los resultados de la sustitución del historial no son inmediatamente pasados al analizador del intérprete. En su lugar, la línea resultante es cargada en el búfer de edición de Readline, permitiendo una modificación posterior.

hostcomplete

Si está habilitada, y se está usando Readline, Bash tratará de realizar una compleción del nombre de anfitrión cuando una palabra que contiene un ‘@’ esté siendo completada (véase la sección Dejar a Readline Escribir por Usted). Esta opción está habilitada por defecto.

huponexit

Si está establecida, Bash enviará SIGHUP a todas las tareas cuando se cierre un intérprete de acceso interactivo (véase la sección Señales).

inherit_errexit

Si está establecida, la sustitución de instrucciones hereda el valor de la opción errexit, en vez de eliminarlo en el entorno del subintérprete. Esta opción es habilitada cuando se habilita el modo POSIX.

interactive_comments

Permite que una palabra que comience por ‘#’ haga que esa palabra y todos los caracteres restantes en esa línea sean ignorados en un intérprete interactivo. Esta opción está habilitada por defecto.

lastpipe

Si está habilitada, y el control de tareas no está activado, el intérprete ejecuta la última instrucción de una tubería no ejecutada en segundo plano en el entorno actual del intérprete.

lithist

Si está habilitada, y la opción cmdhist está habilitada, las instrucciones de múltiples líneas son guardadas en el historial con nuevas líneas incorporadas en vez de usar separadores de puntos y comas donde sea posible.

localvar_inherit

Si está habilitada, las variables locales heredan el valor y los atributos de una variable del mismo nombre que exista en un alcance previo antes de que se asigne un nuevo valor. El atributo nameref no se hereda.

localvar_unset

Si está habilitada, llamar a unset con variables locales en alcances previos de funciones las marca de forma que las siguientes consultas las encuentran sin asignar hasta que la función retorne. Esto es idéntico al comportamiento de eliminar variables locales en el alcance actual de la función.

login_shell

El intérprete establece esta opción si se inicia como un intérprete de acceso (véase la sección Llamando a Bash). El valor no puede ser cambiado.

mailwarn

Si está habilitada, y un archivo que Bash está comprobando en busca de correo ha sido accedido desde la última hora en que fue comprobado, el mensaje "El correo en mailfile ha sido leído" será mostrado.

no_empty_cmd_completion

Si está habilitada, y se está usando Readline, Bash no tratará de buscar en el PATH para posibles compleciones cuando la compleción se intenta en una línea vacía.

nocaseglob

Si está habilitada, Bash hace coincidir nombres de archivo independientemente de mayúsculas y minúscula al realizar la expansión de nombre de archivo.

nocasematch

Si está habilitada, Bash hace coincidir patrones independientemente de mayúsculas y minúsculas al realizar coincidencias mientras ejecuta las instrucciones condicionales case o [[, cuando realiza expansiones de palabra de sustitución de patrón o cuando filtra posibles compleciones como parte de compleción programable.

nullglob

Si está habilitada, Bash permite que patrones de nombre de archivo que no corresponden con ningún archivo se expandan a una cadena vacía, en vez de a sí mismos.

progcomp

Si está habilitada, las facilidades programables de compleción (véase la sección Compleción Programable) son habilitadas. Está opción está habilitada por defecto.

progcomp_alias

Si está habilitada y la compleción programable está activada, Bash trata un nombre de instrucción que no tiene ninguna compleción como un posible alias e intenta la expansión de alias. Si tiene un alias, Bash intenta la compleción programable usando la palabra de instrucción resultante del alias expandido.

promptvars

Si está habilitada, las cadenas de prompt experimentan la expansión de parámetros, sustitución de instrucciones, expansión aritmética y eliminación de comillas después de ser expandidas como se describe más adelante (véase la sección Controlando el Prompt). Esta opción está habilitada por defecto.

restricted_shell

El intérprete establece esta opción si es iniciado en modo restringido (véase la sección El Intérprete Restringido). El valor no puede ser cambiado. Esto no se elimina cuando los archivos de arranque se ejecutan, permitiendo a los archivos de arranque descubrir si el intérprete está restringido o no.

shift_verbose

Si esto está establecido, la instrucción integrada shift imprime un mensaje de error cuando la cuenta de shift excede el número de parámetros posicionales.

sourcepath

Si está habilitada, la instrucción integrada source usa el valor de PATH para encontrar el directorio que contiene el archivo proporcionado como un argumento. Está opción está habilitada por defecto.

xpg_echo

Si está habilitada, la instrucción integrada echo expande por defecto las secuencias de escape de barras invertidas.

El estado de retorno al listar opciones es cero si todos los nombres-de-opciones están habilitados, diferente a cero en caso contrario. Al habilitar o deshabilitar opciones, el estado de retorno es cero a no ser que nombre-de-opción no sea una opción del intérprete válida.

4.4 Instrucciones Integradas Especiales

Por razones históricas, el estándar POSIX ha clasificado varias instrucciones integradas como especiales. Cuando Bash se ejecuta en modo POSIX, las instrucciones integradas especiales difieren de otras instrucciones integradas en tres aspectos:

1. Las instrucciones integradas especiales son encontradas antes que las funciones del intérprete durante la búsqueda de órdenes.
2. Si una instrucción integrada especial devuelve un estado de error, un intérprete no interactivo se cierra.
3. Las sentencias de asignación que preceden a la instrucción se mantienen en efecto en el entorno del intérprete después de que la instrucción se complete.

Cuando Bash no se ejecuta en modo POSIX, estas instrucciones integradas no se comportan de modo diferente al del resto de instrucciones integradas de Bash. El modo POSIX de Bash se describe en Modo POSIX de Bash.

Estas son las instrucciones integradas especiales POSIX:

break : . continue eval exec exit export readonly return set
shift trap unset

5. Variables del Intérprete

Este capítulo describe las variables del intérprete que usa Bash. Bash asigna automáticamente valores predeterminados a varias variables.

5.1 Variables del Bourne Shell

Bash usa ciertas variables del intérprete de la misma forma que el Bourne shell. En algunos casos, Bash asigna un valor predeterminado a la variable.

CDPATH

Una lista de directorios separada por dos puntos usada como una ruta de búsqueda para la instrucción integrada cd.

HOME

El directorio personal del usuario actual; el predeterminado para la instrucción integrada cd. El valor de esta variable es usado también por la expansión de virgulilla (véase la sección Expansión de Virgulilla).

IFS

Una lista de caracteres que separa campos; usada cuando el intérprete divide palabras como partes de expansión.

MAIL

Si este parámetro está establecido a un nombre de archivo o directorio y la variable MAILPATH no está asignada, Bash informa al usuario de la llegada de correo en el archivo especificado o directorio con formato de Maildir.

MAILPATH

Una lista separada por dos puntos de nombres de archivos que el intérprete comprueba periódicamente en busca de nuevo correo. Cada entrada de la lista puede especificar el mensaje que es imprimido cuando llega correo nuevo en el archivo de correo separando el nombre de archivo del mensaje con un ‘?’. Cuando se usa en el texto del mensaje, $_ se expande al nombre del actual archivo de correo.

OPTARG

El valor del último argumento de opción procesado por la instrucción integrada getopts.

OPTIND

El índice del último argumento de opción procesado por la instrucción integrada getopts.

PATH

Una lista de directorios separada por dos puntos en la que el intérprete busca instrucciones. Un nombre de directorio de longitud cero (nulo) en el valor de PATH indica el directorio actual. Un nombre de directorio nulo puede aparecer como dos dos puntos adyacentes o como dos puntos al final o al principio.

PS1

La cadena de prompt primaria. El valor predeterminado es ‘\s-\v\$ ’. Véase la sección Controlando el Prompt, para la lista completa de secuencias de escape que son expandidas antes de que se muestre PS1.

PS2

La cadena de prompt secundaria. El valor predeterminado es ‘>’. PS2 se expande de la misma forma que PS1 antes de ser mostrado.

5.2 Variables de Bash

Estas palabras son establecidas o usadas por Bash, pero otros intérpretes no las tratan normalmente de forma especial.

Unas pocas variables usadas por Bash son descritas en diferentes capítulos: variables para controlar las herramientas de control de tareas (véase la sección Variables de Control de Tareas).

BASH

El nombre de ruta completo usado para ejecutar la actual instancia de Bash.

BASHOPTS

Una lista separada por dos puntos de opciones del intérprete habilitadas. Cada palabra en la lista es un argumento válido para la opción ‘-s’ de la instrucción integrada shopt (véase la sección La Instrucción Integrada Shopt). Las opciones que aparecen en BASHOPTS son aquellas que se muestran como ‘on’ por ‘shopt’. Si esta variable está en el entorno cuando Bash se inicia, cada opción del intérprete en la lista será activada antes de leer cualquier archivo de inicio. La variable es de solo lectura.

BASHPID

Se expande al ID de proceso del proceso actual de Bash. Esto difiere de $$ bajo algunas circunstancias, como subintérpretes que no necesitan que Bash sea reinicializado. Las asignaciones a BASHPID no tienen efecto. Si BASHPID está sin asignar, pierde sus propiedades especiales, incluso si es posteriormente restablecido.

BASH_ALIASES

Una variable de vector asociativo cuyos miembros corresponden a la lista interna de aliases como es mantenida por la instrucción integrada alias. (véase la sección Instrucciones Integradas del Bourne Shell). Los elementos añadidos a este vector aparecen en la lista de aliases; sin embargo, eliminar elementos del vector actualmente no hace que los aliases sean eliminados de la lista de aliases. Si BASH_ALIASES no está asignada, pierde sus propiedades especiales, incluso si es restablecida posteriormente.

BASH_ARGC

Una variable de vector cuyos valores son el número de parámetros en cada marco de la actual pila de llamadas de ejecución de bash. El número de parámetros para la subrutina actual (función del intérprete o guion ejecutado con . o source) está encima en la pila. Cuando se ejecuta una subrutina, el número de parámetros pasados se mete en BASH_ARGC. El intérprete asigna BASH_ARGC solo cuando está en el modo de depuración extendido (consulte La Instrucción Integrada Shopt para una descripción de la opción extdebug para la instrucción integrada shopt). Asignar extdebug después de que se haya iniciado el intérprete para ejecutar un guion o referenciar esta variable cuando extdebug no está activada, puede producir valores inconsistentes.

BASH_ARGV

Una variable de vector que contiene todos los parámetros en la pila de ejecución actual de bash. El parámetro final de la última llamada de subrutina está encima en la pila; el primer parámetro de la llamada inicial está abajo. Cuando se ejecuta una subrutina, los parámetros proporcionados se meten en BASH_ARGV. El intérprete asigna BASH_ARGV solo cuando está en el modo de depuración extendido (vea La Instrucción Integrada Shopt para una descripción de la opción extdebug de la instrucción integrada shopt). Establecer extdebug después de que el intérprete ha empezado a ejecutar un guion o hacer referencia a esta variable cuando extdebug no está habilitado, puede producir valores inconsistentes.

BASH_ARGV0

Cuando se hace referencia, esta variable se expande al nombre del intérprete o el guion del intérprete (idéntica a $0; Véase la sección Parámetros Especiales, para una descripción del parámetro especial 0). La asignación a BASH_ARGV0 hace que el valor asignado también sea asignado a $0. Si BASH_ARGV0 es eliminado, pierde sus propiedades especiales, incluso si es posteriormente restablecido.

BASH_CMDS

Una variable de vector asociativo cuyos miembros corresponden a la tabla hash interna de instrucciones como mantiene la instrucción integrada hash (véase la sección Instrucciones Integradas del Bourne Shell). Los elementos añadidos a este vector aparecen en la tabla hash; sin embargo, eliminar elementos de vector actualmente no hace que los nombres de instrucciones sean eliminados de la tabla hash. Si BASH_CMDS no está asignada, pierde sus propiedades iniciales, incluso si es posteriormente restablecida.

BASH_COMMAND

La instrucción actualmente en ejecución o a punto de ser ejecutada, a no ser que el intérprete esté ejecutando una instrucción como resultado de una trap, en cuyo caso es la instrucción ejecutándose en el momento de la trap.

BASH_COMPAT

Este valor se usa para establecer el nivel de compatibilidad del intérprete. Véase la sección La Instrucción Integrada Shopt, para una descripción de los varios niveles de compatibilidad y sus efectos. El valor puede ser un número decimal (p. ej., 4,2) o un entero (p. ej., 42) correspondiente al nivel de compatibilidad deseado. Si BASH_COMPAT está sin asignar o asignado a la cadena vacía, el nivel de compatibilidad se establece al predeterminado para la versión actual. Si BASH_COMPAT está establecida a un valor que no es uno de los niveles de compatibilidad válidos, el intérprete imprime un mensaje de error y establece el nivel de compatibilidad al predeterminado para la versión actual. Los niveles de compatibilidad válidos corresponden a las opciones de compatibilidad aceptadas por la instrucción integrada shopt descritas anteriormente (por ejemplo, compat42 significa que 4.2 y 42 son valores válidos). La versión actual es también un valor válido.

BASH_ENV

Si esta variable está asignada cuando Bash es llamado para ejecutar un guion del intérprete, su valor se expande y se usa como el nombre de un archivo de inicio que leer antes de ejecutar el guion. Véase la sección Archivos de Inicio de Bash.

BASH_EXECUTION_STRING

El argumento de instrucción para la opción de llamada ‘-c’.

BASH_LINENO

Una variable de vector cuyos miembros son los números de línea en archivos fuentes donde se invocó cada miembro correspondiente de FUNCNAME. ${BASH_LINENO[$i]} es el número de línea en el archivo fuente (${BASH_SOURCE[$i+1]}) donde ${FUNCNAME[$i]} fue llamado (o ${BASH_LINENO[$i-1]} si se referencia dentro de otra función del intérprete). Use LINENO para obtener el número de línea actual.

BASH_LOADABLES_PATH

Una lista de directorios separada por dos puntos en la que el intérprete busca instrucciones integradas dinámicamente cargables especificadas por la instrucción enable.

BASH_REMATCH

Una variable de vector cuyos miembros son asignados por el operador binario ‘=~’ de la instrucción condicional [[ (véase la sección Construcciones Condicionales). El elemento con índice 0 es la porción de la cadena que coincide la expresión regular entera. El elemento con índice n es la porción de la cadena que coincide con la subexpresión entre paréntesis número n. Esta variable es de solo lectura.

BASH_SOURCE

Una variable de vector cuyos miembros son los nombres de archivo fuentes donde están definidos los correspondientes nombres de funciones del intérprete en la variable de vector FUNCNAME. La función del intérprete ${FUNCNAME[$i]} está definida en el archivo ${BASH_SOURCE[$i]} y es llamada desde ${BASH_SOURCE[$i+1]}

BASH_SUBSHELL

Incrementada en uno con cada subintérprete o entorno de subintérprete cuando se empieza a ejecutar el intérprete en ese entorno. El valor inicial es 0.

BASH_VERSINFO

Una variable de vector de solo lectura (véase la sección Vectores) cuyos miembros guardan información de versión para esta instancia de Bash. Los valores asignados a los miembros del vector son los siguientes:

BASH_VERSINFO[0]

El número de versión mayor (la publicación).

BASH_VERSINFO[1]

El número de versión menor (la versión).

BASH_VERSINFO[2]

El nivel de parche.

BASH_VERSINFO[3]

La versión de construcción.

BASH_VERSINFO[4]

El estado de publicación (p. ej., beta1).

BASH_VERSINFO[5]

El valor de MACHTYPE.

BASH_VERSION

El número de versión de la actual instancia de Bash.

BASH_XTRACEFD

Si está asignado a un entero correspondiente a un descriptor de archivo válido, Bash escribirá el rastreo de salida generado cuando la ‘set -x’ está habilitado para ese descriptor de archivo. Esto permite que el rastreo de salida esté separado de mensajes de diagnóstico y error. El descriptor de archivo se cierra cuando se elimina o se asigna un nuevo valor a BASH_XTRACEFD. Eliminar BASH_XTRACEFD o asignarlo a la cadena vacía hace que el rastreo de salida sea asignado al error estándar. Observe que asignar BASH_XTRACEFD a 2 (el descriptor de archivo del error estándar) y después eliminarlo hará que sea cerrado el error estándar.

CHILD_MAX

Establece el número de valores de estados de salida finalizados que el intérprete puede recordar. Bash no permitirá que este valor sea reducido por debajo de un mínimo mandado por POSIX, y hay un valor máximo (actualmente 8192) que no puede ser excedido. El valor mínimo es dependiente del sistema.

COLUMNS

Usada por la instrucción select para determinar la anchura de la terminal al imprimir listas de selección. Automáticamente asignada si la opción checkwinsize está activada (véase la sección La Instrucción Integrada Shopt), o en un intérprete interactivo al recibir una SIGWINCH.

COMP_CWORD

Un indice a ${COMP_WORDS} de la palabra que contiene la posición actual del cursor. Esta variable está disponible solo en funciones del intérprete llamadas por las herramientas de compleción programables (véase la sección Compleción Programable).

COMP_LINE

La línea de orden actual. Esta variable está disponible solo en funciones del intérprete e instrucciones externas llamadas por las herramientas de compleción programables (véase la sección Compleción Programable).

COMP_POINT

El índice de la posición actual del cursor relativa al comienzo de la instrucción actual. Si la posición actual del cursor está al final de la instrucción actual, el valor de esta variable es igual a ${#COMP_LINE}. Esta variable está disponible solo en funciones del intérprete e instrucciones externas llamadas por las herramientas de compleción programables (véase la sección Compleción Programable).

COMP_TYPE

Asignada a un valor entero correspondiente al tipo de compleción intentado que hizo que una función de compleción fuera llamada: TAB, para compleción normal; ‘?’, para listar compleciones después de sucesivas tabulaciones, ‘!’, para listar alternativas a compleción parcial de palabra, ‘@’, para listar compleciones si la palabra no se modifica; o ‘%’, para compleción de menú. Esta variable está disponible solo en funciones del intérprete e instrucciones externas llamadas por las herramientas de compleción programables (véase la sección Compleción Programable).

COMP_KEY

La tecla (o tecla final de una secuencia de teclas) usada para llamar a la actual función de compleción.

COMP_WORDBREAKS

El conjunto de caracteres que la biblioteca Readline trata como separadores de palabra al realizar la compleción de palabra. Si COMP_WORDBREAKS está sin asignar, pierde sus propiedades especiales, incluso si es restablecida posteriormente.

COMP_WORDS

Una variable de vector que consta de las palabras individuales en la actual línea de órdenes. La línea se divide en palabras como Readline la dividiría, usando COMP_WORDBREAKS como se describe anteriormente. Esta variable está disponible solo en funciones del intérprete llamadas por las herramientas de compleción programables (véase la sección Compleción Programable).

COMPREPLY

Una variable de vector de la que Bash lee las posibles compleciones generadas por una función del intérprete llamada por la herramienta de compleción programable (véase la sección Compleción Programable). Cada elemento del vector contiene una posible compleción.

COPROC

Una variable de vector creada para alojar los descriptores de archivo para salida de y entrada para un coproceso sin nombre (véase la sección Coprocesos).

DIRSTACK

Una variable de vector que contiene los contenidos actuales de la pila de directorios. Los directorios aparecen en la pila en el orden en que son mostrados por la instrucción integrada dirs. Asignar a miembros de esta variable de vector puede usarse para modificar directorios ya en la pila, pero las instrucciones integradas pushd y popd deben ser usadas para añadir y eliminar directorios. La asignación a esta variable no cambiará el directorio actual. Si DIRSTACK está sin asignar, pierde sus propiedades especiales, incluso si es restablecida posteriormente.

EMACS

Si Bash encuentra esta variable en el entorno cuando el intérprete se inicia con el valor ‘t’, asume que el intérprete está corriendo en un búfer de intérprete de Emacs y deshabilita la edición de línea.

ENV

Similar a BASH_ENV; usada cuando el intérprete es llamado en Modo POSIX (véase la sección Modo POSIX de Bash).

EPOCHREALTIME

Cada vez que se hace referencia a este parámetro se expande al número de segundos desde la Época Unix como un valor de coma flotante con granularidad de microsegundos (consulte la documentación de la función de la librería C time para la definición de Época). Las asignaciones a EPOCHREALTIME son ignoradas. Si EPOCHREALTIME es eliminada, pierde sus propiedades espciales, incluso si es restablecida posteriormente.

EPOCHSECONDS

Cada vez que se hace referencia a este parámetro, se expande al número de segundos desde el Tiempo Unix (consulte la definición de Época en la documentación de la función time de la librería C). Las asignaciones a EPOCHSECONDS son ignoradas. Si EPOCHSECONDS no está asignada, pierde sus propiedades especiales, incluso si es restablecida posteriormente.

EUID

El id numérico efectivo de usuario del actual usuario. Esta variable es de solo lectura.

EXECIGNORE

Una lista de patrones separada por dos puntos (véase la sección Coincidencia de Patrones) que define la lista de nombres de archivo que serán ignorados por la búsqueda de instrucciones usando PATH. Los archivos cuyos nombres de ruta completos coinciden con uno de estos patrones no se consideran archivos ejecutables para los propósitos de compleción y ejecución mediante búsqueda de PATH. Esto no afecta el comportamiento de las instrucciones [, test y [[. Los nombres de ruta completos en la tabla hash de instrucciones no están sujetos a EXECIGNORE. Use esta variable para ignorar los archivos de librería compartidos que tiene asignado el bit de ejecución, pero no son archivos ejecutables. La coincidencia de patrones hace honor al ajuste de la opción del intérprete extglob.

FCEDIT

El editor usado como predeterminado por la opción ‘-e’ de la instrucción integrada fc.

FIGNORE

Una lista separada de sufijos que ignorar al realizar la compleción de nombre de archivo. Un nombre de archivo cuyo sufijo coincide con una de las entradas en FIGIGNORE es excluido de la lista de nombres de archivo completados. Un valor de muestra es ‘.o:~’.

FUNCNAME

Una variable de vector que contiene los nombres de todas las funciones del intérprete actualmente en la pila de ejecución de llamadas. El elemento con índice 0 es el nombre de cualquier función del intérprete en ejecución actualmente. El elemento más al fondo (aquel con el índice más alto) es "main". Esta variable solo existe cuando una función del intérprete se está ejecutando. Las asignaciones a FUNCNAME no tienen efecto. Si FUNCNAME está sin asignar, pierde sus propiedades especiales, incluso si es restablecida posteriormente.

Esta variable puede ser usada con BASH_LINENO y BASH_SOURCE. Cada elemento de FUNCNAME tiene elementos correspondientes en BASH_LINENO y BASH_SOURCE para describir la pila de llamadas. Por ejemplo, ${FUNCNAME[$i]} fue llamada del archivo ${BASH_SOURCE[$i+1]} en el número de línea ${BASH_LINENO[$i]}. La instrucción integrada caller muestra la actual pila de llamadas usando esta información.

FUNCNEST

Si está asignada a un valor numérico mayor que 0, define un nivel de anidamiento de función máximo. Las llamadas de función que excedan este límite harán que se aborte la instrucción actual.

GLOBIGNORE

Una lista de patrones separada por dos puntos que define el número de nombres de archivo que deben ser ignorados por la expansión de nombre de archivo. Si un nombre de archivo coincidido por un patrón de expansión de nombre de archivo también coincide con uno de los patrones en GLOBIGNORE, es eliminado de la lista de coincidencias. Los patrones coincidentes hacen honor al ajuste de la opción del intérprete extglob.

GROUPS

Una variable de vector que contiene la lista de grupos de los cuales el usuario actual es miembro. Las asignaciones a GROUPS no tienen efecto. Si GROUPS es eliminada, pierde sus propiedades especiales, incluso si es restablecida posteriormente.

histchars

Hasta tres caracteres que controlan la expansión de historial, sustitución rápida y simbolización (véase la sección Expansión del Historial). El primer carácter es el carácter de expansión de historial, es decir, el carácter que representa el inicio de una expansión de historial, normalmente ‘!’. El segundo carácter es el carácter que representa ‘sustitución rápida cuando es visto como el primer carácter en la línea, normalmente ‘^’. 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 ‘#’. El carácter de comentario de historial hace que sea saltada la sustitución de historial para el resto de palabras en la línea. No necesariamente hace que el analizador del intérprete trate el resto de la línea como un comentario.

HISTCMD

El número de historial, o índice en la lista de historial, de la instrucción actual. Si HISTCMD está sin asignar, pierde sus propiedades especiales, incluso si se restablece posteriormente.

HISTCONTROL

Una lista de valores separada por dos puntos que controla cómo se guardan las instrucciones en la lista de historial. Si la lista de valores incluye ‘ignorespace’, las líneas que empiezan por un carácter de espacio no se guardan en la lista del historial. Un valor de ‘ignoredups’ hace que las líneas que coinciden con la entrada de historial anterior no sean guardadas. Un valor de ‘ignoreboth’ es una abreviatura de ‘ignorespace’ e ‘ignoredups’. Un valor de ‘erasedups’ hace que todas las líneas anteriores que coinciden con la línea actual sean eliminadas de la lista del historial antes de que la línea sea guardada. Cualquier valor fuera de la lista anterior se ignora. Si HISTCONTROL está sin asignar o no incluye un valor válido, todas las líneas leídas por el analizador del intérprete son guardadas en la lista del historial, sujetas al valor de HISTIGNORE. La segunda y posteriores líneas de una instrucción multilínea compuesta no son probadas y se añaden al historial sin importar el valor de HISTCONTROL.

HISTFILE

El nombre del archivo al cual se guarda el historial de instrucciones. El valor predeterminado es ‘~/.bash_history’.

HISTFILESIZE

El máximo número de líneas contenidas en el archivo de historial. Cuando se asigna a esta variable un valor, el archivo de historial es recortado, si es necesario, para contener no más del número de líneas eliminando las entradas más antiguas. El archivo de historial también es recortado a este tamaño después de escribirlo cuando finaliza un intérprete. Si el valor es 0, el archivo de historial se recorta a tamaño cero. Las valores no numéricos y valores numéricos menores de cero inhiben el recorte. El intérprete asigna el valor predeterminado al valor de HISTSIZE después de leer los archivos de inicialización.

HISTIGNORE

Una lista de patrones separada por dos puntos usada para decidir qué líneas de instrucción deberían guardarse en la lista del historial. Cada patrón es anclado al principio de la línea y debe coincidir con la línea completa (no se añade un ‘*’ implícito). Cada patrón se comprueba contra la línea después de que las comprobaciones especificadas por HISTCONTROL sean aplicadas. Además de los caracteres normales de coincidencia de patrones del intérprete, ‘&’ coincide con la anterior línea de historial. ‘&’ puede ser escapada usando una barra invertida; la barra invertida se elimina antes de intentar una coincidencia. La segunda y las posteriores líneas de una instrucción compuesta multilínea no son comprobadas, y se añaden al historial sin importar el valor de HISTIGNORE. El patrón que coincide hace honor al ajuste de la opción del intérprete extglob.

HISTIGNORE subsume la función de HISTCONTROL. Un patrón de ‘&’ es idéntico a ignoredups, y un patrón de ‘[ ]*’ es idéntico a ignorespace. Combinar estos dos patrones, separándolos con dos puntos, proporciona la funcionalidad de ignoreboth.

HISTSIZE

El máximo número de instrucciones que recordar en la lista del historial. Si el valor es 0, las instrucciones no se guardan en la lista del historial. Los valores numéricos menores que cero resultan en cada instrucción guardándose en la lista del historial (no hay límite). El intérprete establece el valor predeterminado a 500 después de leer los archivos de inicio.

HISTTIMEFORMAT

Si esta variable está asignada y no es nula, su valor se usa como una cadena de formato para strftime para imprimir la marca temporal asociada con cada entrada de historial mostrada por la instrucción integrada history. Si está asignada esta variable, las marcas de tiempo se escriben al archivo de historial de forma que puedan ser preservadas entre sesiones del intérprete. Esto usa el carácter de comentario de historial para distinguir marcas de tiempo de otras líneas de historial.

HOSTFILE

Contiene el nombre de un archivo en el mismo formato que ‘/etc/hosts’ que debería ser leído cuando el intérprete necesita completar un nombre de anfitrión. La lista de posibles compleciones de nombre de anfitrión puede ser cambiada mientra el intérprete se ejecuta; la siguiente vez que se intente la compleción de nombre de anfitrión después de que se cambie el valor, Bash añade los contenidos del nuevo archivo a la lista existente. Si HOSTFILE está asignada pero no tiene valor o no nombra un archivo legible, Bash trata de leer ‘/etc/hosts’ para obtener la lista de posibles compleciones de nombre de anfitrión. Cuando HOSTFILE está sin asignar, se limpia la lista de nombre de anfitrión.

HOSTNAME

El nombre del anfitrión actual.

HOSTTYPE

Una cadena que describe la máquina en que se está ejecutando Bash.

IGNOREEOF

Controla la acción del intérprete al recibir un carácter EOF como la única entrada. Si está asignado, el valor denota el número de caracteres EOF consecutivos que pueden ser leídos como el primer carácter de una línea de entrada antes de que finalice el intérprete. Si la variable existe pero no tiene un valor numérico, o no tiene valor, entonces el predeterminado es 10. Si la variable no existe, el EOF significa el final de la entrada para el intérprete. Esto solo está en efecto para intérpretes interactivos.

INPUTRC

El nombre del archivo de inicialización Readline, que sobrescribe el valor predeterminado de ‘~/.inputrc’.

INSIDE_EMACS

Si Bash encuentra esta variable en el entorno cuando el intérprete se inicia, asume que el intérprete está corriendo en un búfer de intérprete de Emacs y puede deshabilitar la edición de línea dependiendo del valor de TERM.

LANG

Usada para determinar la categoría de configuración regional para cualquier categoría no especifícamente seleccionada con una variable que empieza por LC_.

LC_ALL

Esta variable sobrescribe el valor de LANG y cualquier otra variable LC_ que especifica una categoría de configuración regional.

LC_COLLATE

Esta variable determina la ordenación usada para ordenar los resultados de la expansión de nombre de archivo, y determina el comportamiento de las expresiones de rango, clases de equivalencia y secuencias de ordenación dentro de la expansión de nombre de archivo y coincidencia de patrones (véase la sección Expansión de Nombre de Archivo).

LC_CTYPE

Esta variable determina la interpretación de caracteres y el comportamiento de las clases de caracteres dentro de una expansión de nombre de archivo y coincidencia de patrones (véase la sección Expansión de Nombre de Archivo).

LC_MESSAGES

Esta variable determina la configuración regional usada para traducir cadenas entre comillas dobles precedidas por un ‘$’ (véase la sección Traducción de Región Específica).

LC_NUMERIC

Esta variable determina la categoría de configuración regional para el formato de números.

LC_TIME

Esta variable determina la categoría de configuración regional usada para el formato de fecha y tiempo.

LINENO

El número de línea en el guion o función del intérprete actualmente en ejecución.

LINES

Usada por la instrucción select para determinar la longitud de columna para imprimir listas de selección. Automáticamente asignada si la opción checkwinsize está activada (véase la sección La Instrucción Integrada Shopt), o en un intérprete interactivo al recibir una SIGWINCH.

MACHTYPE

Una cadena que describe completamente el tipo de sistema en que Bash está ejecutándose, en el formato estándar GNU ucp-empresa-sistema.

MAILCHECK

La frecuencia (en segundos) con la que el intérprete debe comprobar el correo en los archivos especificados en las variables MAILPATH o MAIL. La predeterminada es 60 segundos. Cuando es hora de comprobar el correo, el intérprete lo hace antes de mostrar el prompt primario. Si esta variable está sin asignar o asignada a un valor que no es un número mayor o igual a cero, el intérprete deshabilita la comprobación de correo.

MAPFILE

Una variable de vector creada para contener el texto leído por la instrucción integrada mapfile cuando no se proporciona nombre de variable.

OLDPWD

El directorio de trabajo anterior según se establece por la instrucción integrada cd.

OPTERR

Si asignada al valor 1, Bash muestra mensajes de error generados por la instrucción integrada getopts.

OSTYPE

Una cadena que describe el sistema operativo en que Bash se está ejecutando.

PIPESTATUS

Una variable de vector (véase la sección Vectores) que contiene una lista de los valores de estado de salida de los procesos en la tubería en primer plano más recientemente ejecutada (que podría contener una sola instrucción).

POSIXLY_CORRECT

Si esta variable está en el entorno cuando Bash se inicia, el intérprete entra al modo POSIX (véase la sección Modo POSIX de Bash) antes de leer los archivos de inicio, como si se hubiera proporcionado la opción de llamada ‘--posix’. Si se asigna cuando el intérprete está en ejecución, Bash activa el modo POSIX, como si la instrucción

set -o posix

hubiera sido ejecutada. Cuando el intérprete entra en modo POSIX asigna la variable si no a sido aún asignada.

PPID

El ID de proceso del proceso padre del intérprete. Esta variable es de solo lectura.

PROMPT_COMMAND

Si está asignada, el valor se interpreta como una instrucción que ejecutar antes de imprimir cada prompt primario ($PS1).

PROMPT_DIRTRIM

Si está asignada a un número mayor que cero, el valor se usa como el número de componentes finales de directorio que retener al expandir las cadenas de escape de prompt \w y \W (véase la sección Controlando el Prompt). Los caracteres eliminados son reemplazados por puntos suspensivos.

PS0

El valor de este parámetro es expandido como PS1 y mostrado por intérpretes interactivos después de leer una instrucción y antes de que la instrucción sea ejecutada.

PS3

El valor de esta variable se usa como el prompt para la instrucción select. Si no está asignada esta variable, la instrucción select usa el prompt ‘#? ’.

PS4

El valor de este parámetro se expande como PS1 y el valor expandido es el prompt imprimido antes de que la línea de instrucción sea repetida cuando la opción ‘-x’ esté habilitada (véase la sección La Instrucción Integrada Set). El primer carácter del valor expandido se repete múltiples veces, según sea necesario, para indicar múltiples niveles de indirección. El predeterminado es ‘+’.

PWD

El directorio de trabajo actual según se establece por la instrucción integrada cd.

RANDOM

Cada vez que se referencia a este parámetro, es generado un entero aleatorio entre 0 y 32767. Asignar un valor a esta variable crea la semilla del generador de números aleatorio.

READLINE_LINE

Los contenidos del búfer de línea de Readline, para uso con ‘bind -x’ (véase la sección Instrucciones Integradas de Bash).

READLINE_POINT

La posición del punto de inserción en el búfer de línea de Readline, para uso con ‘bind -x’ (véase la sección Instrucciones Integradas de Bash).

REPLY

La variable predeterminada para la instrucción integrada read.

SECONDS

Esta variable se expande al número de segundos desde que se inició el intérprete. Asignar a esta variable restablece la cuenta al valor asignado, y el valor expandido se convierte en el valor asignado más el número de segundos desde la asignación.

SHELL

El nombre de ruta completo para el intérprete se mantiene en esta variable de entorno. Si no está asignada cuando el intérprete se inicia, Bash la asignará al nombre de ruta completo del actual intérprete de acceso del usuario.

SHELLOPTS

Una lista de opciones del intérprete habilitadas separada por dos puntos. Cada palabra en la lista es un argumento válido para la opción ‘-o’ de la instrucción integrada set (véase la sección La Instrucción Integrada Set). Las opciones que aparecen en SHELLOPTS son aquellas descritas con ‘on’ por ‘set -o’. Si esta variable está en el entorno cuando Bash se inicia, cada opción del intérprete en la lista será activada antes de leer los archivos de inicio. Esta variable es de solo lectura.

SHLVL

Incrementada en uno cada vez que se inicia una nueva instancia de Bash. Esto está pensado para ser un contador de la profundidad en que sus intérpretes de Bash están anidados.

TIMEFORMAT

El valor de este parámetro se usa como una cadena de formato que especifica cómo debería mostrarse la información temporal para tuberías prefijadas con la palabra reservada time. El carácter ‘%’ introduce una secuencia de escape que se expande a un valor temporal u otra información. Las secuencias de escape y sus significados son los siguientes; las llaves denotan partes opcionales.

%%

Un ‘%’ literal.

%[p][l]R

El tiempo transcurrido en segundos.

%[p][l]U

El número de segundos de UCP pasados en modo usuario.

%[p][l]S

El número de segundos de UCP pasados en modo sistema.

%P

El porcentaje de UCP, computado como (%U + %S) / %R.

La p opcional es un dígito que especifica la precisión, el número de dígitos fraccionales después de la coma decimal. Un valor de 0 hace que no se muestre ninguna coma decimal o fracción. Como mucho pueden especificarse tres lugares tras la coma decimal; valores de p mayores que 3 son cambiados a 3. Si no se especifica p, se usa el valor 3.

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

Si esta variable no está asignada, 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 información de tiempo. Se añade una nueva línea final cuando se muestra la cadena de formato.

TMOUT

Si está asignada a un valor mayor que cero, TMOUT se trata como el tiempo límite predeterminado para la instrucción integrada read (véase la sección Instrucciones Integradas de Bash). La instrucción select (véase la sección Construcciones Condicionales) termina si la entrada no llega después de TMOUT segundos cuando la entrada viene de una terminal.

En un intérprete interactivo, el valor se interpreta como el número de segundos que esperar a una línea de entrada después de generar el prompt primario. Bash termina después de esperar ese número de segundos si no llega una línea de entrada completa.

TMPDIR

Si está asignada, Bash usa su valor como el nombre de un directorio en el que Bash crea archivos temporales para que use el intérprete.

UID

El id numérico real de usuario del usuario actual. Esta variable es de solo lectura.