2002 2003 2004 Sun Microsystems 2000 Alexander Kirillov GNOME Documentation Project &legal; Sun GNOME Documentation Team Sun Microsystems

Alexander Kirillov GNOME Documentation Project

kirillov@math.sunysb.edu

&app; Manual V&manrevision; &date; Sun GNOME Documentation Team GNOME Documentation Project Search Tool Manual V2.4 February 2004 Sun GNOME Documentation Team GNOME Documentation Project Search Tool Manual V2.3 September 2002 Sun GNOME Documentation Team GNOME Documentation Project Search Tool Manual V2.2 August 2002 Sun GNOME Documentation Team GNOME Documentation Project Search Tool Manual V2.1 July 2002 Sun GNOME Documentation Team GNOME Documentation Project Search Tool Manual V2.0 May 2002 Sun GNOME Documentation Team GNOME Documentation Project GNOME Search Tool Manual 2000 Alexander Kirillov kirillov@math.sunysb.edu GNOME Documentation Project This manual describes version &appversion; of &app;. To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page. Search Tool The &app; 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. &app; uses the find, grep, and locate UNIX commands. 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. You can start &app; in the following ways: Applications menu Choose ActionsSearch for Files. Command line Execute the following command: gnome-search-tool When you start &app;, the following window is displayed.

Shows &app; main window.

To perform a basic search for a file on the system, perform the following steps: 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: Search Text Example Result Full or partial filename myfile.txt &app; searches for all files that contain the text myfile.txt in the filename. Partial filename combined with wildcards (*, [, ]) *.[ch] &app; searches for all files that have extension .c or .h. In the Look in folder field, enter the path to the directory in which you want &app; to begin the search. Click Find to perform the search. &app; searches in the directory that you specify and the subdirectories of the directory. &app; displays the results of the search in the Search results list box. If &app; does not find any files that match the search criteria, the application displays the message "No files found" in the Search results list box. You can add additional options to search for a file on the system. To add search options, perform the following steps: Click on the Show more options text. Click on the Available options drop-down list. Select the search option that you want to apply. Click Add. Specify the required search information for the search option, as described in . 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. Option Name Description Contains the text Search for a file by filename. 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. Date modified less than (days) Search for files that are modified less than the period specified. Date modified more than (days) Search for files that are modified longer than the period specified. Size at least (kilobytes) Search for files that are larger than the size specified. Size at most (kilobytes) Search for files that are smaller than the size specified. File is empty 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. Owner is unrecognized 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. Show hidden and backup files Include hidden and backup files in the search. Follow symbolic links Follow symbolic links when searching for files. Include other filesystems Search in directories that are not in the same filesystem as the start directory. Click Stop to stop a search before &app; completes the search. 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 Folder. To delete a file displayed in the Search results list box, right-click on the file, then choose Move to Trash. To save the results of the last search that &app; 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.