OPÇÕES POSICIONAIS¶

-daystart

Mede tempos (para -amin, -atime, -cmin, -ctime, -mmin e -mtime) desde o início de hoje e não 24 horas atrás. Esta opção afeta apenas os testes que aparecem mais tarde na linha de comando.

-follow

Descontinuada; use a opção -L. Desreferencia links simbólicos. Implica -noleaf. A opção -follow afeta apenas os testes que aparecem depois na linha de comando. A menos que a opção -H ou -L tenha sido especificada, a posição da opção -follow altera o comportamento do predicado -newer; todos os arquivos listados como argumento de -newer serão desreferenciados se forem links simbólicos. A mesma consideração se aplica a -newerXY, -anewer e -cnewer. Da mesma forma, o predicado -type sempre corresponderá ao tipo de arquivo ao qual um link simbólico aponta, em vez do próprio link. Usar -follow faz com que os predicados -lname e -ilname sempre retornem falso.

-regextype tipo

Altera a sintaxe da expressão regular entendida pelos testes -regex e -iregex que ocorrem posteriormente na linha de comando. Para ver quais tipos de expressão regular são conhecidos, use -regextype help. A documentação do Texinfo (consulte VEJA TAMBÉM) explica o significado e as diferenças entre os vários tipos de expressão regular.

-warn, -nowarn

Ativa ou desativa as mensagens de aviso. Esses avisos se aplicam apenas ao uso da linha de comando, não a quaisquer condições que find ao encontrar diretórios. O comportamento padrão corresponde a -warn se a entrada padrão for um tty e a -nowarn caso contrário. Se uma mensagem de aviso relacionada ao uso da linha de comandos for produzida, o status de saída de find não será afetado. Se a variável de ambiente POSIXLY_CORRECT estiver configurada e -warn também for usado, não será especificado quais avisos, se houver algum, estarão ativos.

OPÇÕES GLOBAIS¶

As opções globais ocorrem após a lista de pontos de início e, portanto, não são o mesmo tipo de opção que -L, por exemplo.

-d

Um sinônimo para -depth, para compatibilidade com FreeBSD, NetBSD, MacOS X e OpenBSD.

-depth

Processa o conteúdo de cada diretório antes do próprio diretório. A ação de -delete também implica em -depth.

-help, --help

Imprime um resumo do uso da linha de comando de find e sai.

-ignore_readdir_race

Normalmente, find emite uma mensagem de erro quando falha ao declarar um arquivo. Se você der essa opção e um arquivo for excluído entre o momento em que find lê o nome do arquivo no diretório e o momento em que ele tenta estatizá-lo, nenhuma mensagem de erro será emitida. Isso também se aplica a arquivos ou diretórios cujos nomes são dados na linha de comando. Essa opção entra em vigor no momento em que a linha de comando é lida, o que significa que você não pode procurar uma parte do sistema de arquivos com essa opção ativada e outra parte com esta opção desativada (se precisar fazer isso, será necessário emitir dois comandos find em vez disso, um com a opção e outro sem ela).

Além disso, find com a opção -ignore_readdir_race ignorará os erros da ação -delete caso o arquivo tenha desaparecido desde que o diretório pai foi lido: ele não emitirá um diagnóstico de erro e o retorno o código da ação -delete será verdadeiro.

-maxdepth níveis

Desce no máximo níveis (um número inteiro não negativo) de diretórios abaixo dos pontos de partida. -maxdepth 0 significa aplicar apenas os testes e ações aos próprios pontos de partida.

-mindepth níveis

Não aplica nenhum teste ou ação em níveis inferiores a níveis (um número inteiro não negativo). -mindepth 1 significa processar todos os arquivos, exceto os pontos de partida.

-mount

Não desce diretórios em outros sistemas de arquivos. Um nome alternativo para -xdev, para compatibilidade com outras versões do find.

-noignore_readdir_race

Desativa o efeito de -ignore_readdir_race.

-noleaf

Não otimiza presumindo que os diretórios contenham 2 subdiretórios a menos do que a contagem de links físicos. Essa opção é necessária ao pesquisar sistemas de arquivos que não seguem a convenção de link de diretório Unix, como sistemas de arquivos CD-ROM ou MS-DOS ou pontos de montagem de volume do AFS. Cada diretório em um sistema de arquivos Unix normal possui pelo menos 2 links físicos: seu nome e sua entrada ".". Além disso, seus subdiretórios (se houver) possuem uma entrada ".." vinculada a esse diretório. Quando find está examinando um diretório, depois de declarar 2 subdiretórios a menos que a contagem de links do diretório, ele sabe que o restante das entradas no diretório são não-diretórios (arquivos "folhas" na árvore de diretórios). Se apenas os nomes dos arquivos precisam ser examinados, não há necessidade de especificá-los; isso proporciona um aumento significativo na velocidade da pesquisa.

-version, --version

Imprime o número de versão do find e sai.

-xdev

Não desce diretórios em outros sistemas de arquivos.

TESTES¶

Argumentos numéricos podem ser especificados como

+n

para maior que n,

-n

para menor que n,

n

para exatamente n.

-amin n

O arquivo foi acessado pela última vez há n minutos.

-anewer arquivo

O arquivo foi acessado pela última vez mais recentemente do que arquivo foi modificado. Se arquivo for um link simbólico e a opção -H ou -L estiver em vigor, o tempo de acesso do arquivo para o qual ele aponta será sempre utilizado.

-atime n

Último arquivo acessado há n*24 horas atrás. Quando find descobre quantos períodos de 24 horas atrás o arquivo foi acessado pela última vez, qualquer parte fracionária será ignorada; portanto, para combinar -atime +1, um arquivo deve ter sido acessado pelo menos dois dias atrás.

-cmin n

O status do arquivo foi alterado pela última vez há n minutos.

-cnewer arquivo

O status do arquivo foi alterado pela última vez mais recentemente do que arquivo foi modificado. Se arquivo for um link simbólico e a opção -H ou -L estiver em vigor, o tempo de mudança de status do arquivo para o qual ele aponta é sempre usado.

-ctime n

O status do arquivo foi alterado pela última vez há n*24 horas. Consulte os comentários para -atime para entender como o arredondamento afeta a interpretação dos tempos de alteração do status do arquivo.

-empty

O arquivo está vazio e é um arquivo comum ou um diretório.

-executable

Corresponde a arquivos executáveis e diretórios pesquisáveis (no sentido da resolução do nome do arquivo) pelo usuário atual. Isso leva em consideração as listas de controle de acesso e outros artefatos de permissões que o teste -perm ignora. Este teste utiliza a chamada de sistema access(2) e, portanto, pode ser enganado por servidores NFS que fazem o mapeamento de UID (ou esmagamento da raiz), pois muitos sistemas implementam access(2) no kernel do cliente e, portanto, não pode fazer uso das informações de mapeamento do UID mantidas no servidor. Como esse teste é baseado apenas no resultado da chamada do sistema access(2), não há garantia de que um arquivo para o qual esse teste seja bem-sucedido possa realmente ser executado.

-false

Sempre falso.

-fstype tipo

O arquivo está em um sistema de arquivos do tipo tipo. Os tipos de sistema de arquivos válidos variam entre diferentes versões do Unix; uma lista incompleta de tipos de sistemas de arquivos que são aceitos em alguma versão do Unix ou em outra é: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. Você pode usar -printf com a diretiva %F para ver os tipos de seus sistemas de arquivos.

-gid n

O ID numérico do grupo do arquivo é n.

-group nome-grupo

O arquivo pertence ao grupo nome-grupo (ID numérico do grupo permitido).

-ilname padrão

Como -lname, mas a correspondência não diferencia maiúsculas de minúsculas. Se a opção -L ou -follow estiver em vigor, esse teste retornará false, a menos que o link simbólico esteja quebrado.

-iname padrão

Como -name, mas a correspondência não diferencia maiúsculas de minúsculas. Por exemplo, os padrões "fo*" e "F??" correspondem aos nomes de arquivo "Foo" , "FOO", "foo", "fOo" etc. O padrão "*foo*" também corresponderá a um arquivo chamado ".foobar".

-inum n

O arquivo possui o número de nó-i n. Normalmente, é mais fácil usar o teste -samefile.

-ipath padrão

Como -path, mas a correspondência não diferencia maiúsculas de minúsculas.

-iregex padrão

Como -regex, mas a correspondência não diferencia maiúsculas de minúsculas.

-iwholename padrão

Veja -ipath. Esta alternativa é menos portátil que -ipath.

-links n

O arquivo possui n links físicos.

-lname padrão

O arquivo é um link simbólico cujo conteúdo corresponde ao padrão de shell padrão. Os metacaracteres não tratam "/" ou "." em especial. Se a opção -L ou -follow estiver em vigor, esse teste retornará false, a menos que o link simbólico esteja quebrado.

-mmin n

Os dados do arquivo foram modificados pela última vez há n minutos

-mtime n

Os dados do arquivo foram modificados pela última vez há n*24 horas. Consulte os comentários para -atime para entender como o arredondamento afeta a interpretação dos tempos de alteração do status do arquivo.

-name padrão

A base do nome do arquivo (o caminho com os diretórios principais removidos) corresponde ao padrão de shell padrão. Como os diretórios principais são removidos, os nomes de arquivo considerados para uma correspondência com -name nunca incluirão uma barra, então `-name a/b' nunca vai corresponder a nada (você provavelmente precisará usar -path) Um aviso é emitido se você tentar fazer isso, a menos que a variável de ambiente POSIXLY_CORRECT seja definida. Os metacaracteres (`*', `?', and `[]') correspondem a um `.' No início do nome base (esta é uma mudança em findutils-4.2.2; consulte a seção CONFORMIDADE DE PADRÕES abaixo). Para ignorar um diretório e seus arquivos, use -prune; veja um exemplo na descrição de -path. As chaves '{ }' não são reconhecidos como especiais, apesar do fato de que alguns shells, incluindo o Bash, os conferem com um significado especial nos padrões de shell. A correspondência do nome do arquivo é realizada com o uso da função de biblioteca fnmatch(3). Não se esqueça de colocar o padrão entre aspas para protegê-lo de expansão pelo shell.

-newer arquivo

O arquivo foi modificado mais recentemente do que arquivo. Se arquivo for um link simbólico e a opção -H ou a opção -L estiverem em vigor, a hora de modificação do arquivo para o qual ele aponta será sempre usada.

-newerXY referência

É bem-sucedido se o registro de data e hora X do arquivo que está sendo considerado for mais novo que o registro de data e hora Y do arquivo referência. As letras X e Y podem ser qualquer uma das seguintes letras:

a	O tempo de acesso do arquivo referência
B	A tempo de criação do arquivo referência
c	O tempo de alteração do status do nó-i de referência
m	A tempo de modificação do arquivo referência
t	referência é interpretado diretamente como um tempo

Algumas combinações são inválidas; por exemplo, é inválido que X seja t. Algumas combinações não são implementadas em todos os sistemas; por exemplo, B não é suportado em todos os sistemas. Se uma combinação inválida ou não suportada de XY for especificada, ocorrerá um erro fatal. As especificações de tempo são interpretadas como para o argumento da opção -d do GNU date. Se você tentar usar o tempo de criação de um arquivo de referência e o tempo de criação não puder ser determinado, uma mensagem de erro fatal será exibida. Se você especificar um teste que se refira ao tempo de criação dos arquivos que estão sendo examinados, esse teste falhará nos arquivos em que o tempo de criação seja desconhecido.

-nogroup

Nenhum grupo corresponde ao ID número de grupo do arquivo.

-nouser

Nenhum usuário corresponde ao ID número de usuário do arquivo.

-path padrão

O nome do arquivo corresponde ao padrão de shell padrão. Os metacaracteres de não tratam "/" ou "." de forma especial; então, por exemplo,

find . -path "./sr*sc"

vai imprimir uma entrada para um diretório chamado `./src/misc' (se houver). Para ignorar uma árvore de diretório inteira, use -prune em vez de verificar todos os arquivos na árvore. Por exemplo, para pular o diretório `src/emacs' e todos os arquivos e diretórios sob ele, e imprimir os nomes dos outros arquivos encontrados, faça algo assim:

find . -path ./src/emacs -prune -o -print

Observe que o teste de correspondência de padrão se aplica a todo o nome do arquivo, começando em um dos pontos iniciais nomeados na linha de comando. Só faria sentido usar um nome de caminho absoluto aqui se o ponto inicial relevante também fosse um caminho absoluto. Isso significa que este comando nunca corresponderá a nada:

find bar -path /foo/bar/meuarquivo -print

Find compara o argumento -path com a concatenação de um nome de diretório e o nome base do arquivo que está sendo examinado. Como a concatenação nunca termina com uma barra, os argumentos -path que terminam em uma barra não correspondem a nada (exceto talvez um ponto inicial especificado na linha de comando). O predicado caminho também é suportado pelo find de HP-UX e faz parte do padrão POSIX 2008.

-perm modo

Os bits de permissão do arquivo são exatamente modo (octal ou simbólico). Como é necessária uma correspondência exata, se você deseja usar este formulário para modos simbólicos, pode ser necessário especificar uma sequência de modos bastante complexa. Por exemplo, "-perm g=w" corresponderá apenas aos arquivos que possuem o modo 0020 (ou seja, aqueles para os quais a permissão de gravação de grupo é a única permissão definida). É mais provável que você queira usar as formas "/" ou "-", por exemplo "-perm -g=w", que corresponde a qualquer arquivo com permissão de gravação em grupo. Veja a seção EXEMPLOS para alguns exemplos ilustrativos.

-perm -modo

Todos os bits de permissão modo são definidos para o arquivo. Os modos simbólicos são aceitos nesta forma, e geralmente é dessa maneira que você deseja usá-los. Você deve especificar "u", "g" ou "o" se usar um modo simbólico. Veja a seção EXEMPLOS para alguns exemplos ilustrativos.

-perm /modo

Qualquer um dos bits de permissão modo está definido para o arquivo. Os modos simbólicos são aceitos neste formulário. Você deve especificar "u", "g" ou "o" se usar um modo simbólico. Veja a seção EXEMPLOS para alguns exemplos ilustrativos. Se nenhum bit de permissão em modo estiver definido, esse teste corresponderá a qualquer arquivo (a ideia aqui é ser consistente com o comportamento de -perm -000).

-perm +modo

Isso não é mais suportado (e está descontinuado desde 2005). Use -perm /modo.

-readable

Corresponde a arquivos legíveis pelo usuário atual. Isso leva em consideração as listas de controle de acesso e outros artefatos de permissões que o teste -perm ignora. Este teste utiliza a chamada de sistema access(2) e, portanto, pode ser enganado pelos servidores NFS que fazem o mapeamento de UID (ou "root-squashing"), pois muitos sistemas implementam access(2) no kernel do cliente e, portanto, não pode usar as informações de mapeamento do UID mantidas no servidor.

-regex padrão

O nome do arquivo corresponde à expressão regular padrão. Esta é uma correspondência em todo o caminho, não uma pesquisa. Por exemplo, para corresponder a um arquivo chamado "./fubar3", você pode usar a expressão regular ".*bar." ou ".*b.*3", mas não "f.*r3". As expressões regulares entendidas por find são por padrão expressões regulares do Emacs (exceto que "." corresponde a caracteres de nova linhas), mas isso pode ser alterado com a opção -regextype.

-samefile nome

O arquivo refere-se ao mesmo nó-i que name. Quando -L está em vigor, isso pode incluir links simbólicos.

-size n[cwbkMG]

O arquivo usa n unidades de espaço, arredondando para cima. Os seguintes sufixos podem ser usados:

O tamanho é simplesmente o membro st_size do struct stat preenchido pela chamada do sistema lstat (ou stat), arredondado para cima, como mostrado acima. Em outras palavras, é consistente com o resultado obtido para ls -l. Lembre-se de que os especificadores de formato "%k" e "%b" de -printf lidam com arquivos esparsos de maneira diferente. O sufixo "b" sempre indica blocos de 512 bytes e nunca blocos de 1024 bytes, o que é diferente do comportamento de -ls.

Os prefixos + e - significam maior que e menor que, como de costume; ou seja, um tamanho exato de n unidades não corresponde. Lembre-se de que o tamanho é arredondado para a próxima unidade. Portanto, -size -1M não é equivalente a -size -1048576c. O primeiro corresponde apenas a arquivos vazios, o último corresponde a arquivos de 0 a 1.048.575 bytes.

-true

Sempre verdadeiro.

-type c

Arquivo é do tipo c:

Para procurar mais de um tipo de uma vez, você pode fornecer a lista combinada de letras do tipo separadas por uma vírgula "," (extensão GNU).

-uid n

O ID numérico do usuário do arquivo é n.

-used n

O arquivo foi acessado pela última vez n dias após a última alteração do status.

-user nome-usuário

O arquivo pertence ao usuário uname (ID numérico do usuário permitido).

-wholename padrão

Veja -path. Esta alternativa é menos portátil que -path.

-writable

Corresponde a arquivos graváveis pelo usuário atual. Isso leva em consideração as listas de controle de acesso e outros artefatos de permissões que o teste -perm ignora. Este teste utiliza a chamada de sistema access(2) e, portanto, pode ser enganado pelos servidores NFS que fazem o mapeamento de UID (ou "root-squashing"), pois muitos sistemas implementam access(2) no kernel do cliente e, portanto, não pode usar as informações de mapeamento do UID mantidas no servidor.

-xtype c

O mesmo que -type, a menos que o arquivo seja um link simbólico. Para links simbólicos: se a opção -H ou -P foi especificada, verdadeiro se o arquivo for um link para um arquivo do tipo c; se a opção -L tiver sido fornecida, verdadeiro se c for "l". Em outras palavras, para links simbólicos, -xtype verifica o tipo de arquivo que -type não verifica.

-context padrão

(SELinux somente) O contexto de segurança do arquivo corresponde ao glob padrão.

AÇÕES¶

-delete

Exclui arquivos; verdadeiro se a remoção for bem-sucedida. Se a remoção falhar, uma mensagem de erro será emitida. Se -delete falhar, o status de saída de find será diferente de zero (quando eventualmente sair). O uso de -delete ativa automaticamente a opção "-depth".

Avisos: Não se esqueça de que a linha de comando do find é avaliada como uma expressão, portanto, colocar -delete primeiro fará com que find tente excluir tudo abaixo dos pontos iniciais especificados. Ao testar uma linha de comando find que você mais tarde pretende usar com -delete, você deve especificar explicitamente -depth para evitar surpresas posteriores. Como -delete implica -pth, você não pode usar -prune e -delete juntos.

Junto com a opção -ignore_readdir_race, find ignorará os erros da ação -delete caso o arquivo tenha desaparecido desde que o diretório pai foi lido: ele não emitirá um diagnóstico de erro e o retorno o código da ação -delete será verdadeiro.

-exec comando ;

Executa comando; verdadeiro se 0 status for retornado. Todos os argumentos a seguir para find são considerados argumentos para o comando até um argumento que consiste em ";" é encontrado. A string "{}" é substituída pelo nome do arquivo atual sendo processado em todos os lugares em que ocorre nos argumentos do comando, não apenas nos argumentos em que está sozinho, como em algumas versões de find. Ambas as construções podem precisar ser escapadas (com um "\") ou citadas para protegê-las da expansão pelo shell. Consulte a seção EXEMPLOS para exemplos de uso da opção -exec. O comando especificado é executado uma vez para cada arquivo correspondente. O comando é executado no diretório inicial. Existem problemas de segurança inevitáveis em torno do uso da ação -exec; você deve usar a opção -execdir.

-exec comando {} +

Essa variante da ação -exec executa o comando especificado nos arquivos selecionados, mas a linha de comando é criada anexando cada nome de arquivo selecionado no final; o número total de invocações do comando será muito menor que o número de arquivos correspondentes. A linha de comando é construída da mesma maneira que xargs cria suas linhas de comando. Apenas uma instância de "{}" é permitida dentro do comando e (quando find está sendo chamado de um shell) deve ser citada (por exemplo, '{}') para protegê-lo da interpretação O comando é executado no diretório inicial. Se alguma chamada com a forma "+" retornar um valor diferente de zero como status de saída, find retornará um status de saída diferente de zero. Se find encontrar um erro, às vezes pode causar uma saída imediata, portanto, alguns comandos pendentes podem não ser executados. Esta variante de -exec sempre retorna verdadeiro.

-execdir comando ;

-execdir comando {} +

Como -exec, mas o comando especificado é executado no subdiretório que contém o arquivo correspondente, que normalmente não é o diretório no qual você iniciou o find. Assim como com -exec, o {} deve ser citado se find estiver sendo chamado de um shell. Esse é um método muito mais seguro para chamar comandos, pois evita condições de corrida durante a resolução dos caminhos para os arquivos correspondentes. Assim como na ação -exec, o formulário "+" de -execdir criará uma linha de comando para processar mais de um arquivo correspondente, mas qualquer chamada de comando listará apenas os arquivos existentes no o mesmo subdiretório. Se você usar esta opção, assegure-se de que sua variável de ambiente $PATH não faça referência a "."; caso contrário, um invasor poderá executar qualquer comando que desejar, deixando um arquivo com nome apropriado em um diretório no qual você executará -execdir. O mesmo se aplica a ter entradas em $PATH vazias ou que não sejam nomes de diretório absolutos. Se qualquer chamada com a forma "+" retornar um valor diferente de zero como status de saída, find retornará um status de saída diferente de zero. Se find encontrar um erro, às vezes isso pode causar uma saída imediata; portanto, alguns comandos pendentes podem não ser executados. O resultado da ação depende se a variante + ou ; está sendo usada; -execdir comando {}+ sempre retorna verdadeiro, enquanto -execdir comando {}; retorna verdadeiro somente se comando retornar 0.

-fls arquivo

Verdadeiro; como -ls, mas escreve para arquivo como -fprint. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção NOMES DE ARQUIVOS INCOMUNS para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados.

-fprint arquivo

Verdadeiro; imprime o nome completo do arquivo no arquivo arquivo. Se arquivo não existe quando find for executado, ele será criado; se existir, será truncado. Os nomes de arquivo "/dev/stdout" e "/dev/stderr" são tratados de forma especial; eles se referem à saída padrão e à saída de erro padrão, respectivamente. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção NOMES DE ARQUIVOS INCOMUNS para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados.

-fprint0 arquivo

Verdadeiro; como -print0, mas escreva para arquivo como -fprint. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção NOMES DE ARQUIVOS INCOMUNS para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados.

-fprintf arquivo formato

Verdadeiro; como -printf, mas escreva para arquivo como -fprint. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção NOMES DE ARQUIVOS INCOMUNS para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados.

-ls

Verdadeiro; lista o arquivo atual no formato ls -dils na saída padrão. As contagens de blocos são de blocos de 1 KB, a menos que a variável de ambiente POSIXLY_CORRECT esteja configurada; nesse caso, blocos de 512 bytes são usados. Consulte a seção NOMES DE ARQUIVOS INCOMUNS para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados.

-ok comando ;

Como -exec, mas pergunta ao usuário primeiro. Se o usuário concordar, executa o comando. Caso contrário, só retorna falso. Se o comando for executado, sua entrada padrão será redirecionada de /dev/null.

A resposta ao prompt é comparada com um par de expressões regulares para determinar se é uma resposta afirmativa ou negativa. Essa expressão regular é obtida do sistema se a variável de ambiente "POSIXLY_CORRECT" estiver configurada ou, caso contrário, das traduções de mensagens de find. Se o sistema não tiver uma definição adequada, a própria definição de find será usada. Nos dois casos, a interpretação da própria expressão regular será afetada pelas variáveis de ambiente "LC_CTYPE" (classes de caracteres) e "LC_COLLATE" (classes de equivalência e intervalos de caracteres).

-okdir comando ;

Como -execdir, mas pergunta ao usuário primeiro na mesma forma que para -ok. Se o usuário não concordar, só retorna falso. Se o comando for executado, sua entrada padrão será redirecionada de /dev/null.

-print

Verdadeiro; imprime o nome completo do arquivo na saída padrão, seguido por uma nova linha. Se você estiver canalizando a saída de find para outro programa e houver a menor possibilidade de que os arquivos que você está procurando possam conter uma nova linha, considere seriamente usar a opção -print0 em vez de -print. Consulte a seção NOMES DE ARQUIVOS INCOMUNS para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados.

-print0

Verdade; imprime o nome completo do arquivo na saída padrão, seguido por um caractere nulo (em vez do caractere de nova linha que -print usa). Isso permite que nomes de arquivos que contenham novas linhas ou outros tipos de espaço em branco sejam corretamente interpretados por programas que processam a saída do find. Esta opção corresponde à opção -0 de xargs.

-printf formato

Verdadeiro; imprime formato na saída padrão, interpretando as diretivas de escape "\" e "%". As larguras e precisões dos campos podem ser especificadas como na função C "printf". Observe que muitos dos campos são impressos como % s em vez d e, e isso pode significar que os sinalizadores não funcionam conforme o esperado. Isso também significa que o sinalizador "-" funciona (força os campos a serem alinhados à esquerda). Diferentemente de -print, -printf não adiciona uma nova linha no final da string. Os escapes e as diretrizes são:

-prune

Verdadeiro; se o arquivo for um diretório, não entra nele. Se -depth for fornecido, falso; nenhum efeito. Como -delete implica em -depth, você não pode usar -prune e -delete juntos.

-quit

Sai imediatamente. Nenhum processo filho será deixado em execução, mas nenhum outro caminho especificado na linha de comando será processado. Por exemplo, find /tmp/foo /tmp/bar -print -quit imprimirá apenas /tmp/foo. Quaisquer linhas de comando que foram construídas com -execdir ... {} + serão chamadas antes de find sair. O status de saída pode ou não ser zero, dependendo se um erro já ocorreu.

OPERADORES¶

( expr )

Força a precedência. Como os parênteses são especiais para o shell, normalmente você precisará colocá-los entre aspas. Muitos dos exemplos nesta página de manual usam barras invertidas para este propósito: "\(...\)" em vez de "(...)".

! expr

Verdadeiro se expr for falso. Esse caractere geralmente também precisará de proteção contra interpretação pelo shell.

-not expr

Mesmo que ! expr, mas não compatível com POSIX.

expr1 expr2

Duas expressões em uma linha são consideradas unidas com um -a implícito; expr2 não é avaliado se expr1 for falso.

expr1 -a expr2

Mesmo que expr1 expr2.

expr1 -and expr2

Mesmo que expr1 expr2, mas não compatível com POSIX.

expr1 -o expr2

Ou; expr2 não é avaliado se expr1 for falso.

expr1 -or expr2

Mesmo que expr1 -o expr2, mas não compatível com POSIX.

expr1 , expr2

Lista; ambos expr1 e expr2 são sempre avaliados. O valor de expr1 é descartado; o valor da lista é o valor de expr2 . O operador vírgula pode ser útil para pesquisar vários tipos diferentes de coisas, mas percorrer a hierarquia do sistema de arquivos apenas uma vez. A ação -fprintf pode ser usada para listar os vários itens correspondentes em vários arquivos de saída diferentes.

Observe que -a quando especificado implicitamente (por exemplo, por dois testes que aparecem sem um operador explícito entre eles) ou explicitamente tem precedência mais alta do que -o . Isso significa que find . -name arquivoa -o -name arquivob -print nunca imprimirá um arquivoa.

Surpresas de precedência de operadores¶

Mensagem de erro “os caminhos devem preceder a expressão”¶

$ find . -name *.c -print
find: os caminhos devem preceder a expressão
find: padrão possivelmente sem aspas após o predicado `-name'?

Isso acontece quando o shell pode expandir o padrão *.c para mais de um nome de arquivo existente no diretório atual e passar os nomes de arquivo resultantes na linha de comando para find assim:

find . -name frcode.c locate.c word_io.c -print

$ find . -name '*.c' -print
$ find . -name \*.c -print