# Search for Files Manual

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

2019 MATE Documentation Project
2005 Dennis Cranston
2002 2003 2004 Sun Microsystems
2000 Alexander Kirillov
MATE 文档项目 GNOME 文档项目

对于本文档的复制、分发和／或修改必须遵循自由软件基金会 (Free Software Foundation) 发布的 GNU 自由文档许可证 (GFDL) 版本 1.1 或更高版本，该许可证没有固定的部分、没有封面和背页文本。您可以在此链接上或在随本手册一起分发的 COPYING-DOCS 文件中找到 GFDL 的副本。

本手册是在 GFDL 许可之下分发的 MATE 手册集合的一部分。如果想要单独分发此手册，可以在手册中添加该许可证的一份副本然后分发，如该许可证的第 6 部分所述。

各个公司使用的许多用于区别它们产品和服务的名称都声明为商标。在所有的 MATE 文档以及 MATE 文档项目的成员中，这些名称都是以全大写字母或首字母大写显示，从而表明它们是商标。

本文档和文档是根据 GNU 免费文档许可协议的条款提供的，并且还有进一步的阐述:

1. 文档按“原样”提供，不提供任何明示或暗示的保证，包括但不限于：文档或文档的修改版本没有适销性方面的缺陷、适合特定目的的适用性，以及没有侵权行为。您将自行承担本文档以及文档修改版本的质量、准确性以及性能方面的风险。如果任何文档或文档修改版本存在缺陷，您(而不是最初的编写者、作者或撰写人)将承担所有必需的服务、维修或更正的费用。此免责声明是本许可证的重要组成部分。如果不接受此免责声明，那么您就没有权利使用任何文档或文档的修改版本；并且

2. 无论在任何情况以及在任何法律理论下，本文档或文档修改版本的作者、最初的编写者、任何撰写人或任何分发者，或者任意这些方的任何提供者都不对任何人由于使用本文档或文档修改版本引起或带来的任何直接的、间接的、特殊的、偶然的或继发的损失承担任何民事(包括疏忽)、合同或其它方面的责任，这些损失包括但不限于信誉损失、工作停止、计算机失败或故障，或任何以及所有其它损失或由此引发的或与之相关的损失，即使这些方已被告知存在出现此类损失的可能性时也是如此。

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

反馈

To report a bug or make a suggestion regarding the Search for Files application or this manual, follow the directions in the MATE Feedback Page.

Christopher Meng i@cicku.me
2012-2013 Christopher Meng
ravix dr.neemous@gmail.com
2013 ravix
Dianjin Wang 1132321739qq@gmail.com
2012 Dianjin Wang
Cravix dr.neemous@gmail.com
2013 Cravix
nyanyh rebuilty@gmail.com
2013 nyanyh
liulitchi xingzuo88@qq.com
2013 liulitchi
玉堂白鹤 yjwork@qq.com
2015 玉堂白鹤
Mingye Wang arthur200126@gmail.com
2015-2016 Mingye Wang
白铭骢 jeffbai@aosc.xyz
2015-2016 白铭骢
刘子兴 liushuyu@aosc.xyz
2015-2016 刘子兴

## 介绍

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.

## Getting Started

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.

## 用法

### 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 | Example | 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. Click Add.

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

Option Name | 描述
--- | ---
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.
修改日期多于(_Y) | 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.
文件为空 | 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.
未知的所属用户 | 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.
显示隐藏文件和备份文件 | Include hidden and backup files in the search.
跟随符号连接 | Follow symbolic links when searching for files.
排除其它文件系统 | 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.

## Settings

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:

应用程序菜单

  Choose System Tools dconf Editor.

命令行

  Execute the following command: `dconf-editor`

### 禁用快速搜索

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.

### 禁用快速搜索第二次扫描

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.

### 快速搜索排除的路径

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.

### 快速搜索第二次扫描排除的路径

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.

### 选择额外选项

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.

Search Tool