Códigos de saída de find e xargs: o 0/>0 grosseiro do find versus a escala 123-127 do xargs

O que é

O manual do próprio find é propositalmente vago sobre qualquer coisa além de um 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." (o find termina com status 0 se todos os arquivos foram processados com sucesso e com valor maior que 0 se ocorrerem erros; essa é, deliberadamente, uma descrição muito ampla). O manual acrescenta uma ressalva realmente importante: quando a saída é diferente de zero, "you should not rely on the correctness of the results of find" (não se deve confiar na correção dos resultados do find). Alguns pontos de partida, ou algumas invocações pendentes de -exec ... {} +, podem nem ter sido executados.

Já o xargs é bem mais específico sobre como o comando invocado falhou:

Código	Significado
0	sucesso (e todos os comandos executados pelo xargs também terminaram com 0)
123	alguma invocação do comando terminou com status diferente de 0 e de 255
124	o comando terminou com status 255 (o xargs então para de ler a entrada)
125	o comando foi morto por um sinal
126	o comando não pode ser executado (encontrado, mas não executável)
127	o comando não foi encontrado
1	ocorreu algum outro erro (no próprio xargs)

O manual acrescenta um detalhe mecânico relevante para scripts: os comandos executados pelo xargs são lançados diretamente com execvp(), sem passar por um shell. Por isso "the shell's (128 + signal) convention for reporting that a process had been killed by a signal is not used by xargs" (a convenção do shell, 128 + sinal, para indicar que um processo foi morto por um sinal não é usada pelo xargs). O 125 é o código próprio do xargs para esse caso, não 128+sinal.

Por que importa

Um padrão comum, find . -name '*.log' | xargs rm, mistura o "algo deu errado em algum lugar" grosseiro do find com a escala específica do xargs. Um erro de permissão em um subdiretório faz o find terminar com valor não zero (mas ele ainda entrega ao xargs todos os arquivos que conseguiu ler). Já um único arquivo de destino ilegível passado ao rm aparece pelo 123 do próprio xargs (saída não zero comum), e não pelo código do find. As duas falhas são reportadas de forma totalmente independente, e um pipeline que verifica apenas o $? do último comando enxerga só a metade do xargs.

Como aplicar

• Depois de find | xargs, verifique os dois códigos de saída se o shell ou o pipeline permitir (no bash, pipefail mais PIPESTATUS). Um find com saída não zero junto com um xargs com saída zero significa que alguns arquivos nunca foram listados, sem nenhum aviso.
• Trate a saída não zero do find como "os resultados podem estar incompletos", e não apenas como "um erro foi registrado". Execute de novo com diagnósticos de -print/-ls ou com pontos de partida mais restritos para descobrir o que foi ignorado.
• No xargs, trate 126/127 como problemas de configuração (nome ou caminho do binário errado) e 123/124/125 como problemas em invocações individuais de um comando que, de resto, está correto.
• Use find ... -print0 | xargs -0 ... quando os nomes de arquivo puderem conter espaços ou quebras de linha, independentemente da questão dos códigos de saída.

Armadilhas

• Supor que o código de saída do find indica qual arquivo ou diretório falhou. Não indica; é preciso inspecionar o stderr.
• Supor que o 125 do xargs segue a numeração 128+sinal do shell. O manual diz explicitamente que não segue.