.\" -*- coding: UTF-8 -*- .\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH FIND 1 '\" t .SH NOME find \- pesquisa por arquivos em uma hierarquia de diretórios .SH SINOPSE \fBfind\fP [\-H] [\-L] [\-P] [\-D opçõesdepuração] [\-Onível] [ponto\-de\-partida...\&] [expressão] . .SH DESCRIÇÃO Esta página de manual documenta a versão GNU do \fBfind\fP. O GNU \fBfind\fP pesquisa a árvore de diretórios enraizada em cada ponto de partida, avaliando a expressão dada da esquerda para a direita, de acordo com as regras de precedência (consulte a seção OPERADORES), até que o resultado seja conhecido (o lado esquerdo é falso para operações \fIe\fP, verdadeiro para \fIou\fP), nesse ponto \fBfind\fP passa para o próximo nome de arquivo. Se nenhum ponto de partida for especificado, `.\&' será assumido. .PP Se você estiver usando \fBfind\fP em um ambiente em que a segurança é importante (por exemplo, se você estiver usando\-o para pesquisar diretórios graváveis por outros usuários), leia o capítulo "Security Considerations" da documentação do findutils, que é chamado \fBFinding Files\fP e vem com o findutils. Esse documento também inclui muito mais detalhes e discussão do que esta página de manual, portanto, você pode encontrar uma fonte de informação mais útil. . .SH OPÇÕES As opções \fB\-H\fP, \fB\-L\fP e \fB\-P\fP controlam o tratamento de links simbólicos. Os argumentos da linha de comando a seguir são considerados nomes de arquivos ou diretórios a serem examinados, até o primeiro argumento que começa com "\-" ou o argumento "(" ou "!". Esse argumento e os argumentos a seguir são usados para ser a expressão que descreve o que deve ser pesquisado. Se nenhum caminho for fornecido, o diretório atual será usado. Se nenhuma expressão for fornecida, a expressão \fB\-print\fP será usada (mas você provavelmente deve considerar usar \fB\-print0\fP). .PP Esta página de manual fala sobre "opções" na lista de expressões. Essas opções controlam o comportamento do \fBfind\fP, mas são especificadas imediatamente após o último nome do caminho. As cinco opções "reais" \fB\-H\fP, \fB\-L\fP, \fB\-P\fP, \fB\-D\fP e \fB\-O\fP devem aparecer antes do nome do primeiro caminho, se houver. Teoricamente, um traço duplo \fB\-\-\fP também pode ser usado para sinalizar que os argumentos restantes não são opções, mas Isso não realmente funciona por causa da forma que o \fBfind\fPdetermina o fim dos seguintes argumentos de caminho: ele faz isso lendo até um argumento de expressão aparecer (que também inicia com um "\-"). Agora, se um argumento de caminho iniciaria com um "\-", \fBfind\fP o trataria como argumento de expressão. Assim, para garantir que todos os pontos iniciais sejam considerados como tal e, especialmente, para evitar que os padrões de curinga expandidos pelo shell de chamada não sejam tratados erroneamente como argumentos de expressão, geralmente é mais seguro prefixar curingas ou nomes de caminho duvidosos com "./" ou para usar nomes de caminho absolutos começando com "/". .IP \-P Nunca segue links simbólicos. Esse é o comportamento padrão. Quando \fBfind\fP examina ou imprime informações sobre um arquivo, e o arquivo é um link simbólico, as informações utilizadas devem ser obtidas das propriedades do próprio link simbólico. .IP \-L Segue os links simbólicos. Quando \fBfind\fP examina ou imprime informações sobre arquivos, as informações usadas devem ser obtidas das propriedades do arquivo para o qual o link aponta, não do próprio link (a menos que seja um link simbólico quebrado ou \fBfind\fP não possa para examinar o arquivo para o qual o link aponta). O uso dessa opção implica em \fB\-noleaf\fP. Se você em seguida usar a opção \fB\-P\fP, \fB\-noleaf\fP ainda estará em vigor. Se \fB\-L\fP estiver em vigor e \fBfind\fP descobrir um link simbólico para um subdiretório durante sua pesquisa, o subdiretório apontado pelo link simbólico será pesquisado. .IP Quando a opção \fB\-L\fP estiver em vigor, o predicado \fB\-type\fP sempre corresponderá ao tipo de arquivo ao qual um link simbólico aponta e não ao próprio link (a menos que o link simbólico esteja quebrado). Ações que podem causar quebra de links simbólicos enquanto \fBfind\fP está em execução (por exemplo, \fB\-delete\fP) podem gerar um comportamento confuso. O uso de \fB\-L\fP faz com que os predicados \fB\-lname\fP e \fB\-ilname\fP sempre retornem false. .IP \-H Não segue os links simbólicos, exceto durante o processamento dos argumentos da linha de comandos. Quando \fBfind\fP examina ou imprime informações sobre arquivos, as informações usadas devem ser obtidas das propriedades do próprio link simbólico. A única exceção a esse comportamento é quando um arquivo especificado na linha de comando é um link simbólico e o link pode ser resolvido. Para essa situação, as informações usadas são obtidas de qualquer ponto para o qual o link aponta (ou seja, o link é seguido). As informações sobre o próprio link são usadas como fallback se o arquivo apontado pelo link simbólico não puder ser examinado. Se \fB\-H\fP estiver em vigor e um dos caminhos especificados na linha de comando for um link simbólico para um diretório, o conteúdo desse diretório será examinado (embora, é claro, \fB\-maxdepth\ 0\fP evite isso). .P Se mais de uma opção de \fB\-H\fP, \fB\-L\fP e \fB\-P\fP for especificada, cada uma substituirá as outras; a última que aparece na linha de comando entra em vigor. Como é o padrão, a opção \fB\-P\fP deve ser considerada em vigor, a menos que \fB\-H\fP ou \fB\-L\fP sejam especificados. O GNU \fBfind\fP frequentemente estatísticas arquivos durante o processamento da própria linha de comando, antes de qualquer pesquisa ter começado. Essas opções também afetam como esses argumentos são processados. Especificamente, existem vários testes que comparam os arquivos listados na linha de comando com um arquivo que estamos considerando no momento. Em cada caso, o arquivo especificado na linha de comando será examinado e algumas de suas propriedades serão salvas. Se o arquivo nomeado é de fato um link simbólico e a opção \fB\-P\fP está em vigor (ou se \fB\-H\fP nem \fB\-L\fP foram especificados), as informações usadas para a comparação serão obtidas das propriedades do link simbólico. Caso contrário, ele será retirado das propriedades do arquivo para o qual o link aponta. Se \fBfind\fP não puder seguir o link (por exemplo, porque possui privilégios insuficientes ou o link aponta para um arquivo inexistente), as propriedades do próprio link serão usadas. .P Quando as opções \fB\-H\fP ou \fB\-L\fP estiverem em vigor, quaisquer links simbólicos listados como argumento de \fB\-newer\fP serão desreferenciados e o carimbo de data e hora será retirado do arquivo para o qual o link simbólico aponta. A mesma consideração se aplica a \fB\-newerXY\fP, \fB\-anewer\fP e \fB\-cnewer\fP. A opção \fB\-follow\fP tem um efeito semelhante a \fB\-L\fP, embora tenha efeito no ponto em que aparece (ou seja, se \fB\-L\fP não for usado, mas \fB\-follow\fP for, quaisquer links simbólicos que apareçam depois de \fB\-follow\fP na linha de comando serão desreferenciados, e aqueles antes dele não serão). .IP "\-D opçõesdepuração" Imprime informações de diagnóstico; isso pode ser útil para diagnosticar problemas com os motivos pelos quais \fBfind\fP não está fazendo o que você deseja. A lista de opções de depuração deve ser separada por vírgula. A compatibilidade das opções de depuração não é garantida entre os lançamentos do findutils. Para obter uma lista completa das opções de depuração válidas, consulte a saída de \fBfind \-D\ help\fP. Opções de depuração válidas incluem .RS .IP exec Mostra informações de diagnóstico relacionadas a \-exec, \-execdir, \-ok e \-okdir .IP opt Imprime informações de diagnóstico relacionadas à otimização da árvore de expressões; veja a opção \-O. .IP rates Imprime um resumo indicando com que frequência cada predicado teve êxito ou falhou. .IP search Navega na árvore de diretórios verbalmente. .IP stat As mensagens de impressão como arquivos são examinadas com as chamadas do sistema \fBstat\fP e \fBlstat\fP. O programa \fBfind\fP tenta minimizar essas chamadas. .IP tree Mostra a árvore de expressão em sua forma original e otimizada. .IP all Habilita todas as outras opções de depuração (exceto \fBhelp\fP). .IP help Explica as opções de depuração. .RE .IP \-Onível Habilita a otimização de consultas. O programa \fBfind\fP reordena os testes para acelerar a execução, preservando o efeito geral; isto é, predicados com efeitos colaterais não são reordenados em relação um ao outro. As otimizações executadas em cada nível de otimização são as seguintes. .RS .IP 0 Equivalente ao nível de otimização 1. .IP 1 Este é o nível de otimização padrão e corresponde ao comportamento tradicional. As expressões são reordenadas para que os testes baseados apenas nos nomes dos arquivos (por exemplo, \fB\-name\fP e \fB\-regex\fP) sejam executados primeiro. .IP 2 Todos os testes \fB\-type\fP ou \fB\-xtype\fP são executados após quaisquer testes baseados apenas nos nomes dos arquivos, mas antes de qualquer teste que exija informações do nó\-i. Em muitas versões modernas do Unix, os tipos de arquivo são retornados por \fBreaddir()\fP e, portanto, esses predicados são mais rápidos de avaliar do que os predicados que precisam declarar o arquivo primeiro. Se você usar o predicado com \fB\-fstype\ \fP\fIFOO\fP e especificar um sistema de arquivos tipo \fIFOO\fP que não seja conhecido (ou seja, presente em `/etc/mtab') no momento em que \fBfind\fP for iniciado, esse predicado é equivalente a \fB\-false\fP. .IP 3 Nesse nível de otimização, o otimizador de consultas completo baseado em custos está ativado. A ordem dos testes é modificada para que os testes baratos (ou seja, rápidos) sejam executados primeiro e os mais caros sejam realizados posteriormente, se necessário. Dentro de cada faixa de custo, os predicados são avaliados mais cedo ou mais tarde, de acordo com a probabilidade de êxito ou não. Para \fB\-o\fP, os predicados com probabilidade de êxito são avaliados anteriormente e para \fB\-a\fP, os predicados com probabilidade de falha são avaliados anteriormente. .RE .IP O otimizador baseado em custos tem uma ideia fixa da probabilidade de um determinado teste ser bem\-sucedido. Em alguns casos, a probabilidade leva em consideração a natureza específica do teste (por exemplo, presume\-se que \fB\-type\ f\fP seja mais provável que seja bem\-sucedido que \fB\-type\ c\fP) O otimizador baseado em custos está sendo avaliado no momento. Se, na verdade, não melhorar o desempenho de \fBfind\fP, ele será removido novamente. Por outro lado, otimizações que provam ser confiáveis, robustas e eficazes podem ser ativadas em níveis mais baixos de otimização ao longo do tempo. No entanto, o comportamento padrão (ou seja, nível de otimização 1) não será alterado na série de versões 4.3.x. O conjunto de testes do findutils executa todos os testes em \fBfind\fP em cada nível de otimização e garante que o resultado seja o mesmo. . .SH EXPRESSÃO A parte da linha de comando após a lista de pontos de partida é a \fIexpressão\fP. Esse é um tipo de especificação de consulta que descreve como correspondemos aos arquivos e o que fazemos com os arquivos correspondentes. Uma expressão é composta por uma sequência de coisas: .IP Testes Os testes retornam um valor verdadeiro ou falso, geralmente com base em alguma propriedade de um arquivo que estamos considerando. O teste \fB\-empty\fP, por exemplo, é verdadeiro apenas quando o arquivo atual está vazio. .IP Ações As ações têm efeitos colaterais (como imprimir algo na saída padrão) e retornam verdadeiro ou falso, geralmente com base no êxito ou não delas. A ação \fB\-print\fP, por exemplo, imprime o nome do arquivo atual na saída padrão. .IP "Opções globais" As opções globais afetam a operação de testes e ações especificados em qualquer parte da linha de comandos. As opções globais sempre retornam verdadeiras. A opção \fBprofundidade\fP, por exemplo, faz com que \fBfind\fP percorra o sistema de arquivos em uma ordem profunda. .IP "Opções posicionais" As opções posicionais afetam apenas testes ou ações que os seguem. As opções posicionais sempre retornam verdadeiras. A opção \fB\-regextype\fP, por exemplo, é posicional, especificando o dialeto da expressão regular para expressões regulares que ocorrem posteriormente na linha de comando. .IP Operadores Os operadores juntam os outros itens da expressão. Eles incluem, por exemplo, \fB\-o\fP (significando OU lógico) e \fB\-a\fP (significando E lógico). Onde um operador está ausente, \fB\-a\fP é presumido. .P A ação \fB\-print\fP é realizada em todos os arquivos para os quais toda a expressão é verdadeira, a menos que ela contenha uma ação além de \fB\-prune\fP ou \fB\-quit\fP. As ações que inibem o \fB\-print\fP padrão são \fB\-delete\fP, \fB\-exec\fP, \fB\-execdir\fP, \fB\-ok\fP, \fB\-okdir\fP, \fB\-fls\fP, \fB\-fprint\fP, \fB\-fprintf\fP, \fB\-ls\fP, \fB\-print\fP e \fB\-printf\fP. A ação \fB\-delete\fP também atua como uma opção (uma vez que implica \fB\-depth\fP). .SS "OPÇÕES POSICIONAIS" As opções posicionais sempre retornam verdadeiras. Eles afetam apenas os testes que ocorrem posteriormente na linha de comando. .IP \-daystart Mede tempos (para \fB\-amin\fP, \fB\-atime\fP, \fB\-cmin\fP, \fB\-ctime\fP, \fB\-mmin\fP e \fB\-mtime\fP) 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. .IP \-follow Descontinuada; use a opção \fB\-L\fP. Desreferencia links simbólicos. Implica \fB\-noleaf\fP. A opção \fB\-follow\fP afeta apenas os testes que aparecem depois na linha de comando. A menos que a opção \fB\-H\fP ou \fB\-L\fP tenha sido especificada, a posição da opção \fB\-follow\fP altera o comportamento do predicado \fB\-newer\fP; todos os arquivos listados como argumento de \fB\-newer\fP serão desreferenciados se forem links simbólicos. A mesma consideração se aplica a \fB\-newerXY\fP, \fB\-anewer\fP e \fB\-cnewer\fP. Da mesma forma, o predicado \fB\-type\fP sempre corresponderá ao tipo de arquivo ao qual um link simbólico aponta, em vez do próprio link. Usar \fB\-follow\fP faz com que os predicados \fB\-lname e\fP \fB\-ilname\fP sempre retornem falso. .IP "\-regextype \fItipo\fP" Altera a sintaxe da expressão regular entendida pelos testes \fB\-regex\fP e \fB\-iregex\fP que ocorrem posteriormente na linha de comando. Para ver quais tipos de expressão regular são conhecidos, use \fB\-regextype\ help\fP. A documentação do Texinfo (consulte \fBVEJA\fP \fBTAMBÉM\fP) explica o significado e as diferenças entre os vários tipos de expressão regular. .IP "\-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 \fBfind\fP ao encontrar diretórios. O comportamento padrão corresponde a \fB\-warn\fP se a entrada padrão for um tty e a \fB\-nowarn\fP caso contrário. Se uma mensagem de aviso relacionada ao uso da linha de comandos for produzida, o status de saída de \fBfind\fP não será afetado. Se a variável de ambiente POSIXLY_CORRECT estiver configurada e \fB\-warn\fP também for usado, não será especificado quais avisos, se houver algum, estarão ativos. .SS "OPÇÕES GLOBAIS" As opções globais sempre retornam verdadeiras. As opções globais entram em vigor mesmo para testes que ocorrem anteriormente na linha de comando. Para evitar confusão, as opções globais devem ser especificadas na linha de comando após a lista de pontos de partida, imediatamente antes do primeiro teste, opção posicional ou ação. Se você especificar uma opção global em algum outro lugar, \fBfind\fP emitirá uma mensagem de aviso explicando que isso pode ser confuso. 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 \fB\-L\fP, por exemplo. .IP \-d Um sinônimo para \-depth, para compatibilidade com FreeBSD, NetBSD, MacOS X e OpenBSD. .IP \-depth Processa o conteúdo de cada diretório antes do próprio diretório. A ação de \-delete também implica em \fB\-depth\fP. .IP "\-help, \-\-help" Imprime um resumo do uso da linha de comando de \fBfind\fP e sai. .IP \-ignore_readdir_race Normalmente, \fBfind\fP 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 \fBfind\fP 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 \fBfind\fP em vez disso, um com a opção e outro sem ela). Além disso, \fBfind\fP com a opção \fB\-ignore_readdir_race\fP ignorará os erros da ação \fB\-delete\fP 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 \fB\-delete\fP será verdadeiro. .IP "\-maxdepth \fIníveis\fP" Desce no máximo \fIníveis\fP (um número inteiro não negativo) de diretórios abaixo dos pontos de partida. \fB\-maxdepth\ 0\fP significa aplicar apenas os testes e ações aos próprios pontos de partida. .IP "\-mindepth \fIníveis\fP" Não aplica nenhum teste ou ação em níveis inferiores a \fIníveis\fP (um número inteiro não negativo). \fB\-mindepth\ 1\fP significa processar todos os arquivos, exceto os pontos de partida. .IP \-mount Não desce diretórios em outros sistemas de arquivos. Um nome alternativo para \fB\-xdev\fP, para compatibilidade com outras versões do \fBfind\fP. .IP \-noignore_readdir_race Desativa o efeito de \fB\-ignore_readdir_race\fP. .IP \-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 \fBfind\fP 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. .IP "\-version, \-\-version" Imprime o número de versão do \fBfind\fP e sai. .IP \-xdev Não desce diretórios em outros sistemas de arquivos. .SS TESTES Alguns testes, por exemplo, \fB\-newerXY\fP e \fB\-samefile\fP, permitem a comparação entre o arquivo que está sendo examinado no momento e algum arquivo de referência especificado na linha de comando. Quando esses testes são usados, a interpretação do arquivo de referência é determinada pelas opções \fB\-H\fP, \fB\-L\fP e \fB\-P\fP e qualquer \fB\-follow\fP anterior, mas o arquivo de referência é examinado apenas uma vez, no momento em que a linha de comando é analisada. Se o arquivo de referência não puder ser examinado (por exemplo, a chamada do sistema \fBstat\fP(2) falha para isso), uma mensagem de erro será emitida e \fBfind\fP sairá com um status diferente de zero. .P Um argumento numérico \fIn\fP pode ser especificado para testes (como \fB\-amin\fP, \fB\-mtime\fP, \fB\-gid\fP, \fB\-inum\fP, \fB\-links\fP, \fB\-size\fP, \fB\-uid\fP e \fB\-used\fP) como .IP \fI+n\fP para maior que \fIn\fP, .IP \fI\-n\fP para menor que \fIn\fP, .IP \fIn\fP para exatamente \fIn\fP. . .P Testes suportados: .IP "\-amin \fIn\fP" O arquivo foi acessado pela última vez há menos, mais ou exatamente \fIn\fP minutos atrás. .IP "\-anewer \fIreferência\fP" O horário do último acesso ao arquivo atual é mais recente que o da última modificação de dados do arquivo \fIreferência\fP. Se \fIreferência\fP for um link simbólico e a opção \fB\-H\fP ou \fB\-L\fP estiver em vigor, sempre será usado o horário da última modificação de dados do arquivo para o qual ele aponta. .IP "\-atime \fIn\fP" O arquivo foi acessado pela última vez há menos, mais ou exatamente \fIn\fP*24 horas atrás. Quando \fBfind\fP descobre quantos períodos de 24 horas atrás o arquivo foi acessado pela última vez, qualquer parte fracionária será ignorada; portanto, para corresponder a \fB\-atime\ +1\fP, um arquivo deve ter sido acessado pelo menos \fIdois\fP dias atrás. .IP "\-cmin \fIn\fP" O status do arquivo foi alterado pela última vez há menos, mais ou exatamente \fIn\fP minutos atrás. .IP "\-cnewer \fIreferência\fP" O horário do última alteração do status do arquivo atual é mais recente que o da última modificação de dados do arquivo \fIreferência\fP. Se \fIreferência\fP for um link simbólico e a opção \fB\-H\fP ou \fB\-L\fP estiver em vigor, sempre será usado o horário da última modificação de dados do arquivo para o qual ele aponta. .IP "\-ctime \fIn\fP" O status do arquivo foi alterado pela última vez há menos, mais ou exatamente \fIn\fP*24 horas atrás. Consulte os comentários para \fB\-atime\fP para entender como o arredondamento afeta a interpretação dos tempos de alteração do status do arquivo. .IP \-empty O arquivo está vazio e é um arquivo comum ou um diretório. .IP \-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 \fB\-perm\fP ignora. Este teste utiliza a chamada de sistema \fBaccess\fP(2) e, portanto, pode ser enganado por servidores NFS que fazem o mapeamento de UID (ou esmagamento da raiz), pois muitos sistemas implementam \fBaccess\fP(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 \fBaccess\fP(2), não há garantia de que um arquivo para o qual esse teste seja bem\-sucedido possa realmente ser executado. .IP \-false Sempre falso. .IP "\-fstype \fItipo\fP" O arquivo está em um sistema de arquivos do tipo \fItipo\fP. 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 \fB\-printf\fP com a diretiva %F para ver os tipos de seus sistemas de arquivos. .IP "\-gid \fIn\fP" O ID numérico do grupo do arquivo é menor, maior ou exatamente \fIn\fP. .IP "\-group \fInome\-grupo\fP" O arquivo pertence ao grupo \fInome\-grupo\fP (ID numérico do grupo permitido). .IP "\-ilname \fIpadrão\fP" Como \fB\-lname\fP, mas a correspondência não diferencia maiúsculas de minúsculas. Se a opção \fB\-L\fP ou \fB\-follow\fP estiver em vigor, esse teste retornará false, a menos que o link simbólico esteja quebrado. .IP "\-iname \fIpadrão\fP" Como \fB\-name\fP, 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". .IP "\-inum \fIn\fP" O arquivo possui o número de nó\-i menor, maior ou exatamente \fIn\fP. Normalmente, é mais fácil usar o teste \fB\-samefile\fP. .IP "\-ipath \fIpadrão\fP" Como \fB\-path\fP, mas a correspondência não diferencia maiúsculas de minúsculas. .IP "\-iregex \fIpadrão\fP" Como \fB\-regex\fP, mas a correspondência não diferencia maiúsculas de minúsculas. .IP "\-iwholename \fIpadrão\fP" Veja \-ipath. Esta alternativa é menos portátil que \fB\-ipath\fP. .IP "\-links \fIn\fP" O arquivo possui \fIn\fP links físico. .IP "\-lname \fIpadrão\fP" O arquivo é um link simbólico cujo conteúdo corresponde ao padrão de shell \fIpadrão\fP. Os metacaracteres não tratam "/" ou ".\&" em especial. Se a opção \fB\-L\fP ou \fB\-follow\fP estiver em vigor, esse teste retornará false, a menos que o link simbólico esteja quebrado. .IP "\-mmin \fIn\fP" Os dados do arquivo foram modificados pela última vez há menos, mais ou exatamente \fIn\fP minutos atrás. .IP "\-mtime \fIn\fP" Os dados do arquivo foram modificados pela última vez há menor, mais ou exatamente \fIn\fP*24 horas atrás. Consulte os comentários para \fB\-atime\fP para entender como o arredondamento afeta a interpretação dos tempos de alteração do status do arquivo. .IP "\-name \fIpadrão\fP" A base do nome do arquivo (o caminho com os diretórios principais removidos) corresponde ao padrão de shell \fIpadrão\fP. Como os diretórios principais são removidos, os nomes de arquivos considerados para uma correspondência com \fB\-name\fP nunca incluirão uma barra, portanto, "\-name a/b" nunca corresponderá a nada (você provavelmente precisará usar \fB\-path\fP). Um aviso será emitido se você tentar fazer isso, a menos que a variável de ambiente POSIXLY_CORRECT esteja configurada. Os metacaracteres ("*", "?" e "[]") correspondem com um ".\&" no início do nome da base (esta é uma alteração no findutils\-4.2.2; consulte a seção CONFORMIDADE COM OS PADRÕES abaixo). Para ignorar um diretório e os arquivos nele, use \fBprune\fP em vez de verificar todos os arquivos na árvore; veja um exemplo na descrição dessa ação. As chaves não são reconhecidas como especiais, apesar do fato de que alguns shells, incluindo o Bash, conferem às chaves um significado especial nos padrões de shell. A correspondência do nome do arquivo é realizada com o uso da função da biblioteca \fBfnmatch\fP(3). Não se esqueça de colocar o padrão entre aspas para protegê\-lo da expansão pelo shell. .IP "\-newer \fIreferência\fP" O horário do última modificação dos dados do arquivo atual é mais recente que o da última modificação de dados do arquivo \fIreferência\fP. Se \fIreferência\fP for um link simbólico e a opção \fB\-H\fP ou \fB\-L\fP estiver em vigor, sempre será usado o horário da última modificação de dados do arquivo para o qual ele aponta. .IP "\-newerXY \fIreferência\fP" É bem\-sucedido se o registro de data e hora \fIX\fP do arquivo que está sendo considerado for mais novo que o registro de data e hora \fIY\fP do arquivo \fIreferência\fP. As letras \fIX\fP e \fIY\fP podem ser qualquer uma das seguintes letras: .TS ll ll ll ll llw(2i). a O tempo de acesso do arquivo \fIreferência\fP B A tempo de criação do arquivo \fIreferência\fP c O tempo de alteração do status do nó\-i de \fIreferência\fP m A tempo de modificação do arquivo \fIreferência\fP t \fIreferência\fP é interpretado diretamente como um tempo .TE Algumas combinações são inválidas; por exemplo, é inválido que \fIX\fP seja \fIt\fP. Algumas combinações não são implementadas em todos os sistemas; por exemplo, \fIB\fP não é suportado em todos os sistemas. Se uma combinação inválida ou não suportada de \fIXY\fP for especificada, ocorrerá um erro fatal. As especificações de tempo são interpretadas como para o argumento da opção \fB\-d\fP do GNU \fBdate\fP. 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. .IP \-nogroup Nenhum grupo corresponde ao ID número de grupo do arquivo. .IP \-nouser Nenhum usuário corresponde ao ID número de usuário do arquivo. .IP "\-path \fIpadrão\fP" O nome do arquivo corresponde ao padrão de shell \fIpadrão\fP. Os metacaracteres de não tratam "/" ou ".\&" de forma especial; então, por exemplo, .in +4m .nf find . \-path "./sr*sc" .fi .in vai exibir uma entrada para um diretório chamado \fI./src/misc\fP (se houver). Para ignorar uma árvore de diretórios inteira, use \fBprune\fP em vez de verificar todos os arquivos na árvore. Observe que o teste de correspondência de padrões se aplica a todo o nome do arquivo, iniciando em um dos pontos de início nomeados na linha de comandos. Só faria sentido usar um nome de caminho absoluto aqui se o ponto inicial relevante também for um caminho absoluto. Isso significa que este comando nunca corresponderá a nada: .br .in +4m .nf find bar \-path /foo/bar/meuarquivo \-print .fi .in Find compara o argumento \fB\-path\fP 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 \fB\-path\fP que terminam em uma barra não correspondem a nada (exceto talvez um ponto inicial especificado na linha de comando). O predicado \fBcaminho\fP também é suportado pelo \fBfind\fP de HP\-UX e faz parte do padrão POSIX 2008. .IP "\-perm \fImodo\fP" Os bits de permissão do arquivo são exatamente \fImodo\fP (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 \fBEXEMPLOS\fP para alguns exemplos ilustrativos. .IP "\-perm \-\fImodo\fP" Todos os bits de permissão \fImodo\fP 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 \fBEXEMPLOS\fP para alguns exemplos ilustrativos. .IP "\-perm /\fImodo\fP" Qualquer um dos bits de permissão \fImodo\fP 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 \fBEXEMPLOS\fP para alguns exemplos ilustrativos. Se nenhum bit de permissão em \fImodo\fP estiver definido, esse teste corresponderá a qualquer arquivo (a ideia aqui é ser consistente com o comportamento de \fB\-perm\ \-000\fP). .IP "\-perm +\fImodo\fP" Isso não é mais suportado (e está descontinuado desde 2005). Use \fB\-perm /\fP\fImodo\fP. .IP \-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 \fB\-perm\fP ignora. Este teste utiliza a chamada de sistema \fBaccess\fP(2) e, portanto, pode ser enganado pelos servidores NFS que fazem o mapeamento de UID (ou "root\-squashing"), pois muitos sistemas implementam \fBaccess\fP(2) no kernel do cliente e, portanto, não pode usar as informações de mapeamento do UID mantidas no servidor. .IP "\-regex \fIpadrão\fP" O nome do arquivo corresponde à expressão regular \fIpadrão\fP. Esta é uma correspondência em todo o caminho, não uma pesquisa. Por exemplo, para corresponder a um arquivo chamado \fB./fubar3\fP, você pode usar a expressão regular ".*bar.\&" ou ".*b.*3", mas não "f.*r3". As expressões regulares entendidas por \fBfind\fP 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 \fB\-regextype\fP. .IP "\-samefile \fInome\fP" O arquivo refere\-se ao mesmo nó\-i que \fIname\fP. Quando \fB\-L\fP está em vigor, isso pode incluir links simbólicos. .IP "\-size \fIn\fP[cwbkMG]" O arquivo usa menos, mais ou exatamente \fIn\fP unidades de espaço, arredondando para cima. Os seguintes sufixos podem ser usados: .RS .IP \(dqb\(dq para blocos de 512 bytes (este é o padrão se nenhum sufixo for usado) .IP \(dqc\(dq para bytes .IP \(dqw\(dq para palavras com 2 bytes .IP \(dqk\(dq para kibibytes (KiB, unidades de 1024 bytes) .IP \(dqM\(dq para mebibytes (MiB, unidades de 1024 * 1024 = 1\|048\|576 bytes) .IP \(dqG\(dq para gibibytes (GiB, unidades de of * 1024 * 1024 = 1\|073\|741\|824 bytes) .RE .IP 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 \fBls\ \-l\fP. Lembre\-se de que os especificadores de formato "%k" e "%b" de \fB\-printf\fP 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 \fB\-ls\fP. .IP Os prefixos + e \- significam maior que e menor que, como de costume; ou seja, um tamanho exato de \fIn\fP unidades não corresponde. Tenha em mente que o tamanho é arredondado para a próxima unidade. Portanto, \fB\-size\ \-1M\fP não é equivalente a \fB\-size\ \-1\|048\|576c\fP. O primeiro corresponde apenas a arquivos vazios, o último corresponde a arquivos de 0 a 1.048.575 bytes. .IP \-true Sempre verdadeiro. .IP "\-type \fIc\fP" Arquivo é do tipo \fIc\fP: .RS .IP b especial de bloco (com buffer) .IP c especial de caractere (sem buffer) .IP d diretório .IP p encadeamento com nome (FIFO) .IP f arquivo regular .IP l link simbólico; isso nunca é verdadeiro se a opção \fB\-L\fP ou a opção \fB\-follow\fP estiver em vigor, a menos que o link simbólico esteja quebrado. Se você deseja procurar links simbólicos quando \fB\-L\fP estiver em vigor, use \fB\-xtype\fP. .IP s soquete .IP D door (Solaris) .RE .IP 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). .IP "\-uid \fIn\fP" O ID numérico do usuário do arquivo é menor que, maior que ou exatamente \fIn\fP. .IP "\-used \fIn\fP" O arquivo foi acessado pela última vez há menos, mais ou exatamente \fIn\fP dias após a última alteração do status. .IP "\-user \fInome\-usuário\fP" O arquivo pertence ao usuário \fIuname\fP (ID numérico do usuário permitido). .IP "\-wholename \fIpadrão\fP" Veja \-path. Esta alternativa é menos portátil que \fB\-path\fP. .IP \-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 \fB\-perm\fP ignora. Este teste utiliza a chamada de sistema \fBaccess\fP(2) e, portanto, pode ser enganado pelos servidores NFS que fazem o mapeamento de UID (ou "root\-squashing"), pois muitos sistemas implementam \fBaccess\fP(2) no kernel do cliente e, portanto, não pode usar as informações de mapeamento do UID mantidas no servidor. .IP "\-xtype \fIc\fP" O mesmo que \fB\-type\fP, a menos que o arquivo seja um link simbólico. Para links simbólicos: se a opção \fB\-H\fP ou \fB\-P\fP foi especificada, verdadeiro se o arquivo for um link para um arquivo do tipo \fIc\fP; se a opção \fB\-L\fP tiver sido fornecida, verdadeiro se \fIc\fP for "l". Em outras palavras, para links simbólicos, \fB\-xtype\fP verifica o tipo de arquivo que \fB\-type\fP não verifica. .IP "\-context \fIpadrão\fP" (SELinux somente) O contexto de segurança do arquivo corresponde ao glob \fIpadrão\fP. .SS AÇÕES .IP \-delete Exclui arquivos; verdadeiro se a remoção for bem\-sucedida. Se a remoção falhar, uma mensagem de erro será emitida. Se \fB\-delete\fP falhar, o status de saída de \fBfind\fP será diferente de zero (quando eventualmente sair). O uso de \fB\-delete\fP ativa automaticamente a opção "\fB\-depth\fP". \fBAvisos\fP: Não se esqueça de que a linha de comando do find é avaliada como uma expressão, portanto, colocar \fB\-delete\fP primeiro fará com que \fBfind\fP tente excluir tudo abaixo dos pontos iniciais especificados. Ao testar uma linha de comando \fBfind\fP que você mais tarde pretende usar com \fB\-delete\fP, você deve especificar explicitamente \fB\-depth\fP para evitar surpresas posteriores. Como \fB\-delete\fP implica \fB\-pth\fP, você não pode usar \fB\-prune\fP e \fB\-delete\fP juntos. Junto com a opção \fB\-ignore_readdir_race\fP, \fBfind\fP ignorará os erros da ação \fB\-delete\fP 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 \fB\-delete\fP será verdadeiro. .IP "\-exec \fIcomando\fP ;" Executa \fIcomando\fP; verdadeiro se 0 status for retornado. Todos os argumentos a seguir para \fBfind\fP 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 \fBfind\fP. Ambas as construções podem precisar ser escapadas (com um "\e") ou citadas para protegê\-las da expansão pelo shell. Consulte a seção \fBEXEMPLOS\fP para exemplos de uso da opção \fB\-exec\fP. 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 \fB\-exec\fP; você deve usar a opção \fB\-execdir\fP. .IP "\-exec \fIcomando\fP {} +" Essa variante da ação \fB\-exec\fP executa o comando especificado nos arquivos selecionados, mas a linha de comando é construída 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 \fBxargs\fP constrói suas linhas de comando. Apenas uma instância de "{}" é permitida dentro do comando e deve aparecer no final, imediatamente antes do "+"; ele precisa ser escapado (com um "\e") ou entre aspas para protegê\-lo da interpretação pelo shell. O comando é executado no diretório inicial. Se alguma chamada com a forma "+" retornar um valor diferente de zero como status de saída, \fBfind\fP retornará um status de saída diferente de zero. Se \fBfind\fP encontrar um erro, às vezes pode causar uma saída imediata, portanto, alguns comandos pendentes podem não ser executados. Por este motivo, \fB\-exec\ \fP\fImeu\-comando\fP\fB\ ...\ {}\ +\ \-quit\fP pode não resultar em \fImeu\-comando\fP ser executado. Esta variante de \fB\-exec\fP sempre retorna verdadeiro. .IP "\-execdir \fIcomando\fP ;" .IP "\-execdir \fIcomando\fP {} +" Like \fB\-exec\fP, but the specified command is run from the subdirectory containing the matched file, which is not normally the directory in which you started \fBfind\fP. As with \-exec, the {} should be quoted if find is being invoked from a shell. This a much more secure method for invoking commands, as it avoids race conditions during resolution of the paths to the matched files. As with the \fB\-exec\fP action, the `+' form of \fB\-execdir\fP will build a command line to process more than one matched file, but any given invocation of \fIcommand\fP will only list files that exist in the same subdirectory. If you use this option, you must ensure that your \fB$PATH\fP environment variable does not reference `.'; otherwise, an attacker can run any commands they like by leaving an appropriately\-named file in a directory in which you will run \fB\-execdir\fP. The same applies to having entries in \fB$PATH\fP which are empty or which are not absolute directory names. If any invocation with the `+' form returns a non\-zero value as exit status, then \fBfind\fP returns a non\-zero exit status. If \fBfind\fP encounters an error, this can sometimes cause an immediate exit, so some pending commands may not be run at all. The result of the action depends on whether the \fB+\fP or the \fB;\fP variant is being used; \fB\-execdir\ \fP\fIcommand\fP\fB\ {}\ +\fP always returns true, while \fB\-execdir\ \fP\fIcommand\fP\fB\ {}\ ;\fP returns true only if \fIcommand\fP returns 0. .IP "\-fls \fIarquivo\fP" Verdadeiro; como \fB\-ls\fP, mas escreve para \fIarquivo\fP como \fB\-fprint\fP. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção \fBNOMES DE ARQUIVOS INCOMUNS\fP para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados. .IP "\-fprint \fIarquivo\fP" True; print the full file name into file \fIfile\fP. If \fIfile\fP does not exist when \fBfind\fP is run, it is created; if it does exist, it is truncated. The file names \fI/dev/stdout\fP and \fI/dev/stderr\fP are handled specially; they refer to the standard output and standard error output, respectively. The output file is always created, even if the predicate is never matched. See the \fBUNUSUAL FILENAMES\fP section for information about how unusual characters in filenames are handled. .IP "\-fprint0 \fIarquivo\fP" Verdadeiro; como \fB\-print0\fP, mas escreva para \fIarquivo\fP como \fB\-fprint\fP. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção \fBNOMES DE ARQUIVOS INCOMUNS\fP para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados. .IP "\-fprintf \fIarquivo\fP \fIformato\fP" Verdadeiro; como \fB\-printf\fP, mas escreva para \fIarquivo\fP como \fB\-fprint\fP. O arquivo de saída é sempre criado, mesmo que o predicado nunca seja correspondido. Consulte a seção \fBNOMES DE ARQUIVOS INCOMUNS\fP para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados. .IP \-ls Verdadeiro; lista o arquivo atual no formato \fBls \-dils\fP 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 \fBNOMES DE ARQUIVOS INCOMUNS\fP para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados. .IP "\-ok \fIcomando\fP ;" Like \fB\-exec\fP but ask the user first. If the user agrees, run the command. Otherwise just return false. If the command is run, its standard input is redirected from \fI/dev/null\fP. .IP 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 \fBfind\fP. Se o sistema não tiver uma definição adequada, a própria definição de \fBfind\fP 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). .IP "\-okdir \fIcomando\fP ;" Like \fB\-execdir\fP but ask the user first in the same way as for \fB\-ok\fP. If the user does not agree, just return false. If the command is run, its standard input is redirected from \fI/dev/null\fP. .IP \-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 \fBfind\fP 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 \fB\-print0\fP em vez de \fB\-print\fP. Consulte a seção \fBNOMES DE ARQUIVOS INCOMUNS\fP para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados. .IP \-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 \fB\-print\fP 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 \fBfind\fP. Esta opção corresponde à opção \fB\-0\fP de \fBxargs\fP. .IP "\-printf \fIformato\fP" True; print \fIformat\fP on the standard output, interpreting `\e' escapes and `%' directives. Field widths and precisions can be specified as with the \fBprintf\fP(3) C function. Please note that many of the fields are printed as %s rather than %d, and this may mean that flags don't work as you might expect. This also means that the `\-' flag does work (it forces fields to be left\-aligned). Unlike \fB\-print\fP, \fB\-printf\fP does not add a newline at the end of the string. The escapes and directives are: .RS .IP \ea Bipe de alarme. .IP \eb Backspace. .IP \ec Para de imprimir deste formato imediatamente e limpa a saída. .IP \ef Alimentação de formulário. .IP \en Nova linha. .IP \er Carriage return. .IP \et Tabulação horizontal. .IP \ev Tabulação vertical. .IP \e0 ASCII NULO .IP \e\e A versão literal de uma barra invertida ("\e"). .IP \eNNN O caractere cujo código ASCII é NNN (octal). .PP Um caractere "\e" seguido por qualquer outro caractere é tratado como caractere comum, portanto, ambos são impressos. .IP %% Um sinal de porcentagem literal. .IP %a File's last access time in the format returned by the C \fBctime\fP(3) function. .IP %A\fIk\fP File's last access time in the format specified by \fIk\fP, which is either `@' or a directive for the C \fBstrftime\fP(3) function. The following shows an incomplete list of possible values for \fIk\fP. Please refer to the documentation of \fBstrftime\fP(3) for the full list. Some of the conversion specification characters might not be available on all systems, due to differences in the implementation of the \fBstrftime\fP(3) library function. .RS .IP @ segundos desde 1º\ de\ jan, 1970, 00:00 GMT, com parte fracionária. .PP Campos de tempo: .IP H hora (00..23) .IP I hora (01..12) .IP k hora ( 0..23) .IP l hora ( 1..12) .IP M minuto (00..59) .IP p AM ou PM da localidade .IP r tempo no formato 12 horas (hh:mm:ss [AP]M) .IP S Segundo (00.00 \&..\& 61.00). Há uma parte fracionária. .IP T tempo no formato 24 horas (hh:mm:ss.xxxxxxxxxx) .IP + Data e hora, separadas por "+", por exemplo "2004\-04\-28+22:22:05.0". Esta é uma extensão GNU. O tempo é dado no fuso horário atual (que pode ser afetado pela configuração da variável de ambiente TZ). O campo segundos inclui uma parte fracionária. .IP X representação do tempo da localidade (H:M:S). O campo segundos inclui uma parte fracionária. .IP Z fuso horário (por exemplo, EDT) ou nada se nenhum fuso horário for determinável .PP Campos de data: .IP a nome abreviado do dia da semana da localidade (dom..sáb) .IP A nome completo do dia da semana da localidade (domingo..sábado) .IP b nome abreviado do dia do mês da localidade (jan..dez) .IP B nome completo do dia do mês da localidade (janeiro..dezembro) .IP c data e hora do local (sáb 04 nov 10:02:33 1989). O formato é o mesmo que para \fBctime\fP(3) e, para preservar a compatibilidade com esse formato, não há parte fracionária no campo segundos. .IP d dia do mês (01..31) .IP D data (mm/dd/yy) .IP F date (yyyy\-mm\-dd) .IP h mesmo que b .IP j dia do ano (001..366) .IP m mês (01..12) .IP U número da semana do ano com domingo como primeiro dia da semana (00..53) .IP w dia da semana (0..6) .IP W número da semana do ano com segunda\-feira como primeiro dia da semana (00..53) .IP x representação de data da localidade (dd/mm/yyyy) .IP y últimos dois dígitos do ano (00..99) .IP Y ano (1970...\&) .RE .IP %b A quantidade de espaço em disco usada para esse arquivo em blocos de 512 bytes. Como o espaço em disco é alocado em múltiplos do tamanho do bloco do sistema de arquivos, geralmente é maior que %s/512, mas também pode ser menor se o arquivo for um arquivo esparso. .IP %c Hora do último tempo de alteração do arquivo no formato retornado pela função C \fBctime\fP(3). .IP %C\fIk\fP Tempo da última alteração de status do arquivo no formato especificado por \fIk\fP, que é o mesmo que para %A. .IP %d Profundidade do arquivo na árvore de diretórios; 0 significa que o arquivo é um ponto de partida. .IP %D O número do dispositivo no qual o arquivo existe (o campo st_dev da estrutura stat), em decimal. .IP %f Imprime o nome base; o nome do arquivo com quaisquer diretórios principais removidos (apenas o último elemento). Para \fB/\fP, o resultado é `/'. Veja a seção \fBEXEMPLOS\fP para um exemplo. .IP %F Tipo do sistema de arquivos em que o arquivo está; esse valor pode ser usado para \-fstype. .IP %g Nome do grupo do arquivo ou ID numérico do grupo, se o grupo não tiver um nome. .IP %G O ID numérico do grupo do arquivo. .IP %h Dirname; the Leading directories of the file's name (all but the last element). If the file name contains no slashes (since it is in the current directory) the %h specifier expands to `.'. For files which are themselves directories and contain a slash (including \fB/\fP), %h expands to the empty string. See the \fBEXAMPLES\fP section for an example. .IP %H Ponto de partida em que arquivo foi encontrado. .IP %i Número do nó\-i do arquivo (em decimal). .IP %k A quantidade de espaço em disco usada para esse arquivo em blocos de 1\ KB. Como o espaço em disco é alocado em múltiplos do tamanho do bloco do sistema de arquivos, geralmente é maior que %s/1024, mas também pode ser menor se o arquivo for um arquivo esparso. .IP %l Objeto do link simbólico (string vazia se o arquivo não for um link simbólico). .IP %m Bits de permissão do arquivo (em octal). Esta opção usa os números "tradicionais" usados pela maioria das implementações do Unix, mas se a sua implementação específica usa uma ordem incomum de bits de permissões octais, você verá uma diferença entre o valor real do modo do arquivo e a saída de %m. Normalmente, você deseja ter um zero à esquerda nesse número e, para fazer isso, use o sinalizador \fB#\fP (como em, por exemplo, "%#m"). .IP %M Permissões do arquivo (em forma simbólica, como para \fBls\fP). Esta diretiva é suportada no findutils 4.2.5 e posterior. .IP %n Número de links físicos para o arquivo. .IP %p Nome do arquivo. .IP %P Nome do arquivo com o nome do ponto de partida sob o qual foi encontrado removido. .IP %s Tamanho do arquivo em bytes. .IP %S Escassez de arquivo. Isso é calculado como (TAMBLOCO*st_blocks/st_size). O valor exato que você obterá para um arquivo comum de um determinado comprimento depende do sistema. No entanto, arquivos normalmente esparsos terão valores menores que 1.0 e arquivos que usam blocos indiretos podem ter um valor maior que 1.0. Em geral, o número de blocos usados por um arquivo depende do sistema de arquivos. O valor usado para TAMBLOCO depende do sistema, mas geralmente é de 512 bytes. Se o tamanho do arquivo for zero, o valor impresso será indefinido. Em sistemas que não têm suporte a st_blocks, a escassez de um arquivo é presumida como 1.0. .IP %t File's last modification time in the format returned by the C \fBctime\fP(3) function. .IP %T\fIk\fP Tempo da última modificação do arquivo no formato especificado por \fIk\fP, que é o mesmo que para %A. .IP %u Nome do usuário do arquivo ou ID numérico do usuário, se o usuário não tiver um nome. .IP %U O ID numérico do usuário do arquivo. .IP %y Tipo do arquivo (como em \fBls \-l\fP), U=tipo desconhecido (não deveria ocorrer) .IP %Y File's type (like %y), plus follow symbolic links: `L'=loop, `N'=nonexistent, `?' for any other error when determining the type of the target of a symbolic link. .IP %Z (apenas SELinux) contexto de segurança do arquivo. .IP "%{ %[ %(" Reservado para uso futuro. .PP Um caractere "%" seguido por qualquer outro caractere é descartado, mas o outro caractere é impresso (não conte com isso, pois outros caracteres de formato podem ser introduzidos). Um "%" no final do argumento de formato causa um comportamento indefinido, pois não há caractere seguinte. Em algumas localidades, ele pode ocultar as chaves da porta, enquanto em outros pode remover a página final do romance que você está lendo. The %m and %d directives support the \fB#\fP, \fB0\fP and \fB+\fP flags, but the other directives do not, even if they print numbers. Numeric directives that do not support these flags include \fBG\fP, \fBU\fP, \fBb\fP, \fBD\fP, \fBk\fP and \fBn\fP. The `\-' format flag is supported and changes the alignment of a field from right\-justified (which is the default) to left\-justified. .PP Consulte a seção \fBNOMES DE ARQUIVOS INCOMUNS\fP para obter informações sobre como os caracteres incomuns nos nomes de arquivos são tratados. .RE .IP \-prune Verdadeiro; se o arquivo for um diretório, não entra nele. Se \fB\-depth\fP for dado, então \fB\-prune\fP tem nenhum efeito. Porque \fB\-delete\fP implica em \fB\-depth\fP, você não pode usar de forma útil \fB\-prune\fP e \fB\-delete\fP juntos. Por exemplo, para pular o diretório \fIsrc/emacs\fP e todos os arquivos e diretórios dentro dele, e imprimir os nomes dos outros arquivos encontrados, faça algo como isso aqui: .in +4m .nf find . \-path ./src/emacs \-prune \-o \-print .fi .in .IP \-quit Exit immediately (with return value zero if no errors have occurred). This is different to \fB\-prune\fP because \fB\-prune\fP only applies to the contents of pruned directories, while \fB\-quit\fP simply makes \fBfind\fP stop immediately. No child processes will be left running. Any command lines which have been built by \fB\-exec\ ...\ +\fP or \fB\-execdir\ ...\ +\fP are invoked before the program is exited. After \fB\-quit\fP is executed, no more files specified on the command line will be processed. For example, `\fBfind\ \fP\fI/tmp/foo\fP\fB\ \fP\fI/tmp/bar\fP\fB\ \-print\ \-quit\fP` will print only `/tmp/foo`. .br One common use of \fB\-quit\fP is to stop searching the file system once we have found what we want. For example, if we want to find just a single file we can do this: .in +4m .nf find / \-name needle \-print \-quit .fi .in .SS OPERADORES Listados em ordem decrescente de precedência: .IP "( \fIexpr\fP )" 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: "\e(...\e)" em vez de "(...)". .IP "! \fIexpr\fP" Verdadeiro se \fIexpr\fP for falso. Esse caractere geralmente também precisará de proteção contra interpretação pelo shell. .IP "\-not \fIexpr\fP" Mesmo que !\& \fIexpr\fP, mas não compatível com POSIX. .IP "\fIexpr1 expr2\fP" Duas expressões em uma linha são consideradas unidas com um \fB\-a\fP implícito; \fIexpr2\fP não é avaliado se \fIexpr1\fP for falso. .IP "\fIexpr1\fP \-a \fIexpr2\fP" Mesmo que \fIexpr1 expr2\fP. .IP "\fIexpr1\fP \-and \fIexpr2\fP" Mesmo que \fIexpr1 expr2\fP, mas não compatível com POSIX. .IP "\fIexpr1\fP \-o \fIexpr2\fP" Ou; \fIexpr2\fP não é avaliado se \fIexpr1\fP for falso. .IP "\fIexpr1\fP \-or \fIexpr2\fP" Mesmo que \fIexpr1\fP \fB\-o\fP \fIexpr2\fP, mas não compatível com POSIX. .IP "\fIexpr1\fP , \fIexpr2\fP" Lista; ambos \fIexpr1\fP e \fIexpr2\fP são sempre avaliados. O valor de \fIexpr1\fP é descartado; o valor da lista é o valor de \fIexpr2\fP . 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 \fB\-fprintf\fP pode ser usada para listar os vários itens correspondentes em vários arquivos de saída diferentes. .P Observe que \fB\-a\fP 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 \fB\-o\fP . Isso significa que \fBfind . \-name arquivoa \-o \-name arquivob \-print\fP nunca imprimirá um \fIarquivoa\fP. . .SH "NOMES DE ARQUIVOS INCOMUNS" Muitas das ações de \fBfind\fP resultam na impressão de dados que estão sob o controle de outros usuários. Isso inclui nomes de arquivos, tamanhos, horários de modificação e assim por diante. Os nomes dos arquivos são um problema potencial, pois podem conter qualquer caractere, exceto "\e0" e "/". Caracteres incomuns em nomes de arquivo podem causar coisas inesperadas e frequentemente indesejáveis ​​em seu terminal (por exemplo, alterar as configurações de suas teclas de função em alguns terminais). Caracteres incomuns são tratados de forma diferente por várias ações, conforme descrito abaixo. .IP "\-print0, \-fprint0" Sempre imprime o nome do arquivo exato, inalterado, mesmo se a saída for para um terminal. .IP "\-ls, \-fls" Caracteres incomuns sempre têm escape. Os caracteres de espaço em branco, barra invertida e aspas duplas são impressos usando escape no estilo C (por exemplo, `\ef', `\e"'). Outros caracteres incomuns são impressos usando escape octal. Outros caracteres imprimíveis (para \fB\-ls\fP e \fB\-fls\fP esses são os caracteres entre octal 041 e 0176) são impressos no estado em que se encontram. .IP "\-printf, \-fprintf" Se a saída não for para um terminal, ela será impressa no estado em que se encontra. Caso contrário, o resultado depende de qual diretiva está em uso. As diretivas %D, %F, %g, %G, %H, %Y e %y se expandem para valores que não estão sob controle dos donos dos arquivos e, portanto, são impressos no estado em que se encontram. As diretivas %a, %b, %c, %d, %i, %k, %m, %M, %n, %s, %t, %u e %U têm valores que estão sob o controle dos donos dos arquivos, mas que não podem ser usados ​​para enviar dados arbitrários para o terminal e, portanto, são impressos no estado em que se encontram. As diretivas %f, %h, %l, %p e %P são colocadas entre aspas. Esta forma de colocar entre aspas é realizada da mesma maneira que para GNU \fBls\fP . Este não é o mesmo mecanismo de uso de aspas usado para \fB\-ls\fP e \fB\-fls\fP. Se você for capaz de decidir qual formato usar para a saída do \fBfind\fP, então normalmente é melhor usar `\e0' como um terminador do que usar nova linha, já que os nomes de arquivo podem conter espaços em branco e caracteres de nova linha. A configuração da variável de ambiente `LC_CTYPE' é usada para determinar quais caracteres precisam ser colocado entre aspas. .IP "\-print, \-fprint" A uso de aspas é tratado da mesma maneira que para \fB\-printf\fP e \fB\-fprintf\fP \&. Se estiver usando \fBfind\fP em um script ou em uma situação em que os arquivos correspondentes possam ter nomes arbitrários, você deve considerar o uso de \fB\-print0\fP em vez de \fB\-print\fP. .P As ações \fB\-ok\fP e \fB\-okdir\fP imprimem o nome do arquivo atual no estado em que se encontra. Isso pode mudar em uma versão futura. . .SH "CONFORMIDADE COM OS PADRÕES" Para uma conformidade mais próxima do padrão POSIX, você deve definir a variável de ambiente POSIXLY_CORRECT. As seguintes opções são especificadas no padrão POSIX (IEEE Std 1003.1\-2008, 2016 Edition): .IP \fB\-H\fP Está opção é suportada. .IP \fB\-L\fP Está opção é suportada. .IP \fB\-name\fP This option is supported, but POSIX conformance depends on the POSIX conformance of the system's \fBfnmatch\fP(3) library function. As of findutils\-4.2.2, shell metacharacters (`*', `?' or `[]' for example) match a leading `.', because IEEE PASC interpretation 126 requires this. This is a change from previous versions of findutils. .IP \fB\-type\fP Suportado. POSIX especifica `b', `c', `d', `l', `p', `f' e `s'. GNU find também suporta `D', representando uma porta, onde o sistema operacional os fornece. Além disso, GNU find permite que vários tipos sejam especificados de uma vez em uma lista separada por vírgulas. .IP \fB\-ok\fP Suportado. A interpretação da resposta é de acordo com os padrões `yes' e `no' selecionados pela configuração da variável de ambiente `LC_MESSAGES \&'. Quando a variável de ambiente `POSIXLY_CORRECT' é definida, esses padrões são considerados a definição do sistema de uma resposta positiva (yes) ou negativa (no). Consulte a documentação do sistema para \fBnl_langinfo\fP(3), em particular YESEXPR e NOEXPR. Quando `POSIXLY_CORRECT' não é definido, os padrões são retirados do próprio catálogo de mensagens de \fBfind\fP. .IP \fB\-newer\fP Suportado. Se o arquivo especificado for um link simbólico, ele sempre terá a desreferência. Esta é uma mudança do comportamento anterior, que costumava tirar o tempo relevante do link simbólico; veja a seção HISTÓRICO abaixo. .IP \fB\-perm\fP Suportado. Se a variável de ambiente POSIXLY_CORRECT não for definida, alguns argumentos de modo (por exemplo, +a+x) que não são válidos em POSIX são suportados para compatibilidade com versões anteriores. .IP "Outros primários" Os primários \fB\-atime\fP, \fB\-ctime\fP, \fB\-depth\fP, \fB\-exec\fP, \fB\-group\fP, \fB\-links\fP, \fB\-mtime\fP, \fB\-nogroup\fP, \fB\-nouser\fP, \fB\-ok\fP, \fB\-path\fP, \fB\-print\fP, \fB\-prune\fP, \fB\-size\fP, \fB\-user\fP e \fB\-xdev\fP são todos suportados. .P The POSIX standard specifies parentheses `(', `)', negation `!' and the logical AND/OR operators \fB\-a\fP and \fB\-o\fP. .P Todas as outras opções, predicados, expressões e assim por diante são extensões além do padrão POSIX. Muitas dessas extensões não são exclusivas do GNU find, entretanto. .P O padrão POSIX requer que o \fBfind\fP detecte loops: .IP O utilitário \fBfind\fP deve detectar loops infinitos; ou seja, inserir um diretório visitado anteriormente que é um ancestral do último arquivo encontrado. Ao detectar um loop infinito, o find deve escrever uma mensagem de diagnóstico para o erro padrão e deve recuperar sua posição na hierarquia ou terminar. .P GNU \fBfind\fP está em conformidade com esses requisitos. A contagem de links de diretórios que contêm entradas que são links físicos para um ancestral geralmente será menor do que deveria ser. Isso pode significar que o GNU find às vezes otimiza a visita a um subdiretório que é na verdade um link para um ancestral. Como o \fBfind\fP não entra em tal subdiretório, é permitido evitar a emissão de uma mensagem de diagnóstico. Embora esse comportamento possa ser um tanto confuso, é improvável que alguém realmente dependa desse comportamento. Se a otimização de folha foi desativada com \fB\-noleaf\fP, a entrada do diretório sempre será examinada e a mensagem de diagnóstico será emitida onde for apropriado. Links simbólicos não podem ser usados ​​para criar ciclos de sistema de arquivos como tal, mas se a opção \fB\-L\fP ou a opção \fB\-follow\fP estiver em uso, uma mensagem de diagnóstico é emitida quando \fBfind\fP encontra um loop de links simbólicos. Como acontece com os loops que contêm links físicos, a otimização de folha frequentemente significa que find sabe que não precisa chamar \fIstat()\fP ou \fIchdir()\fP no link simbólico, portanto, esse diagnóstico frequentemente não é necessário. .P A opção \fB\-d\fP é suportada para compatibilidade com vários sistemas BSD, mas você deve usar a opção compatível com POSIX \fB\-depth\fP. .P A variável ambiente POSIXLY_CORRECT não afeta o comportamento dos testes \fB\-regex\fP ou \fB\-iregex\fP, porque estes testes não são especificados no padrão POSIX. . .SH "VARIÁVEIS DE AMBIENTE" .IP LANG Fornece um valor padrão para as variáveis ​​de internacionalização que não estão definidas ou são nulas. .IP LC_ALL Se definido como um valor de string não vazio, substitui os valores de todas as outras variáveis ​​de internacionalização. .IP LC_COLLATE O padrão POSIX especifica que esta variável afeta a correspondência de padrões a ser usada para a opção \fB\-name\fP. GNU find usa a função de biblioteca \fBfnmatch\fP(3) e, portanto, o suporte para `LC_COLLATE' depende da biblioteca do sistema. Essa variável também afeta a interpretação da resposta para \fB\-ok\fP; enquanto a variável `LC_MESSAGES' seleciona o padrão atual usado para interpretar a resposta para \fB\-ok\fP, a interpretação de quaisquer expressões entre colchetes no padrão será afetada por `LC_COLLATE'. .IP LC_CTYPE Essa variável afeta o tratamento das classes de caracteres usadas nas expressões regulares e também com o teste \fB\-name\fP, se a função da biblioteca \fBfnmatch\fP(3) do sistema suportar isso. Essa variável também afeta a interpretação de qualquer classe de caractere nas expressões regulares usadas para interpretar a resposta ao prompt emitido por \fB\-ok\fP. A variável de ambiente "LC_CTYPE" também afetará quais caracteres são considerados imprimíveis quando nomes de arquivos são impressos; consulte a seção NOMES DE ARQUIVOS INCOMUNS. .IP LC_MESSAGES Determina o local a ser usado para mensagens internacionalizadas. Se a variável de ambiente `POSIXLY_CORRECT' for definida, isso também determina a interpretação da resposta ao prompt feito pela ação \fB\-ok\fP. .IP NLSPATH Determina a localização dos catálogos de mensagens de internacionalização. .IP PATH Afeta os diretórios que são pesquisados ​​para encontrar os executáveis ​​chamados por \fB\-exec\fP, \fB\-execdir\fP, \fB\-ok\fP e \fB\-okdir\fP. .IP POSIXLY_CORRECT Determina o tamanho do bloco usado por \fB\-ls\fP e \fB\-fls\fP. Se \fBPOSIXLY_CORRECT\fP for definido, os blocos são unidades de 512 bytes. Caso contrário, eles são unidades de 1024 bytes. .IP Definir essa variável também desativa as mensagens de aviso (ou seja, implica \fB\-nowarn\fP) por padrão, porque POSIX requer que, além da saída para \fB\-ok\fP, todas as mensagens impressas em stderr são diagnósticos e devem resultar em um status de saída diferente de zero. .IP When POSIXLY_CORRECT is not set, \fB\-perm \fP\fI+zzz\fP is treated just like \fB\-perm \fP\fI/zzz\fP if \fI+zzz\fP is not a valid symbolic mode. When POSIXLY_CORRECT is set, such constructs are treated as an error. .IP Quando POSIXLY_CORRECT é definido, a resposta ao prompt feito pela ação \fB\-ok\fP é interpretada de acordo com o catálogo de mensagens do sistema, ao contrário de de acordo com as traduções de mensagens do próprio \fBfind\fP. .IP TZ Afeta o fuso horário usado para algumas das diretivas de formato relacionadas ao tempo de \fB\-printf\fP and \fB\-fprintf\fP. . .SH EXEMPLOS .\" A bulleted \[bu] list of examples. .SS "Abordagem simples de `find|xargs`" .IP \[bu] Find files named \fIcore\fP in or below the directory \fI/tmp\fP and delete them. .nf \& .in +4m \fB$ find /tmp \-name core \-type f \-print | xargs /bin/rm \-f\fP .in \& .fi Note that this will work incorrectly if there are any filenames containing newlines, single or double quotes, or spaces. . .SS "Safer `find \-print0 | xargs \-0` approach" .IP \[bu] Find files named \fIcore\fP in or below the directory \fI/tmp\fP and delete them, processing filenames in such a way that file or directory names containing single or double quotes, spaces or newlines are correctly handled. .nf \& .in +4m \fB$ find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f\fP .in \& .fi The \fB\-name\fP test comes before the \fB\-type\fP test in order to avoid having to call \fBstat(2)\fP on every file. .PP Note that there is still a race between the time \fBfind\fP traverses the hierarchy printing the matching filenames, and the time the process executed by \fBxargs\fP works with that file. .SS "Executando um comando para cada arquivo" .IP \[bu] Run \fIfile\fP on every file in or below the current directory. .nf \& .in +4m \fB$ find . \-type f \-exec file \(aq{}\(aq \e;\fP .in \& .fi Notice that the braces are enclosed in single quote marks to protect them from interpretation as shell script punctuation. The semicolon is similarly protected by the use of a backslash, though single quotes could have been used in that case also. .PP In many cases, one might prefer the \fB`\-exec\ \&...\&\ +`\fP or better the \fB`\-execdir\ \&...\&\ +`\fP syntax for performance and security reasons. . .SS "Percorrendo o sistema de arquivos apenas uma vez \-\- para 2 ações diferentes" .IP \[bu] Traverse the filesystem just once, listing set\-user\-ID files and directories into \fI/root/suid.txt\fP and large files into \fI/root/big.txt\fP. .nf \& .in +4m \fB$ find / \e\fP .in +4m \fB\e( \-perm \-4000 \-fprintf /root/suid.txt \(aq%#m %u %p\en\(aq \e) , \e\fP .br \fB\e( \-size +100M \-fprintf /root/big.txt \(aq%\-10s %p\en\(aq \e)\fP .in -4m .in -4m \& .fi This example uses the line\-continuation character \(aq\e\(aq on the first two lines to instruct the shell to continue reading the command on the next line. . .SS "Pesquisando arquivos por idade" .IP \[bu] Search for files in your home directory which have been modified in the last twenty\-four hours. .nf \& .in +4m \fB$ find $HOME \-mtime 0\fP .in \& .fi This command works this way because the time since each file was last modified is divided by 24 hours and any remainder is discarded. That means that to match \fB\-mtime\fP \fB0\fP, a file will have to have a modification in the past which is less than 24 hours ago. . .SS "Pesquisando arquivos por permissões" .IP \[bu] Pesquisa arquivos que são executáveis, mas não legíveis. .nf \& .in +4m \fB$ find /sbin /usr/sbin \-executable \e! \-readable \-print\fP .in \& .fi . .IP \[bu] Search for files which have read and write permission for their owner, and group, but which other users can read but not write to. .nf \& .in +4m \fB$ find . \-perm 664\fP .in \& .fi Files which meet these criteria but have other permissions bits set (for example if someone can execute the file) will not be matched. . .IP \[bu] Search for files which have read and write permission for their owner and group, and which other users can read, without regard to the presence of any extra permission bits (for example the executable bit). .nf \& .in +4m \fB$ find . \-perm \-664\fP .in \& .fi This will match a file which has mode \fI0777\fP, for example. . .IP \[bu] Pesquisa por arquivos que podem ser escritos por alguém (seu dono, seu grupo ou qualquer outra pessoa). .nf \& .in +4m \fB$ find . \-perm /222\fP .in \& .fi . .IP \[bu] Search for files which are writable by either their owner or their group. .nf \& .in +4m \fB$ find . \-perm /220\fP \fB$ find . \-perm /u+w,g+w\fP \fB$ find . \-perm /u=w,g=w\fP .in \& .fi All three of these commands do the same thing, but the first one uses the octal representation of the file mode, and the other two use the symbolic form. The files don't have to be writable by both the owner and group to be matched; either will do. . .IP \[bu] Search for files which are writable by both their owner and their group. .nf \& .in +4m \fB$ find . \-perm \-220\fP \fB$ find . \-perm \-g+w,u+w\fP .in \& .fi Both these commands do the same thing. . .IP \[bu] A more elaborate search on permissions. .nf \& .in +4m \fB$ find . \-perm \-444 \-perm /222 \e! \-perm /111\fP \fB$ find . \-perm \-a+r \-perm /a+w \e! \-perm /a+x\fP .in \& .fi These two commands both search for files that are readable for everybody (\fB\-perm \-444\fP or \fB\-perm \-a+r\fP), have at least one write bit set (\fB\-perm /222\fP or \fB\-perm /a+w\fP) but are not executable for anybody (\fB! \-perm /111\fP or \fB! \-perm /a+x\fP respectively). . .SS "Pruning \- omitting files and subdirectories" .IP \[bu] Copy the contents of \fI/source\-dir\fP to \fI/dest\-dir\fP, but omit files and directories named \fI.snapshot\fP (and anything in them). It also omits files or directories whose name ends in \fI'\(ti'\fP, but not their contents. .nf \& .in +4m \fB$ cd /source\-dir\fP \fB$ find . \-name .snapshot \-prune \-o \e( \e! \-name \(aq*~\(aq \-print0 \e) \e\fP .br .in +4m \fB| cpio \-pmd0 /dest\-dir\fP .in -4m .in -4m \& .fi The construct \fB\-prune\ \-o\ \e(\ \&...\&\ \-print0\ \e)\fP is quite common. The idea here is that the expression before \fB\-prune\fP matches things which are to be pruned. However, the \fB\-prune\fP action itself returns true, so the following \fB\-o\fP ensures that the right hand side is evaluated only for those directories which didn't get pruned (the contents of the pruned directories are not even visited, so their contents are irrelevant). The expression on the right hand side of the \fB\-o\fP is in parentheses only for clarity. It emphasises that the \fB\-print0\fP action takes place only for things that didn't have \fB\-prune\fP applied to them. Because the default `and' condition between tests binds more tightly than \fB\-o\fP, this is the default anyway, but the parentheses help to show what is going on. . .IP \[bu] Dado o seguinte diretório de projetos e seus diretórios administrativos SCM associados, execute uma busca eficiente pelas raízes dos projetos: .nf \& .in +4m \fB$ find repo/ \e\fP .in +4m \fB\e( \-exec test \-d \(aq{}/.svn\(aq \e; \e\fP \fB\-or \-exec test \-d \(aq{}/.git\(aq \e; \e\fP \fB\-or \-exec test \-d \(aq{}/CVS\(aq \e; \e\fP \fB\e) \-print \-prune\fP .in -4m .in -4m \& .fi Amostra da saída: .nf \& .in +4m \fBrepo/project1/CVS\fP \fBrepo/gnu/project2/.svn\fP \fBrepo/gnu/project3/.svn\fP \fBrepo/gnu/project3/src/.svn\fP \fBrepo/project4/.git\fP .in \& .fi In this example, \fB\-prune\fP prevents unnecessary descent into directories that have already been discovered (for example we do not search \fIproject3/src\fP because we already found \fIproject3/.svn\fP), but ensures sibling directories (\fIproject2\fP and \fIproject3\fP) are found. . .SS "Outros exemplos úteis" .IP \[bu] Search for several file types. .nf \& .in +4m \fB$ find /tmp \-type f,d,l\fP .in \& .fi Search for files, directories, and symbolic links in the directory \fI/tmp\fP passing these types as a comma\-separated list (GNU extension), which is otherwise equivalent to the longer, yet more portable: .nf \& .in +4m \fB$ find /tmp \e( \-type f \-o \-type d \-o \-type l \e)\fP .in \& .fi . .IP \[bu] Search for files with the particular name \fIneedle\fP and stop immediately when we find the first one. .nf \& .in +4m \fB$ find / \-name needle \-print \-quit\fP .in \& .fi . .IP \[bu] Demonstrate the interpretation of the \fB%f\fP and \fB%h\fP format directives of the \fB\-printf\fP action for some corner\-cases. Here is an example including some output. .nf \& .in +4m \fB$ find . .. / /tmp /tmp/TRACE compile compile/64/tests/find \-maxdepth 0 \-printf '[%h][%f]\en'\fP \fB[.][.]\fP \fB[.][..]\fP \fB[][/]\fP \fB[][tmp]\fP \fB[/tmp][TRACE]\fP \fB[.][compile]\fP \fB[compile/64/tests][find]\fP .in \& .fi . .SH "STATUS DE SAÍDA" \fBfind\fP sai com status 0 se todos os arquivos forem processados ​​com êxito, maior que 0 se ocorrerem erros. Esta é uma descrição deliberadamente muito ampla, mas se o valor de retorno for diferente de zero, você não deve confiar na exatidão dos resultados de \fBfind\fP. When some error occurs, \fBfind\fP may stop immediately, without completing all the actions specified. For example, some starting points may not have been examined or some pending program invocations for \fB\-exec\ \&...\&\ {}\ +\fP or \fB\-execdir\ \&...\&\ {}\ +\fP may not have been performed. . .SH HISTÓRICO As of findutils\-4.2.2, shell metacharacters (`*', `?' or `[]' for example) used in filename patterns match a leading `.', because IEEE POSIX interpretation 126 requires this. .P As of findutils\-4.3.3, \fB\-perm\ /000\fP now matches all files instead of none. .P Marcas de data e hora com resolução em nanossegundos foram implementados em findutils\-4.3.3. .P A partir de findutils\-4.3.11, a ação \fB\-delete\fP define o status de saída do \fBfind\fP para um valor diferente de zero quando falha. No entanto, \fBfind\fP não será encerrado imediatamente. Anteriormente, o status de saída de \fBfind\fP não era afetado pela falha de \fB\-delete\fP. .TS l l l . Recurso Adicionado em Também ocorre em \-newerXY 4.3.3 BSD \-D 4.3.1 \-O 4.3.1 \-readable 4.3.0 \-writable 4.3.0 \-executable 4.3.0 \-regextype 4.2.24 \-exec ... + 4.2.12 POSIX \-execdir 4.2.12 BSD \-okdir 4.2.12 \-samefile 4.2.11 \-H 4.2.5 POSIX \-L 4.2.5 POSIX \-P 4.2.5 BSD \-delete 4.2.3 \-quit 4.2.3 \-d 4.2.3 BSD \-wholename 4.2.0 \-iwholename 4.2.0 \-ignore_readdir_race 4.2.0 \-fls 4.0 \-ilname 3.8 \-iname 3.8 \-ipath 3.8 \-iregex 3.8 .TE .P A sintaxe \fB\-perm +MODE\fP foi removida em findutils\-4.5.12, em favor de \fB\-perm\fP \fB/MODE\fP. A sintaxe \fB+MODE\fP foi descontinuada desde findutils\-4.2.21, que foi lançado em 2005. . .SH "NÃO BUGS" .SS "Surpresas de precedência de operadores" O comando \fBfind . \-name arquivoa \-o \-name arquivob \-print\fP nunca imprimirá um \fIarquivoa\fP porque isso é equivalente a \fBfind . \-name arquivoa \-o \e( \-name arquivob \-a \-print \e)\fP. Lembre\-se de que a precedência de \fB\-a\fP é mais alta do que a de \fB\-o\fP e quando não há operador especificado entre os testes, \fB\-a\fP é presumido. .SS "Mensagem de erro \(lqos caminhos devem preceder a expressão\(rq" .nf \fB$ find . \-name *.c \-print\fP find: os caminhos devem preceder a expressão find: padrão possivelmente sem aspas após o predicado `\-name'? .fi .P Isso acontece quando o shell pode expandir o padrão \fI*.c\fP para mais de um nome de arquivo existente no diretório atual e passar os nomes de arquivo resultantes na linha de comando para \fBfind\fP assim: .nf . \fBfind . \-name frcode.c locate.c word_io.c \-print\fP . .fi É claro que esse comando não vai funcionar, porque o predicado \fB\-name\fP permite exatamente apenas um padrão como argumento. Em vez de fazer as coisas dessa maneira, você deve colocar o padrão entre aspas ou escapar o caractere curinga, permitindo que \fBfind\fP use o padrão com o caractere curinga durante a pesquisa de correspondência de nome de arquivo em vez de nomes de arquivo expandidos pelo shell pai: .nf \fB$ find . \-name \(aq*.c\(aq \-print\fP \fB$ find . \-name \e*.c \-print\fP .fi . .SH BUGS There are security problems inherent in the behaviour that the POSIX standard specifies for \fBfind\fP, which therefore cannot be fixed. For example, the \fB\-exec\fP action is inherently insecure, and \fB\-execdir\fP should be used instead. . .P A variável de ambiente \fBLC_COLLATE\fP não tem efeito na ação \fB\-ok\fP. . .SH "RELATANDO PROBLEMAS" Ajuda online do GNU findutils: .br Relate erros de tradução para . .PP Relate outros problemas por meio do formulário no rastreador de bugs do GNU Savannah: .RS .RE Tópicos gerais sobre o pacote GNU findutils são discutidos na lista de discussão \fIbug\-findutils\fP: .RS .RE . .SH "DIREITOS AUTORAIS" Copyright \(co 1990\-2021 Free Software Foundation, Inc. Licença GPLv3+: GNU GPL versão 3 ou posterior . .br Este é um software livre: você é livre para alterá\-lo e redistribuí\-lo. NÃO HÁ QUALQUER GARANTIA, na máxima extensão permitida em lei. . .SH "VEJA TAMBÉM" \fBchmod\fP(1), \fBlocate\fP(1), \fBls\fP(1), \fBupdatedb\fP(1), \fBxargs\fP(1), \fBlstat\fP(2), \fBstat\fP(2), \fBctime\fP(3) \fBfnmatch\fP(3), \fBprintf\fP(3), \fBstrftime\fP(3), \fBlocatedb\fP(5), \fBregex\fP(7) .PP Documentação completa .br Ou disponível localmente via: \fBinfo find\fP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle . Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@\:lists.\:debian.\:org a lista de discussão de tradutores .ME .