Informações genéricas do programa¶

--help

Emite uma mensagem de uso e sai.

-V, --version

Mostra o número de versão do grep e sai.

Seleção de coincidência¶

-E, --extended-regexp

Interpreta PADRÕES como expressões regulares estendidas (EREs, veja abaixo).

-F, --fixed-strings

Interpreta PADRÕES como textos fixos, não como expressões regulares.

-G, --basic-regexp

Interpreta PADRÕES como expressões regulares básicas (BREs, veja abaixo). Esse é o padrão.

-P, --perl-regexp

Interpreta PADRÕES como expressões regulares compatíveis com Perl (PCREs). Essa opção é experimental quando combinada com a opção -z (--null-data) e grep -P pode avisar sobre recursos não implementados.

Controle de coincidências¶

-e PADRÕES, --regexp=PADRÕES

Usa PADRÕES como os padrões. Se esta opção for usada várias vezes ou for combinada com a opção -f (--file), pesquisa por todos os padrões fornecidos. Esta opção pode ser usada para proteger um padrão começando com “-”.

-f ARQUIVO, --file=ARQUIVO

Obtém padrões de ARQUIVO, um por linha. Se esta opção for usada várias vezes ou for combinada com a opção -e (--regexp), pesquisa todos os padrões fornecidos. O arquivo vazio contém zero padrões e, portanto, não coincide com nada.

-i, --ignore-case

Ignora as distinções entre maiúsculas e minúsculas, para que os caracteres que diferem apenas no caso coincidam um com o outro.

-v, --invert-match

Inverte o sentido de coincidência, para selecionar linhas que não coincidem.

-w, --word-regexp

Seleciona apenas as linhas que coincidem formando palavras inteiras. O teste é que a parte de texto coincidente deve estar no início da linha ou precedida por um caractere que não seja de palavra. Da mesma forma, ele deve estar no final da linha ou ser seguido por um caractere que não seja de palavra. Os caracteres constituintes da palavra são letras, dígitos e o sublinhado. Esta opção não tem efeito se -x também estiver especificado.

-x, --line-regexp

Seleciona apenas as partes de texto que coincidem exatamente com a linha inteira. Para um padrão de expressão regular, é como colocar parênteses no padrão e depois envolvê-lo com ^ e $.

-y

Sinônimo obsoleto para -i.

Controle geral de saída¶

-c, --count

Inibe saída normal; em vez disso, emite uma contagem de linhas que coincidam a cada arquivo de entrada. Com a opção -v, --invert-match (veja acima), conta linhas que não coincidem.

--color[=QUANDO], --colour[=QUANDO]

Coloca os textos que coincidem (não vazios), as linhas que coincidem, as linhas de contexto, os nomes dos arquivos, os números das linhas, os posições de bytes e os separadores (para campos e grupos de linhas de contexto) com sequências de escape para exibi-las em cores no terminal. As cores são definidas pela variável de ambiente GREP_COLORS. A variável de ambiente obsoleta GREP_COLOR ainda é suportada, mas sua configuração não tem prioridade. QUANDO é never, always ou auto.

-L, --files-without-match

Inibe saída normal; em vez disso, emite o nome de cada arquivo de entrada do qual normalmente nenhuma saída seria emitida. A varredura será interrompida na primeira coincidência.

-l, --files-with-matches

Inibe saída normal; em vez disso, emite o nome de cada arquivo de entrada do qual normalmente alguma saída seria emitida. A varredura será interrompida na primeira coincidência.

-m NÚM, --max-count=NÚM

Interrompe a leitura um arquivo depois de NÚM ocorrências. Se a entrada for uma entrada padrão de um arquivo comum e NÚM ocorrências forem exibidas, grep garantirá que a entrada padrão seja posicionada logo após a última ocorrência antes de sair, independentemente da presença de linhas de contexto à direita. Isso permite que um processo de chamada retome uma pesquisa. Quando grep interrompe após NÚM ocorrências, ele exibe quaisquer linhas de contexto ao final. Quando a opção -c ou --count também é usada, grep não gera uma contagem maior que NÚM. Quando a opção -v ou --invert-match também é usada, grep interrompe após a saída de NÚM linhas não coincidentes.

-o, --only-matching

Emite apenas as partes coincidentes (não vazias) de uma ocorrência, com cada uma dessas partes em uma linha de saída separada.

-q, --quiet, --silent

Quieto; não escreve nada na saída padrão. Sai imediatamente com o status zero se alguma coincidente for encontrada, mesmo que um erro tenha sido detectado. Consulte também a opção -s ou --no-messages.

-s, --no-messages

Inibe mensagens de erro sobre arquivos inexistentes ou ilegíveis.

Controle de prefixo de linha de saída¶

-b, --byte-offset

Emite a posição de byte baseada em 0 no arquivo de entrada antes de cada linha de saída. Se -o (--only-matching) for especificado, emite a posição da própria parte coincidente.

-H, --with-filename

Emite o nome do arquivo para cada coincidência. Esse é o padrão quando há mais de um arquivo para pesquisar.

-h, --no-filename

Inibe a prefixação dos nomes dos arquivos na saída. Esse é o padrão quando há apenas um arquivo (ou apenas entrada padrão) para pesquisar.

--label=RÓTULO

Exibe a entrada proveniente da entrada padrão como uma entrada proveniente do RÓTULO de arquivo. Isso é especialmente útil ao implementar ferramentas como zgrep, por exemplo, gzip -cd foo.gz | grep --label=foo -H algo. Veja também a opção -H.

-n, --line-number

Prefixa cada linha de saída com o número da linha com base em 1 em seu arquivo de entrada.

-T, --initial-tab

Verifica se o primeiro caractere do conteúdo real da linha está em uma parada de tabulação, para que o alinhamento das tabulações pareça normal. Isso é útil com opções que prefixam sua saída para o conteúdo real: -H, -n e -b. Para aumentar a probabilidade de que as linhas de um único arquivo sejam iniciadas na mesma coluna, isso também faz com que o número da linha e a posição de bytes (se houver) sejam emitidos em uma largura de campo de tamanho mínimo.

-u, --unix-byte-offsets

Relata posições de bytes no estilo Unix. Essa opção faz com que grep relate posições de bytes como se o arquivo fosse um arquivo de texto no estilo Unix, ou seja, com caracteres CR removidos. Isso produzirá resultados idênticos aos da execução de grep em uma máquina Unix. Esta opção não tem efeito, a menos que a opção -b também seja usada; não tem efeito em plataformas diferentes de MS-DOS e MS-Windows.

-Z, --null

Emite um byte zero (o caractere ASCII NUL) em vez do caractere que normalmente segue um nome de arquivo. Por exemplo, grep -lZ gera um byte zero após cada nome de arquivo, em vez da nova linha usual. Essa opção torna a saída inequívoca, mesmo na presença de nomes de arquivos contendo caracteres incomuns, como novas linhas. Essa opção pode ser usada com comandos como find -print0, perl -0, sort -z e xargs -0 para processar nomes de arquivos arbitrários, mesmo aqueles que contêm caracteres de nova linha.

Controle de linha de contexto¶

-A NÚM, --after-context=NÚM

Emite NÚM linhas de contexto à direita após as ocorrências. Coloca uma linha que contém um separador de grupo (--) entre grupos contíguos de coincidências. Com a opção -o ou --only-matching, isso não tem efeito e um aviso é dado.

-B NÚM, --before-context=NÚM

Emite NÚM linhas de contexto no início antes das ocorrências. Coloca uma linha que contém um separador de grupo (--) entre grupos contíguos de coincidências. Com a opção -o ou --only-matching, isso não tem efeito e um aviso é dado.

-C NÚM, -NÚM, --context=NÚM

Emite NÚM linhas de saída do contexto. Coloca uma linha que contém um separador de grupo (--) entre grupos contíguos de coincidências. Com a opção -o ou --only-matching, isso não tem efeito e um aviso é dado.

Seleção de arquivo e diretório¶

-a, --text

Processa um arquivo binário como se fosse texto; isso é equivalente à opção --binary-files=text.

--binary-files=TIPO

Se os dados ou metadados de um arquivo indicarem que o arquivo contém dados binários, supõe que o arquivo seja do tipo TIPO. Bytes sem texto indicam dados binários; esses são bytes de saída codificados incorretamente para o código do idioma atual ou bytes de entrada nulos quando a opção -z não é fornecida.

Por padrão, TIPO é binary, e quando grep descobre que um arquivo é binário, inibe qualquer saída adicional e, em vez disso, gera uma mensagem de uma linha dizendo que um arquivo binário coincide ou nenhuma mensagem se não houver coincidência.

Se TIPO for without-match, quando grep descobre que um arquivo é binário, ele presume que o restante do arquivo não coincide; isso é equivalente à opção -I.

Se TIPO for text, grep processa um arquivo binário como se fosse texto; isso é equivalente à opção -a.

Quando tipo é binary, grep pode tratar bytes, que não sejam de texto, como terminadores de linha, mesmo sem a opção -z. Isso significa que escolher binary em vez de text pode afetar se um padrão coincide com um arquivo. Por exemplo, quando tipo é binary, o padrão q$ might coincide com q imediatamente seguido por um byte nulo, mesmo que isso não coincida quando tipo é text. Por outro lado, quando tipo é binary, o padrão . (ponto) pode não coincidir a um byte nulo.

Aviso: A opção -a pode gerar lixo binário, que pode ter efeitos colaterais desagradáveis se a saída for um terminal e se o driver do terminal interpretar alguns deles como comandos. Por outro lado, ao ler arquivos cujas codificações de texto são desconhecidas, pode ser útil usar -a ou definir LC_ALL='C' no ambiente, para encontrar ocorrências, mesmo que estas não sejam seguras para exibição direta.

-D AÇÃO, --devices=AÇÃO

Se um arquivo de entrada for um dispositivo, FIFO ou soquete, usa AÇÃO para processá-lo. Por padrão, AÇÃO é read, o que significa que os dispositivos são lidos como se fossem arquivos comuns. Se AÇÃO for skip, os dispositivos serão ignorados silenciosamente.

-d AÇÃO, --directories=AÇÃO

Se um arquivo de entrada for um diretório, usa AÇÃO para processá-lo. Por padrão, AÇÃO é read, ou seja, lê os diretórios como se fossem arquivos comuns. Se AÇÃO for skip, pula silenciosamente os diretórios. Se AÇÃO for recurse, lê todos os arquivos em cada diretório, recursivamente, seguindo os links simbólicos apenas se estiverem na linha de comando. Isso é equivalente à opção -r.

--exclude=GLOB

Pula qualquer arquivo de linha de comando com um sufixo de nome que coincida com o padrão GLOB, usando coincidência de curinga; um sufixo de nome é o nome inteiro ou qualquer sufixo iniciando após um / e antes de um não /. Ao pesquisar recursivamente, pule qualquer subarquivo cujo nome base coincida com GLOB; o nome base é a parte após a última /. Um padrão pode usar *, ? e [...] como curingas e \ para colocar entre aspas um caractere curinga ou barra invertida literalmente.

--exclude-from=ARQUIVO

Ignora arquivos cujo nome base coincide com qualquer um dos globs de nome de arquivo lidos em ARQUIVO (usando a coincidência curinga conforme descrito em --exclude).

--exclude-dir=GLOB

Pula qualquer diretório da linha de comandos com um sufixo de nome que coincida com o padrão GLOB. Ao pesquisar recursivamente, pula qualquer subdiretório cujo nome base coincida com GLOB. Ignora as barras finais redundantes em GLOB.

-I

Processa um arquivo binário como se não contivesse dados de coincidência isso é equivalente à opção --binary-files=without-match.

--include=GLOB

Pesquisa apenas arquivos cujo nome base coincida com GLOB (usando a coincidência curinga conforme descrito em --exclude).

-r, --recursive

Lê todos os arquivos em cada diretório, recursivamente, seguindo os links simbólicos apenas se estiverem na linha de comando. Observe que, se nenhum operando de arquivo for fornecido, o grep pesquisará o diretório de trabalho. Isso é equivalente à opção -d recurse.

-R, --dereference-recursive

Lê todos os arquivos em cada diretório, recursivamente. Segue todos os links simbólicos, ao contrário de -r.

Outras opções¶

--line-buffered

Usa buffer de linha na saída. Isso pode causar uma penalidade de desempenho.

-U, --binary

Trata os arquivos como binários. Por padrão, em MS-DOS e MS-Windows, grep calcula se um arquivo é texto ou binário, conforme descrito para a opção --binary-files. Se grep decidir que o arquivo é um arquivo de texto, ele remove os caracteres CR do conteúdo original do arquivo (para fazer expressões regulares com ^ e $ funcionarem corretamente). A especificação de -U anula essas suposições, fazendo com que todos os arquivos sejam lidos e passados para o mecanismo de coincidência literalmente; se o arquivo for um arquivo de texto com pares CR/LF no final de cada linha, isso fará com que algumas expressões regulares falhem. Esta opção não tem efeito em plataformas diferentes do MS-DOS e MS-Windows.

-z, --null-data

Trata os dados de entrada e saída como sequências de linhas, cada uma terminada por um byte zero (o caractere ASCII NUL) em vez de uma nova linha. Como a opção -Z ou --null, esta opção pode ser usada com comandos como sort -z para processar nomes de arquivos arbitrários.

Classes de caracteres e expressões entre colchetes¶

Dentro de uma expressão entre colchetes, uma expressão de intervalo consiste em dois caracteres separados por um hífen. Coincide com qualquer caractere único que classifique entre os dois caracteres, inclusive, usando a sequência de agrupamento e o conjunto de caracteres da localidade. Por exemplo, no código de idioma C padrão, [a-d] é equivalente a [abcd]. Muitos códigos de idioma classificam caracteres na ordem do dicionário e, nesses locais, [a-d] normalmente não é equivalente a [abcd]; pode ser equivalente a [aBbCcDd], por exemplo. Para obter a interpretação tradicional de expressões entre colchetes, você pode usar o código de idioma C configurando a variável de ambiente LC_ALL para o valor C.

Finalmente, certas classes nomeadas de caracteres são predefinidas nas expressões entre colchetes, da seguinte maneira. Seus nomes são autoexplicativos e são [:alnum:], [:alpha:], [:cntrl:], [:digit:], [:graph:], [:lower:], [:print:], [:punct:], [:space:], [:upper:] e [:xdigit:]. Por exemplo, [[:alnum:]] significa a classe de caracteres de números e letras no local atual. Na localidade C e na codificação do conjunto de caracteres ASCII, é igual a [0-9A-Za-z]. (Observe que os colchetes nesses nomes de classe fazem parte dos nomes simbólicos e devem ser incluídos além dos colchetes que delimitam a expressão entre colchetes.) A maioria dos metacaracteres perde seu significado especial nas expressões entre colchetes. Para incluir um ] literal, coloque-o primeiro na lista. Da mesma forma, para incluir um ^ literal, coloque-o em qualquer lugar, exceto primeiro. Finalmente, para incluir um literal -, coloque-o por último.

Ancoragem¶

O caractere de barra invertida e expressões especiais¶

Repetição¶

?

O item anterior é opcional e coincide com o máximo uma vez.

*

O item anterior coincidirá com zero ou mais vezes.

+

O item anterior coincidirá com uma ou mais vezes.

{n}

O item anterior é coincidido exatamente n vezes.

{n,}

O item anterior é coincidido a n ou mais vezes.

{,m}

O item anterior é coincidido no máximo m vezes. Esta é uma extensão GNU.

{n,m}

O item anterior é coincidido pelo menos n vezes, mas não mais que m vezes.

Concatenação¶

Alternação¶

Precedência¶

Retrorreferências e subexpressões¶

Expressões regulares básicas vs estendidas¶

Relatando erros¶

Erros conhecidos¶

As retrorreferências são muito lentas e podem exigir tempo exponencial.

Páginas de manual comuns¶

Página de Manual do Programador do POSIX¶

Documentação completa¶

info grep

deve lhe dar acesso ao manual completo.