# Manual do Pesquisar por arquivos

## Introdução

O aplicativo Pesquisar por arquivos permite que você pesquise por arquivos em seu sistema. Para realizar uma pesquisa básica, você pode digitar um nome de arquivo inteiro ou parcial, com ou sem caractere coringa. Para refinar sua pesquisa, você pode aplicar opções de pesquisa adicionais.

O Pesquisar por arquivos usa os comandos UNIX `find`, `grep` e `locate`. Por padrão, ao se realizar uma pesquisa básica, o Pesquisar por arquivos primeiro usa o comando `locate` e, então, usa o mais lento, porém mais completo `find`.

A diferenciação entre maiúsculo e minúsculo na pesquisa depende do seu sistema operacional. Por exemplo, no Linux os comandos `find`, `grep` e `locate` têm suporte à opção `-i`, de forma que todas as pesquisas possam diferenciar.

## Primeiros passos

Você pode iniciar o Pesquisar por arquivos das seguintes formas:

De uma Barra de menu em um painel

- Escolha Locais Pesquisar por arquivos...

De um Menu principal em um painel

- Escolha Pesquisar por arquivos...

De uma linha de comando

- Execute o seguinte comando: `gnome-search-tool`

Quando você iniciar o Pesquisar por arquivos, a seguinte janela será exibida.

### Janela do Pesquisar por arquivos

Mostra a janela principal do Pesquisar por arquivos.

## Utilização

### Para realizar uma pesquisa básica

Para realizar uma pesquisa básica a um arquivo no sistema, faça os seguintes passos:

1. Digite o texto de pesquisa no campo Nome contém. O texto de pesquisa pode ser um nome de arquivo completo ou parcial, com ou sem caracteres coringas, como mostrar na tabela a seguir:

   Nome contém texto | Exemplo | Resultado
   Nome completo ou parcial | `meuarquivo.txt` | Pesquisar por arquivos pesquisa em todos os arquivos que contêm o texto `meuarquivo.txt` no nome do arquivo.
   Nome de arquivo parcial combinado com caracteres coringas (*, [, ]) | `*.[ch]` | Pesquisar por arquivos pesquisa por todos os arquivos que possuem a extensão `.c` ou `.h`.

2. No campo Pesquisar na pasta, selecione a pasta ou dispositivo a partir do qual você deseja que Pesquisar por arquivos comece a pesquisar.

3. Clique em Localizar para fazer a pesquisa.

Search for Files searches in the directory that you specify and the subdirectories of the directory. Search for Files displays the results of the search in the Search results list box. If Search for Files does not find any files that match the search criteria, the application displays the message "No files found" in the Search results list box.

By default, Search for Files will perform a quick search using the `locate` command followed by a more thorough second search using the `find` command. The `locate` command is faster because it uses a database of information about files. If this database is more than a week old, Search for Files could warn you that the search results may be out of date and give you the option of disabling the quick search. To update the database, run the command `updatedb` as the root user.

### Adicionar novo critério a esta pesquisa

You can add additional options to search for a file on the system. To add search options, perform the following steps:

1. Click on the Select more options text.

2. Click on the Available options drop-down list.

3. Select the search option that you want to apply.

4. Clique Adicionar.

5. Specify the required search information for the search option, as described in tbl-search-rules.

6. Repeat the above steps for each search option that you want to apply.

To remove a search option from the current search, click on the Remove button next to the option.

To disable the search options from the current search, click on the Select more options text.

### Opções de pesquisa

Nome da opção | Descrição
Contém o texto | Search for files of type plain text that contain the specified text.
Última modificação antes de | Search for files that are modified less than the period specified in days.
Última modificação depois de | Search for files that are modified longer than the period specified in days.
Tamanho mínimo | Search for files that are equal to or larger than the size specified in kilobytes.
Tamanho máximo | Search for files that are smaller than or equal to the size specified in kilobytes.
O arquivo está vazio | Pesquisar por arquivos abertos.
Propriedade do usuário | Search for files that are owned by the user specified. Type the name of the user in the text box provided.
Propriedade do grupo | Search for files that are owned by the group specified. Type the name of the group in the text box provided.
Proprietário irreconhecível | Search for files that are owned by a user or group that is unknown to the system.
Nome não contém | Search for filenames that do not contain the string that you enter. Enter a full filename or a partial filename with wildcards in the field provided. Use * to indicate a sequence of characters. Use ? to indicate a single character. The search is case sensitive.
Nome corresponde à expressão regular | Search for files that contain the specified regular expression in their directory path or filename. Type the regular expression in the text box provided.
Mostrar arquivos ocultos e de backup | Include hidden and backup files in the search.
Seguir links simbólicos | Follow symbolic links when searching for files.
Excluir outros sistemas de arquivos | Search in directories that are in the same filesystem as the start directory.

### Para interromper uma pesquisa

Click Stop to stop a search before Search for Files completes the search.

### Para abrir um arquivo exibido

To open a file displayed in the Search results list box, perform one of the following steps:

- Right-click on the file, then choose Open.

- Clique-duplo no arquivo.

To open the folder that contains a file displayed in the Search results list box, right-click on the file, then choose Open Containing Folder.

### Para excluir um arquivo exibido

To delete a file displayed in the Search results list box, right-click on the file, then choose Move to Trash.

### Para salvar os resultados de pesqusia

To save the results of the last search that Search for Files performed, right-click in the Search results list, then choose Save Results As. Enter the name of the file to which you want to save the results, then click Save.

## Configurações

Search for Files provides gsettings keys to modify some of its behavior. The gsettings values can be changed by starting the Configuration Editor in the following ways:

Menu de Aplicativos

- Vá até Ferramentas do sistema Editor dconf.

Linha de comando

- Execute o seguinte comando: `dconf-editor`

### Desabilitar a pesquisa rápida

Key name: org.gnome.gnome-search-tool.disable-quick-search

Valor padrão: false

Search for Files speeds up file name searches by using the `locate` command. `Locate` provides a secure way to index and quickly search for file names. Because `locate` relies on a file index, the Search results list may not always be up to date.

### Desabilitar a segunda varredura da pesquisa rápida

Key name: org.gnome.gnome-search-tool.disable-quick-search-second-scan

Valor padrão: false

After completing a quick search, Search for Files will perform a thorough search using the `find` command. The purpose of this second scan is to find files that have not been indexed. Files that match the search criteria are added to the Search results list keeping the list up to date.

### Caminhos excluídos da pesquisa rápida

Key name: org.gnome.gnome-search-tool.quick-search-excluded-paths

Valores padrão: [/mnt/*,/media/*,/dev/*,/tmp/*,/proc/*,/var/*]

Search for Files will not perform a quick search for paths defined by this key. File name searches in the defined paths will use the `find` command. The wildcards '*' and '?' are supported.

### Caminhos excluídos da segunda pesquisa rápida

Key name: org.gnome.gnome-search-tool.quick-search-second-scan-excluded-paths

Valores padrão: [/]

Search for Files will not perform a second scan after a quick search for the paths defined by this key. Quick searches in the defined paths will not be followed by a thorough search using the `find` command. The wildcards '*' and '?' are supported.

### Mostra opções adicionais

Key name: org.gnome.gnome-search-tool.show-additional-options

Valor padrão: false

This key determines if the Select more options section is expanded when Search for Files is started.