Visualizar e processar texto

Comando tee

Grave a saída num ficheiro e deixe-a no terminal

Linux · Exemplos de Bash · comandos executados no servidor seleccionado

Quando utilizar tee

Utilize tee para inspecionar a saída do comando enquanto guarda uma cópia. Seja explícito sobre se um relatório deve substituir um ficheiro antigo ou anexá-lo e lembre-se de que os privilégios da shell se aplicam separadamente a cada processo de pipeline.

Sintaxe

tee [OPTIONS] [FILE...]

Os colchetes marcam argumentos opcionais; uma reticência significa repetição. Substitua exemplos de nomes de ficheiros, nomes de utilizadores e endereços de servidores pelos seus próprios valores.

Opções e argumentos comuns

-a
Anexar ao ficheiro em vez de sobrescrever.
-i
Ignore o sinal de interrupção SIGINT.
--
Finalizar análise de opções.

Exemplos de uso

Guardar e mostrar resultado

df -h | tee ./disk-report.txt

O relatório do disco aparece no terminal e substitui o ficheiro de relatório nomeado.

Adicionar entrada

printf '%s\n' 'check complete' | tee -a ./checks.log

A mensagem de verificação é anexada ao registo sem substituir as linhas existentes.

Grave uma saída em dois ficheiros

printf '%s\n' 'ready' | tee ./one.txt ./two.txt

O mesmo fluxo é gravado em dois ficheiros separados e também apresentado.

Notas e limitações

  • Por defeito, os ficheiros de destino são reiniciados; -a guarda os dados existentes.
  • tee não garante o sucesso de toda a cadeia: em Bash, utilize pipefail se os erros de comandos anteriores forem importantes.

Perguntas comuns e resolução de problemas

Porque é que o sudo antes do primeiro comando não permite a escrita?

Cada processo tem as suas próprias permissões. Elevar o produtor não eleva tee; conceda apenas a permissão necessária ao processo de escrita.

Um relatório pode conter apenas parte da saída de um comando com falha?

Sim. Um pipeline pode criar saída antes de uma falha upstream. Verifique os estados de saída relevantes e capte o erro padrão separadamente quando necessário.

Mais ajuda

As opções variam de acordo com a versão e distribuição. Verifique a documentação instalada com este comando: man tee.