← Todas las guías

Guía defensiva

¿Cómo leer códigos de salida Bash sin confundir ausencia y error?

En Bash, cero suele indicar éxito y un valor distinto de cero requiere interpretación. Un filtro puede informar que no hubo coincidencias sin que eso sea un fallo operativo.

Define el resultado esperado

Antes de filtrar datos de práctica, escribe qué significan una coincidencia, ninguna coincidencia y un error de lectura. grep usa el estado 0 cuando selecciona líneas, 1 cuando no selecciona ninguna y 2 si hubo un error, como un archivo que no existe o no se puede leer.

El estado de la última orden está en $?, y cualquier orden que ejecutes después lo sobrescribe, así que léelo enseguida: grep denegado acceso.log; echo $?. Ejemplo resuelto: grep no encuentra el patrón denegado y devuelve 1; para una búsqueda de presencia, el informe registra cero coincidencias. Si no pudo leer el archivo, devuelve 2 y el resultado se clasifica como error, no como ausencia. Dos estados más que verás en pruebas: 127 significa que la orden no existe y 126 que existe pero no se puede ejecutar.

Observa cada tramo

Un pipeline entrega salida de una orden a otra, pero Bash usa por defecto el estado de la última orden. Un contador final puede ocultar que un filtro anterior no leyó la fuente como se esperaba. Ejemplo: con grep denegado no-existe.log | wc -l, grep falla con 2 porque el archivo no existe, wc imprime 0 y el pipeline termina con estado 0.

set -o pipefail hace que el pipeline informe el último estado distinto de cero de sus tramos. Para ver el estado de cada tramo, Bash guarda un arreglo: echo "${PIPESTATUS[@]}" justo después del pipeline imprime algo como 2 0. Con pipefail activo, un grep sin coincidencias también vuelve el pipeline distinto de cero: todavía hay que distinguir una ausencia prevista (1) de un error (2) que requiere detenerse o avisar.

Conserva evidencia

Prueba primero con un archivo pequeño y controlado, y prueba también el caso de un archivo inexistente para comprobar que ves el 2. Guarda los pasos, estados observados y una muestra autorizada para que otra persona pueda repetir la lectura.

Un código de salida describe el resultado de una herramienta, no la causa de los eventos. No uses un conteo como diagnóstico de un incidente.

Conecta con la práctica

La lección gratuita de Bash presenta comandos, salida y conexiones entre herramientas. Es el puente para ubicar un pipeline; no evalúa códigos de salida ni pipefail.

Formula una pregunta limitada sobre archivos de práctica. No redirijas sobre evidencia ni ejecutes cambios para comprobar un código.

Fuentes para profundizar