# Search for Files Manual

A search tool to find files, folders and documents on your computer.

2015-2021 MATE Documentation Project
2005 Dennis Cranston
2002 2003 2004 Sun Microsystems
2000 Alexander Kirillov
Projècte de documentacion de MATE GNOME Documentation Project

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

Aqueste manual fa part de la colleccion de manuals de MATE distribuits jols tèrmes de la licéncia de documentacion liura GNU. Se volètz distribuir aqueste document a despart de la colleccion, o podètz far en ajustant un exemplar de la licéncia al manual, coma indicat a la seccion 6 de la licéncia.

La màger part dels noms utilizats per las entrepresas per distinguir lors produches e servicis son de marcas depausadas. Quand aqueles noms apareisson dins la documentacion MATE e que los membres del projècte de Documentacion MATE son informats de l’existéncia d’aquelas marcas depausadas, siá aqueles noms entièrs, siá lor primièra letra es en majuscula.

LOS DOCUMENTS E LAS VERSIONS MODIFICADAS D’AQUESTE DOCUMENT SON FORNITS JOLS TÈRMES DE LA LICÉNCIA DE DOCUMENTACION LIURA GNU ESTANT QUE :

1. LO DOCUMENT ES PROVESIT « TAL COMA ES » SENS CAP DE GARANTIDA DE QUIN TIPE QUE SIÁ, EXPLICITA O IMPLICADA, AQUÒ INCLUTZ, SENS CAP DE LIMIT, LAS GARANTIDAS QUE LO DOCUMENT O UNA VERSION MODIFICADA NON AJA PAS CAP DE DEFAUT, QUE SIÁ COMERCIABLE, QUE SIÁ ADAPTAT PER UN USATGE PARTICULAR O QUE ENFRANGA PAS LA LEI. TOT LO RISC RESPÈCTE A LA QUALITAT, L’EXACTITUD O LAS QUALITATS TECNICAS DEL DOCUMENT O DE SAS VERSIONS MODIFICADAS ES VÒSTRE. SE PER CAS LO DOCUMENT O UNA VERSION MODIFICADA S’AVERÈSSE DEFECTUÓS AL RESPÈCTE DE QUIN ASPÈCTE QUE SIÁ, VOSAUTRES (NON PAS LO REDACTOR INICIAL, L’AUTOR O QUIN CONTRIBUIDOR QUE SIÁ) ASSUMISSÈTZ LO CÒST DE TOTA MANTENENÇA, REPARACION O CORRECCION NECESSÀRIA. AQUESTA DESCARGA DE GARANTIDA CONSTITUÍS UNA PART ESSENCIALA D’AQUESTA LICÉNCIA. CAP D’UTILIZACION D’AQUESTE DOCUMENT O VERSION MODIFICADA ES AUTORIZADA LEVAT JOS AQUESTA DESCARGA DE GARANTIDA E

2. EN CAP DE CIRCONSTÀNCIA E JOS CAP D’INTERPRETACION LEGALA, QUE SIÁ DE RESPONSABILITAT CIVILA (NEGLIGÉNCIA INCLUSA), CONTRACTUALA O AUTRA, L’AUTOR, LO REDACTOR INICIAL, TOT CONTRIBUIDOR E TOT DISTRIBUIDOR D’AQUESTE DOCUMENT O DE SA VERSION MODIFICADA NI CAP DE PROVESIDOR D’AQUESTES PARTS SERÀN PAS RESPONSABLES AL RESPÈCTE DE QUIN DAMATGE DIRÈCTE, INDIRÈCTE, ESPECIAL O ACCIDENTAL QUE SIÁ DE TOT TIPE E TANBEN, SENS LIMITACION, LOS DAMATGES LIGATS A LA PÈRDA DE CLIENTÈLA, LAS INTERRUPCIONS DE TRABALH, ALS DEFALHIMENTS E DISFONCIONAMENTS INFORMATICS O TOTA AUTRA PÈRDA LIGADA A L’UTILIZACION DEL DOCUMENT E DE SAS VERSIONS MODIFICADAS, ATAL METEIS S’AQUESTES PART ÈRAN AVISATS DE LA POSSIBILITAT D’AQUESTES DAMATGES.

MATE Documentation Team
Search for Files Maintainer
Dennis Cranston
Search for Files Maintainer

    dennis_cranston@yahoo.com

Sun GNOME Documentation Team
Sun Microsystems

Alexander Kirillov
GNOME Documentation Project

     kirillov@math.sunysb.edu

Search for Files Manual V1.10
July 2015

Wolfgang Ulbrich

Search for Files Maintainer

Search for Files Manual V2.7
June 2005

Joachim Noreiko jnoreiko@yahoo.com

Search for Files Maintainer

Search for Files Manual V2.6
January 2005

Dennis Cranston dennis_cranston@yahoo.com

Search for Files Maintainer

Search for Files Manual V2.4
February 2004

Sun GNOME Documentation Team

GNOME Documentation Project

Search for Files Manual V2.3
September 2002

Sun GNOME Documentation Team

GNOME Documentation Project

Search for Filesl Manual V2.2
August 2002

Sun GNOME Documentation Team

GNOME Documentation Project

Search for Files Manual V2.1
July 2002

Sun GNOME Documentation Team

GNOME Documentation Project

Search for Files Manual V2.0
May 2002

Sun GNOME Documentation Team

GNOME Documentation Project

Search for Files Manual
2000

Alexander Kirillov kirillov@math.sunysb.edu

GNOME Documentation Project

This manual describes version 1.10 of Search for Files.

Comentaris

Per senhalar una avaria o per formular una suggestion a prepaus de la Recèrca de fichièrs a o aqueste manual, seguissètz las instruccions dins la pagina de comentaris de MATE.

Yannig Marchegay (Kokoyaya) <yannig@marchegay.org> & Cédric Valmary (totenoc.eu)cvalmary@yahoo.fr
Quentin PAGÈS Yannig Marchegay (Kokoyaya) <yannig@marchegay.org> & Cédric Valmary (totenoc.eu)

## Introduccion

The Search for Files application enables you to search for files on your system. To perform a basic search, you can type a filename or a partial filename, with or without wildcards. To refine your search, you can apply additional search options.

Search for Files uses the `find`, `grep`, and `locate` UNIX commands. By default, when performing a basic search Search for Files first uses the `locate` command, and then uses the slower but more thorough `find` command.

The case sensitivity of the search depends on your operating system. For example, on Linux, the `find`, `grep`, and `locate` commands support the `-i` option, so all searches are case-insensitive.

## Començar

You can start Search for Files in the following ways:

From a Menu Bar on a panel

  Choose Places Search for Files...

From a Main Menu on a panel

  Choose Search for Files...

From a command line

  Execute the following command: `mate-search-tool`

When you start Search for Files, the following window is displayed.

Search for Files Window

Shows Search for Files main window.

## Utilizacion

### To Perform a Basic Search

To perform a basic search for a file on the system, perform the following steps:

1. Enter the search text in the Name contains field. The search text can be a filename or partial filename, with or without wildcards, as shown in the following table:

   Name Contains Text | Exemple | Result
   --- | --- | ---
   Full or partial filename | `myfile.txt` | Search for Files searches for all files that contain the text `myfile.txt` in the filename.
   Partial filename combined with wildcards (*, [, ]) | `*.[ch]` | Search for Files searches for all files that have extension `.c` or `.h`.

2. In the Look in folder field, select the folder or device from which you want Search for Files to begin the search.

3. Click Find to perform the search.

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.

### To Add Search Options

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

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

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.

Search Options

Nom de l’opcion | Descripcion
--- | ---
Contains the text | Search for files of type plain text that contain the specified text.
Date modified less than | Search for files that are modified less than the period specified in days.
Data de modificacion superiora a | Search for files that are modified longer than the period specified in days.
Size at least | Search for files that are equal to or larger than the size specified in kilobytes.
Size at most | Search for files that are smaller than or equal to the size specified in kilobytes.
Lo fichièr es void | Search for empty files.
Owned by user | Search for files that are owned by the user specified. Type the name of the user in the text box provided.
Owned by group | Search for files that are owned by the group specified. Type the name of the group in the text box provided.
Proprietari pas reconegut | Search for files that are owned by a user or group that is unknown to the system.
Name does not contain | 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.
Name matches regular expression | Search for files that contain the specified regular expression in their directory path or filename. Type the regular expression in the text box provided.
Visualizar los fichièrs amagats e de salvagarda | Include hidden and backup files in the search.
Seguir los ligams simbolics | Follow symbolic links when searching for files.
Exclure los autres sistèma de fichièrs | Search in directories that are in the same filesystem as the start directory.

### To Stop a Search

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

### To Open a Displayed File

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.

- Double-click on the file.

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.

### To Delete a Displayed File

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

### To Save the Search Results

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.

## Paramètres

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:

Menú Aplicacions

  Choose System Tools dconf Editor.

Linha de comanda

  Execute the following command: `dconf-editor`

### Desactivar la recèrca rapida

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

Default value: 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.

### Disable Quick Search Second Scan

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

Default value: 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.

### Quick Search Excluded Paths

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

Default values: [/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.

### Quick Search Second Scan Excluded Paths

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

Default values: [/]

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.

### Afichar las opcions addicionalas

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

Default value: false

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

Aisina de recèrca