OPÇÕES POSICIONAIS¶

As opções posicionais sempre retornam verdadeiras. Eles afetam apenas os testes que ocorrem posteriormente na linha de comando.

-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

Turn warning messages on or off. These warnings apply only to the command line usage, not to any conditions that find might encounter when it searches directories. The default behaviour corresponds to -warn if standard input is a tty, and to -nowarn otherwise. If a warning message relating to command-line usage is produced, the exit status of find is not affected. If the POSIXLY_CORRECT environment variable is set, and -warn is also used, it is not specified which, if any, warnings will be active.

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, find 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 -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.

-files0-from file

Read the starting points from file instead of getting them on the command line. In contrast to the known limitations of passing starting points via arguments on the command line, namely the limitation of the amount of file names, and the inherent ambiguity of file names clashing with option names, using this option allows to safely pass an arbitrary number of starting points to find.

Using this option and passing starting points on the command line is mutually exclusive, and is therefore not allowed at the same time.

The file argument is mandatory. One can use -files0-from - to read the list of starting points from the standard input stream, and e.g. from a pipe. In this case, the actions -ok and -okdir are not allowed, because they would obviously interfere with reading from standard input in order to get a user confirmation.

The starting points in file have to be separated by ASCII NUL characters. Two consecutive NUL characters, i.e., a starting point with a Zero-length file name is not allowed and will lead to an error diagnostic followed by a non-Zero exit code later.

In the case the given file is empty, find does not process any starting point and therefore will exit immediately after parsing the program arguments. This is unlike the standard invocation where find assumes the current directory as starting point if no path argument is passed.

The processing of the starting points is otherwise as usual, e.g. find will recurse into subdirectories unless otherwise prevented. To process only the starting points, one can additionally pass -maxdepth 0.

Further notes: if a file is listed more than once in the input file, it is unspecified whether it is visited more than once. If the file is mutated during the operation of find, the result is unspecified as well. Finally, the seek position within the named file at the time find exits, be it with -quit or in any other way, is also unspecified. By "unspecified" here is meant that it may or may not work or do any specific thing, and that the behavior may change from platform to platform, or from findutils release to release.

-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.

-xautofs

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

-xdev

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

TESTES¶

Alguns testes, por exemplo, -newerXY e -samefile, 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 -H, -L e -P e qualquer -follow 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 stat(2) falha para isso), uma mensagem de erro será emitida e find sairá com um status diferente de zero.

Um argumento numérico n pode ser especificado para testes (como -amin, -mtime, -gid, -inum, -links, -size, -uid e -used) como

+n

para maior que n,

-n

para menor que n,

n

para exatamente n.

Testes suportados:

-amin n

O arquivo foi acessado pela última vez há menos, mais ou exatamente n minutos atrás.

-anewer referência

O horário do último acesso ao arquivo atual é mais recente que o da última modificação de dados do arquivo referência. Se referência for um link simbólico e a opção -H ou -L estiver em vigor, sempre será usado o horário da última modificação de dados do arquivo para o qual ele aponta.

-atime n

O arquivo foi acessado pela última vez há menos, mais ou exatamente 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 corresponder a -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á menos, mais ou exatamente n minutos atrás.

-cnewer referência

O horário do última alteração do status do arquivo atual é mais recente que o da última modificação de dados do arquivo referência. Se referência for um link simbólico e a opção -H ou -L estiver em vigor, sempre será usado o horário da última modificação de dados do arquivo para o qual ele aponta.

-ctime n

O status do arquivo foi alterado pela última vez há menos, mais ou exatamente n*24 horas atrás. 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 é menor, maior ou exatamente 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 menor, maior ou exatamente 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ísico.

-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á menos, mais ou exatamente n minutos atrás.

-mtime n

Os dados do arquivo foram modificados pela última vez há menor, mais ou exatamente n*24 horas atrás. 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

Base of file name (the path with the leading directories removed) matches shell pattern pattern. Because the leading directories are removed, the file names considered for a match with -name will never include a slash, so `-name a/b' will never match anything (you probably need to use -path instead). A warning is issued if you try to do this, unless the environment variable POSIXLY_CORRECT is set. The metacharacters (`*', `?', and `[]') match a `.' at the start of the base name (this is a change in findutils-4.2.2; see section STANDARDS CONFORMANCE below). To ignore a directory and the files under it, use -prune rather than checking every file in the tree; see an example in the description of that action. Braces are not recognised as being special, despite the fact that some shells including Bash imbue braces with a special meaning in shell patterns. The filename matching is performed with the use of the fnmatch(3) library function. Don't forget to enclose the pattern in quotes in order to protect it from expansion by the shell.

-newer referência

O horário do última modificação dos dados do arquivo atual é mais recente que o da última modificação de dados do arquivo referência. Se referência for um link simbólico e a opção -H ou -L estiver em vigor, sempre será usado o horário da última modificação de dados do arquivo para o qual ele aponta.

-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 exibir uma entrada para um diretório chamado ./src/misc (se houver). Para ignorar uma árvore de diretórios inteira, use prune 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:

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 -path 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 nome. Quando -L está em vigor, isso pode incluir links simbólicos.

-size n[cwbkMG]

O arquivo usa menos, mais ou exatamente 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. Tenha em mente 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 é menor que, maior que ou exatamente n.

-used n

O arquivo foi acessado pela última vez há menos, mais ou exatamente 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

Delete files or directories; true if removal succeeded. If the removal failed, an error message is issued and find's exit status will be nonzero (when it eventually exits).

Warning: Don't forget that find evaluates the command line as an expression, so putting -delete first will make find try to delete everything below the starting points you specified.

The use of the -delete action on the command line automatically turns on the -depth option. As in turn -depth makes -prune ineffective, the -delete action cannot usefully be combined with -prune.

Often, the user might want to test a find command line with -print prior to adding -delete for the actual removal run. To avoid surprising results, it is usually best to remember to use -depth explicitly during those earlier test runs.

The -delete action will fail to remove a directory unless it is empty.

Together with the -ignore_readdir_race option, find will ignore errors of the -delete action in the case the file has disappeared since the parent directory was read: it will not output an error diagnostic, not change the exit code to nonzero, and the return code of the -delete action will be true.

-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 é 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 xargs 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 "\") 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, 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. Por este motivo, -exec meu-comando ... {} + -quit pode não resultar em meu-comando ser executado. Esta variante de -exec sempre retorna verdadeiro.

-execdir comando ;

-execdir comando {} +

Like -exec, but the specified command is run from the subdirectory containing the matched file, which is not normally the directory in which you started find. 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 -exec action, the `+' form of -execdir will build a command line to process more than one matched file, but any given invocation of command will only list files that exist in the same subdirectory. If you use this option, you must ensure that your PATH 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 -execdir. The same applies to having entries in PATH 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 find returns a non-zero exit status. If find 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 + or the ; variant is being used; -execdir command {} + always returns true, while -execdir command {} ; returns true only if command returns 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

True; list current file in ls -dils format on standard output. The block counts are of 1 KB blocks, unless the environment variable POSIXLY_CORRECT is set, in which case 512-byte blocks are used. See the UNUSUAL FILENAMES section for information about how unusual characters in filenames are handled.

-ok comando ;

Like -exec 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 /dev/null. This action may not be specified together with the -files0-from option.

The response to the prompt is matched against a pair of regular expressions to determine if it is an affirmative or negative response. This regular expression is obtained from the system if the POSIXLY_CORRECT environment variable is set, or otherwise from find's message translations. If the system has no suitable definition, find's own definition will be used. In either case, the interpretation of the regular expression itself will be affected by the environment variables LC_CTYPE (character classes) and LC_COLLATE (character ranges and equivalence classes).

-okdir comando ;

Like -execdir but ask the user first in the same way as for -ok. If the user does not agree, just return false. If the command is run, its standard input is redirected from /dev/null. This action may not be specified together with the -files0-from option.

-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

Verdadeiro; 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 os escapes "\" e a diretivas "%". As larguras e precisões dos campos podem ser especificadas como na função C printf(3). Observe que muitos dos campos são impressos como %s em vez de %d, 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 dado, então -prune tem nenhum efeito. Porque -delete implica em -depth, você não pode usar de forma útil -prune e -delete juntos. Por exemplo, para pular o diretório src/emacs e todos os arquivos e diretórios dentro dele, e imprimir os nomes dos outros arquivos encontrados, faça algo como isso aqui:

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

-quit

Sai imediatamente (com valor de retorno zero se nenhum erro tiver ocorrido). Isso é diferente de -prune porque -prune só se aplica ao conteúdo de diretórios removidos, enquanto -quit simplesmente faz com que find pare imediatamente. Nenhum processo filho será deixado em execução. Quaisquer linhas de comando que foram criadas por -exec ... + ou -execdir ... + são invocadas antes de o programa ser encerrado. Depois que -quit for executado, nenhum outro arquivo especificado na linha de comando será processado. Por exemplo, `find /tmp/foo /tmp/bar -print -quit` imprimirá apenas `/tmp/foo`.
Um uso comum de -quit é parar de pesquisar o sistema de arquivos assim que encontrarmos o que queremos. Por exemplo, se quisermos encontrar apenas um único arquivo, podemos fazer o seguinte:

find / -name needle -print -quit

OPERADORES¶

Listados em ordem decrescente de precedência:

( 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.

Abordagem simples de `find|xargs`¶

•

Encontra arquivos com o nome core no ou abaixo do diretório /tmp e exclua-os.

$ find /tmp -name core -type f -print | xargs /bin/rm -f


    

Observe que isso não funcionará corretamente se houver nomes de arquivo que contenham novas linhas, aspas simples ou duplas ou espaços.

Abordagem mais segura `find -print0 | xargs -0`¶

•

Encontra arquivos com o nome core dentro ou sob o diretório /tmp e apaga-os, processando os nomes dos arquivos de forma que os nomes dos arquivos ou diretórios que contenham aspas simples ou duplas, espaços ou novas linhas sejam tratados corretamente.

$ find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f


    

The -name test comes before the -type test in order to avoid having to call stat(2) on every file.

Observe que ainda há uma corrida entre o momento em que find atravessa a hierarquia imprimindo os nomes de arquivo correspondentes e o momento em que o processo executado por xargs funciona com aquele arquivo.

Processing arbitrary starting points¶

•

Given that another program proggy pre-filters and creates a huge NUL-separated list of files, process those as starting points, and find all regular, empty files among them:

$ proggy | find -files0-from - -maxdepth 0 -type f -empty


    

The use of `-files0-from -` means to read the names of the starting points from standard input, i.e., from the pipe; and -maxdepth 0 ensures that only explicitly those entries are examined without recursing into directories (in the case one of the starting points is one).

Executando um comando para cada arquivo¶

•

Executa arquivo em cada arquivo no diretório atual ou abaixo dele.

$ find . -type f -exec file '{}' \;


    

Observe que as chaves são colocadas entre aspas simples para protegê-las de interpretação como pontuação de script de shell. O ponto e vírgula é protegido de forma semelhante pelo uso de uma barra invertida, embora as aspas simples também possam ter sido usadas nesse caso.

Em muitos casos, pode-se preferir a sintaxe `-exec ... +` ou, melhor, `-execdir ... +` por razões de desempenho e segurança.

Percorrendo o sistema de arquivos apenas uma vez -- para 2 ações diferentes¶

•

Percorre o sistema de arquivos apenas uma vez, listando arquivos e diretórios ID de usuário definido em /root/suid.txt e arquivos grandes em /root/big.txt.

$ find / \


\( -perm -4000 -fprintf /root/suid.txt '%#m %u %p\n' \) , \


\( -size +100M -fprintf /root/big.txt '%-10s %p\n' \)




    

Este exemplo usa o caractere de continuação de linha '\' nas primeiras duas linhas para instruir o shell a continuar lendo o comando na próxima linha.

Pesquisando arquivos por idade¶

•

Procura arquivos em seu diretório inicial que foram modificados nas últimas vinte e quatro horas.

$ find $HOME -mtime 0


    

Este comando funciona assim porque o tempo decorrido desde a última modificação de cada arquivo é dividido por 24 horas e o restante é descartado. Isso significa que para corresponder a -mtime 0, um arquivo terá que ter uma modificação no passado, que é menos de 24 horas atrás.

Pesquisando arquivos por permissões¶

•

Pesquisa arquivos que são executáveis, mas não legíveis.

$ find /sbin /usr/sbin -executable \! -readable -print


    

•

Pesquisa arquivos que tenham permissão de leitura e gravação para seu dono e grupo, mas que outros usuários possam ler, mas não podem escrever.

$ find . -perm 664


    

Os arquivos que atendem a esses critérios, mas têm outros bits de permissão definidos (por exemplo, se alguém pode executar o arquivo), não serão correspondidos.

•

Pesquisa arquivos que tenham permissão de leitura e escrita para seu dono e grupo e que outros usuários possam ler, independentemente da presença de bits de permissão extras (por exemplo, o bit executável).

$ find . -perm -664


    

Isso corresponderá a um arquivo que possui o modo 0777, por exemplo.

•

Pesquisa por arquivos que podem ser escritos por alguém (seu dono, seu grupo ou qualquer outra pessoa).

$ find . -perm /222


    

•

Pesquisa os arquivos que podem ser escritos pelo dono ou pelo grupo.

$ find . -perm /220
$ find . -perm /u+w,g+w
$ find . -perm /u=w,g=w


    

Todos os três comandos fazem a mesma coisa, mas o primeiro usa a representação octal do modo de arquivo e os outros dois usam a forma simbólica. Os arquivos não precisam poder ser escritos tanto pelo dono quanto pelo grupo para serem combinados; qualquer um servirá.

•

Pesquisa por arquivos que possam ser escritos tanto pelo dono quanto pelo grupo.

$ find . -perm -220
$ find . -perm -g+w,u+w


    

Ambos os comandos fazem a mesma coisa.

•

Uma pesquisa mais elaborada sobre permissões.

$ find . -perm -444 -perm /222 \! -perm /111
$ find . -perm -a+r -perm /a+w \! -perm /a+x


    

Esses dois comandos procuram arquivos que são legíveis para todos (-perm -444 ou -perm -a+r), têm pelo menos um conjunto de bits de escrita (-perm /222 ou -perm /a+w), mas não são executáveis para ninguém (! -perm /111 ou ! -perm /a+x, respectivamente).

Remoção (prune) - omitindo arquivos e subdiretórios¶

•

Copy the contents of /source-dir to /dest-dir, but omit files and directories named .snapshot (and anything in them). It also omits files or directories whose name ends in `~', but not their contents.

$ cd /dir-origem
$ find . -name .snapshot -prune -o \( \! -name '*~' -print0 \) \




| cpio -pmd0 /dir-dest




    

A construção -prune -o \( ... -print0 \) é bastante comum. A ideia aqui é que a expressão antes de -prune corresponda às coisas que devem ser removidas. No entanto, a ação -prune em si retorna verdadeiro, então o -o a seguir garante que o lado direito seja avaliado apenas para aqueles diretórios que não foram removidos (o conteúdo dos diretórios removidos nem mesmo é visitado , então seu conteúdo é irrelevante). A expressão do lado direito do -o está entre parênteses apenas para maior clareza. Ele enfatiza que a ação -print0 ocorre apenas para coisas que não tinham -prune aplicado a elas. Como a condição "e" padrão entre os testes liga-se mais fortemente do que -o, este é o padrão de qualquer maneira, mas os parênteses ajudam a mostrar o que está acontecendo.

•

Dado o seguinte diretório de projetos e seus diretórios administrativos SCM associados, execute uma busca eficiente pelas raízes dos projetos:

$ find repo/ \


\( -exec test -d '{}/.svn' \; \
-or -exec test -d '{}/.git' \; \
-or -exec test -d '{}/CVS' \; \
\) -print -prune




    

Amostra da saída:

repo/projeto1/CVS
repo/gnu/projeto2/.svn
repo/gnu/projeto3/.svn
repo/gnu/projeto3/src/.svn
repo/projeto4/.git


    

Neste exemplo, -prune evita descida desnecessária em diretórios que já foram descobertos (por exemplo, não pesquisamos projeto3/src porque já encontramos projeto3/.svn), mas garante diretórios irmãos (projeto2 e projeto3) são encontrados.

Outros exemplos úteis¶

•

Pesquisa vários tipos de arquivo.

$ find /tmp -type f,d,l


    

Pesquisa arquivos, diretórios e links simbólicos no diretório /tmp passando esses tipos como uma lista separada por vírgulas (extensão GNU), que de outra forma é equivalente ao mais longo, porém mais portátil:

$ find /tmp \( -type f -o -type d -o -type l \)


    

•

Pesquisa por arquivos com o nome específico agulha e para imediatamente quando encontrarmos o primeiro.

$ find / -name agulha -print -quit


    

•

Demonstra a interpretação das diretivas de formato %f e %h da ação -printf para alguns casos extremos. Aqui está um exemplo incluindo alguma saída.

$ find . .. / /tmp /tmp/TRACE compile compile/64/tests/find -maxdepth 0 -printf '[%h][%f]\n'
[.][.]
[.][..]
[][/]
[][tmp]
[/tmp][TRACE]
[.][compile]
[compile/64/tests][find]


    

Surpresas de precedência de operadores¶

O comando find . -name arquivoa -o -name arquivob -print nunca imprimirá um arquivoa porque isso é equivalente a find . -name arquivoa -o \( -name arquivob -a -print \). Lembre-se de que a precedência de -a é mais alta do que a de -o e quando não há operador especificado entre os testes, -a é presumido.

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

É claro que esse comando não vai funcionar, porque o predicado -name 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 find 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:

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