Linux Sabe Mais

Comandos, exemplos e soluções para o dia a dia.

BIBLIOTECA LINUX
741 tutoriais · 1406 exemplos
Documentação em português
Aprender Linux · passo a passo

O comando grep no Linux

Percebe a finalidade, lê a sintaxe e explora os exemplos antes de adaptares o comando ao teu sistema.

O que faz e quando utilizar

O comando grep seleciona linhas que correspondem a um padrão. Pode pesquisar em ficheiros ou na saída de outro programa e serve tanto para consultas simples como para expressões regulares.

Pesquisa simples. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

Como escrever o comando

grep [opções] padrão [ficheiro ...]

Os elementos entre [ ] são opcionais e as reticências indicam que um argumento pode repetir-se. Estes sinais explicam a estrutura: não são texto para escrever literalmente. Na secção seguinte encontras exemplos completos.

O nome grep identifica a ferramenta ou o interno da shell. As opções ajustam o comportamento; os restantes argumentos indicam os dados, nomes ou caminhos usados na operação.

Opções e elementos importantes

Opção ou elementoSignificado
-nAcrescenta o número da linha.
-iIgnora diferenças entre maiúsculas e minúsculas.
-rPercorre diretórios.
-FTrata o padrão como texto literal.
-EUsa expressões regulares estendidas.
-vSeleciona linhas que não correspondem.
-C númeroMostra linhas de contexto antes e depois.

Exemplos explicados

Começa pelos exemplos de consulta. Quando uma operação altera dados ou configurações, lê o aviso e confirma os argumentos antes de a executar.

1. Pesquisa simples

Pesquisa simples. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -n "ERROR" /var/log/messages
2. Ignorar maiúsculas

Ignorar maiúsculas. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -ni "error" /var/log/messages
3. Regex estendida

Regex estendida. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -En "ERROR|WARN" /var/log/messages
4. Recursivo

Recursivo. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -RIn "DB_HOST" /home/teste10/public_html
5. Apenas ficheiros

Apenas ficheiros. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -Rl "Listen" /etc/httpd
6. Inverter correspondência

Inverter correspondência. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -v "DEBUG" aplicacao.log
7. Palavra inteira

Palavra inteira. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -w "root" /etc/passwd
8. Texto literal

Texto literal. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -F "[ERROR]" aplicacao.log
9. Contexto

Contexto. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -C 3 "failed" /var/log/secure
10. Contagem

Contagem. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -c "ERROR" aplicacao.log
11. Ficheiros NUL

Ficheiros NUL. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -rlZ "TODO" /home/teste10/public_html
12. Múltiplos padrões

Múltiplos padrões. O padrão de pesquisa e os ficheiros são argumentos diferentes. Aspas simples protegem a expressão da interpretação da shell. O código de saída 0 indica correspondência, 1 indica ausência de resultados e 2 indica um erro de execução.

grep -e "ERROR" -e "WARN" aplicacao.log
13. Seleciona linhas que correspondem ao padrão

Seleciona linhas que correspondem ao padrão; por defeito o padrão é uma expressão regular básica.

grep 'padrão' ficheiro.txt

Como interpretar

Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.

14. Pesquisa o padrão nos ficheiros de uma árvore de pastas, percorrendo-a…

Pesquisa o padrão nos ficheiros de uma árvore de pastas, percorrendo-a recursivamente.

grep -r 'padrão' pasta/

Como interpretar

Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.

15. Seleciona linhas que contêm Nov em qualquer posição e respeita…

Seleciona linhas que contêm Nov em qualquer posição e respeita maiúsculas por defeito.

grep Nov /var/log/messages
16. Seleciona linhas que começam por Nov, pois ^ representa o início da linha

Seleciona linhas que começam por Nov, pois ^ representa o início da linha.

grep '^Nov' /var/log/messages
17. Seleciona linhas que contêm pelo menos um algarismo

Seleciona linhas que contêm pelo menos um algarismo; as aspas impedem expansão do padrão pela shell.

grep '[0-9]' /var/log/messages
18. Pesquisa Nov recursivamente sob /var/log

Pesquisa Nov recursivamente sob /var/log; alguns logs podem exigir privilégios ou conter dados binários.

grep -R 'Nov' /var/log/
19. Filtra texto e grava um novo resultado com >, substituindo o conteúdo…

Filtra texto e grava um novo resultado com >, substituindo o conteúdo anterior do destino.

Este exemplo altera dados ou o estado do sistema. Confirma origem, destino e permissões antes de o executar.

grep 'padrão' file1 > result.txt

Como interpretar

Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.

A redireção > pode truncar um ficheiro antes de o programa começar. Usa um nome de saída diferente da entrada para não perder os dados originais.

20. Filtra texto e acrescenta resultados com >>, preservando o conteúdo…

Filtra texto e acrescenta resultados com >>, preservando o conteúdo anterior do ficheiro.

Este exemplo altera dados ou o estado do sistema. Confirma origem, destino e permissões antes de o executar.

grep 'padrão' file1 >> result.txt

Como interpretar

Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.

>> acrescenta ao fim do ficheiro; > substitui o conteúdo anterior. A pasta de destino tem de permitir escrita.

21. Contar mensagens de erro diferentes

Mostra as dez linhas de erro mais frequentes no log.

grep -F 'ERRO' aplicacao.log | sort | uniq -c | sort -nr | head -n 10

Como interpretar

grep -F seleciona linhas que contêm o texto literal ERRO; não interpreta expressões regulares.

O primeiro sort junta linhas iguais. uniq -c conta repetições consecutivas; sem a ordenação anterior, a mesma mensagem poderia aparecer em vários grupos.

sort -nr ordena numericamente do maior para o menor e head -n 10 limita a apresentação. Diferenças em datas e IDs tornam linhas aparentemente semelhantes em mensagens distintas.

Erros frequentes e como os evitar

  • Um padrão de expressão regular não é a mesma coisa que texto literal; para literal usa -F.
  • Ausência de correspondências produz normalmente estado 1, não um erro de sintaxe.

Uma forma de praticar

Escolhe um dos exemplos acima e identifica o programa, cada opção e os argumentos. Explica por palavras tuas qual deverá ser o resultado. Se faltar um ficheiro, pacote ou dispositivo, resolve primeiro esse requisito; não acrescentes privilégios apenas para tentar eliminar uma mensagem de erro.

Testa primeiro uma variante de consulta, usando ficheiros de ensaio quando fizer sentido. Compara o resultado com a explicação e só depois acrescenta outra opção, para perceberes o efeito de cada alteração.