xargs na Prática: Convertendo Entrada Padrão em Argumentos de Comando

2026-05-21 Tempo de leitura: Cerca de 10 min Dificuldade: Intermediário+

O Que Você Vai Aprender

• Como usar o xargs corretamente para conectar comandos que não leem do stdin (rm, mv, cp, etc.)
• Como evitar o desastre clássico onde find | xargs rm quebra em nomes de arquivo com espaços
• Como usar -I {}, -n e -P para substituição de placeholder, lotes e execução paralela

O Que É o xargs e Por Que Você Precisa Dele?

xargs lê da entrada padrão e constrói uma lista de argumentos para outro comando. Pipes só podem alimentar stdout para stdin, então comandos que esperam nomes de arquivo como argumentos (como rm, mv, cp) não funcionam se você simplesmente redirecionar para eles.

# Errado: rm nao le nomes de arquivo do stdin (nada e deletado, ou erro)
find . -name "*.tmp" | rm

# Correto: xargs converte stdin em argumentos para rm
find . -name "*.tmp" | xargs rm

1. Uso Básico: Construindo Argumentos a Partir de um Pipe

$ echo "a b c" | xargs echo
a b c

xargs divide o stdin em espaços/quebras de linha e alimenta o resultado para o próximo comando como argumentos.

1-1. O Combo Clássico com find

$ find . -name "*.log" | xargs ls -lh

Passa cada arquivo que o find descobre como argumento para ls -lh.

1-2. Evitando ARG_MAX com Grandes Conjuntos de Arquivos

A expansão glob do shell (ls *.log) atinge o limite ARG_MAX, mas o xargs divide a chamada automaticamente.

# Funciona mesmo com centenas de milhares de arquivos -- sem "Argument list too long"
$ find /var/log -name "*.gz" | xargs gzip -t

2. Por Que Você Precisa de -print0 e -0

Se nomes de arquivo contiverem espaços, tabulações, quebras de linha ou aspas, o xargs padrão os dividirá incorretamente. Esta é a maior fonte de desastres com xargs.

2-1. O Exemplo Perigoso

# Um arquivo chamado "my file.txt" e dividido pelo espaco e xargs tenta
# deletar dois arquivos: "my" e "file.txt"
$ find . -name "*.txt" | xargs rm

2-2. O Padrão Seguro: Par de Separadores NUL

$ find . -name "*.txt" -print0 | xargs -0 rm

• find -print0: separa a saída com NUL (\0)
• xargs -0: trata NUL como o separador

NUL é o único caractere que não pode aparecer em um nome de arquivo, então a divisão é garantida.

2-3. O Mesmo se Aplica ao grep -l / grep -rl

# Perigoso
$ grep -rl "TODO" . | xargs sed -i 's/TODO/DONE/g'

# Seguro
$ grep -rlZ "TODO" . | xargs -0 sed -i 's/TODO/DONE/g'

grep -Z também emite saída separada por NUL. Combine grep -rlZ com xargs -0.

3. O Placeholder -I {}: Inserir Argumentos em Qualquer Lugar

Por padrão, xargs adiciona argumentos no final. Use -I {} quando precisar deles no meio (ou em múltiplas posições).

3-1. Por Que Adicionar no Final Não É Suficiente

# Errado: mv espera "origem destino", mas adicionar no final quebra a ordem
$ ls *.bak | xargs mv archive/
# torna-se: mv archive/ file1.bak file2.bak ...  (trata archive/ como origem)

3-2. Especifique a Posição com -I {}

$ ls *.bak | xargs -I {} mv {} archive/
# expande para:
#   mv file1.bak archive/
#   mv file2.bak archive/
#   (uma execucao por linha de entrada)

{} é substituído por cada linha de entrada individualmente.

3-3. Múltiplas Substituições Também Funcionam

$ cat hosts.txt | xargs -I {} ssh {} "hostname && uptime"

4. Controlando Tamanho do Lote e Paralelismo com -n / -P

4-1. -n N: Passar N Argumentos por Vez

$ seq 1 10 | xargs -n 3 echo
1 2 3
4 5 6
7 8 9
10

echo é invocado uma vez por grupo de três.

4-2. -P N: Executar N Processos em Paralelo

# Verificar arquivos .gz com 4 workers paralelos
$ find . -name "*.gz" -print0 | xargs -0 -n 1 -P 4 gzip -t

• -n 1: um item por invocação
• -P 4: até 4 processos simultâneos

-P 0 significa "tantos quanto o número de núcleos da CPU" (extensão GNU). Uma forma simples de acelerar trabalho limitado por CPU.

5. Segurança: -r / -t / -p

5-1. -r: Pular Execução com Entrada Vazia (quase sempre necessário)

# Perigoso: rm pode ser chamado mesmo se find nao encontrou nada
$ find . -name "nonexistent" | xargs rm

# Seguro: nao faz nada com entrada vazia
$ find . -name "nonexistent" | xargs -r rm

GNU xargs passa entrada vazia por padrão, o que --no-run-if-empty (-r) suprime. BSD xargs (macOS) pula entrada vazia por padrão, então ser explícito com -r melhora a portabilidade.

5-2. -t: Imprimir o Comando Antes de Executá-lo

$ find . -name "*.log" | xargs -t rm
rm ./access.log ./error.log

-t ecoa o comando montado no stderr antes da execução. Ele ainda executa o comando -- use o truque do echo abaixo para um dry-run real.

5-3. O Truque do echo: Um Dry-Run Real

# Imprima o que seria executado sem realmente executar
$ find . -name "*.tmp" -print0 | xargs -0 echo rm
rm ./a.tmp ./b.tmp ./c.tmp

Prefixar com echo transforma o comando montado em mera saída. Remova o echo quando estiver confiante.

5-4. -p: Confirmar Cada Invocação Interativamente

$ find . -name "*.tmp" -print0 | xargs -0 -p rm
rm ./a.tmp ./b.tmp ?...y

Executa apenas quando você digita y. Útil para operações sensíveis.

6. xargs vs find -exec: Quando Usar Qual?

find sozinho pode fazer coisas semelhantes com -exec. Qual escolher?

6-1. Se o find Sozinho É Suficiente, Use -exec

# Simples e seguro
$ find . -name "*.tmp" -exec rm {} +

-exec ... + faz lotes internamente e lida com espaços corretamente sem -print0.

6-2. Escolha xargs Quando

• Você precisa de entrada de algo além do find (ex.: grep -l, ls, cat list.txt)
• Você quer execução paralela (-P) para ganho de velocidade
• Você está combinando múltiplos comandos em um pipeline

7. Modelos Práticos

# 1. Deletar muitos arquivos (seguro para espacos)
find /tmp -name "*.cache" -mtime +7 -print0 | xargs -0 -r rm

# 2. Mover arquivos de uma lista (placeholder)
cat filelist.txt | xargs -I {} mv {} /archive/

# 3. Comprimir arquivos em paralelo (4 workers)
find . -name "*.log" -print0 | xargs -0 -n 1 -P 4 gzip

# 4. Substituicao de texto em massa em arquivos
grep -rlZ "old-string" ./src | xargs -0 sed -i 's/old-string/new-string/g'

# 5. SSH paralelo para multiplos hosts
cat hosts.txt | xargs -I {} -P 8 ssh {} "uptime"

# 6. Dry-run antes de executar de verdade
find . -name "*.bak" -print0 | xargs -0 echo rm