Códigos de salida de find y xargs: el 0/>0 básico de find frente a la escala 123-127 de xargs

Qué es

El manual de find es deliberadamente vago sobre cualquier cosa que vaya más allá de un valor booleano: "find exits with status 0 if all files are processed successfully, greater than 0 if errors occur. This is deliberately a very broad description." (find termina con estado 0 si todos los archivos se procesan correctamente y con un valor mayor que 0 si ocurren errores; es una descripción deliberadamente muy amplia). Añade una advertencia realmente importante: cuando la salida es distinta de cero, "you should not rely on the correctness of the results of find" (no debe confiarse en que los resultados de find sean correctos). Es posible que algunos puntos de partida, o algunas invocaciones pendientes de -exec ... {} +, no se hayan ejecutado en absoluto.

xargs es mucho más preciso sobre cómo falló el comando invocado:

Código	Significado
0	éxito (y los comandos que xargs ejecutó también terminaron con 0)
123	alguna invocación del comando terminó con un estado distinto de 0 y de 255
124	el comando terminó con estado 255 (xargs deja entonces de leer más entrada)
125	una señal mató al comando
126	el comando no se puede ejecutar (se encontró, pero no es ejecutable)
127	no se encontró el comando
1	ocurrió algún otro error (en el propio xargs)

El manual añade un detalle mecánico relevante para la creación de scripts: xargs lanza los comandos directamente con execvp(), no a través de un shell, de modo que "the shell's (128 + signal) convention for reporting that a process had been killed by a signal is not used by xargs" (la convención del shell de 128 + señal para indicar que un proceso fue terminado por una señal no la usa xargs). El 125 es el código propio de xargs para ese caso, no 128+señal.

Por qué importa

Un patrón habitual, find . -name '*.log' | xargs rm, combina el "algo falló en algún sitio" genérico de find con la escala específica de xargs. Un error de permisos en un subdirectorio hace que find termine con un valor distinto de cero (aunque haya pasado a xargs todos los archivos que sí pudo leer), mientras que un único archivo de destino ilegible que se pase a rm se manifestaría a través del 123 de xargs (salida distinta de cero ordinaria), y no a través del código de find. Ambos fallos se notifican de forma totalmente independiente, y un pipeline que solo comprueba el $? del último comando ve únicamente la mitad de la historia, la de xargs.

Cómo aplicarlo

• Después de find | xargs, comprueba ambos códigos de salida si el shell o el pipeline lo permiten (pipefail de bash junto con PIPESTATUS). Un find con salida distinta de cero junto con un xargs con 0 significa que algunos archivos nunca se listaron, sin aviso alguno.
• Trata la salida distinta de cero de find como "los resultados pueden estar incompletos", y no solo como "se registró un error". Vuelve a ejecutarlo con diagnósticos de -print/-ls o con puntos de partida más acotados para averiguar qué se omitió.
• En xargs, interpreta 126/127 como problemas de configuración (nombre o ruta del binario incorrectos) y 123/124/125 como problemas de invocaciones individuales de un comando que, por lo demás, es correcto.
• Usa find ... -print0 | xargs -0 ... cuando los nombres de archivo puedan contener espacios o saltos de línea, con independencia de la cuestión de los códigos de salida.

Trampas

• Suponer que el código de salida de find indica qué archivo o directorio falló. No lo indica; hay que inspeccionar su stderr.
• Suponer que el 125 de xargs sigue la numeración 128+señal del shell; el manual dice expresamente que no es así.