gnome-search-tool(1)						   User Commands					      gnome-search-tool(1)

NAME

       gnome-search-tool - search for files

SYNOPSIS

       gnome-search-tool   [--name=filename]  [--path=folder]  [--sortby=order]  [--descending]  [--autostart]	[--contains=string]  [--user=user]
       [--group=group]	[--nouser]  [--mtimeless=date]	[--mtimemore=date]  [--sizeless=size]  [--sizemore=size]  [--empty]  [--notnamed=filename]
       [--regex=pattern] [--follow] [--allmounts] [gnome-std-options]

DESCRIPTION

       The Search for Files application enables you to search for files on your system. Search for Files uses the find(1) command.

OPTIONS

       The following options are supported:

       --allmounts     Select the 'Search other filesystems' search constraint.

       --autostart     Automatically start a search.

       --contains=strinSelect  the 'Contains the text' search constraint and set the text of that entry. Use a full filename or a partial filename
		       with wildcards.	See find(1) for more details about using wildcards.

       --descending    Set sort order to descending. The default sort order is ascending.

       --empty	       Select the 'File is empty' search constraint.

       --follow        Select the 'Follow symbolic links' search constraint.

       --group=group   Select the 'Owned by group' search constraint and set the text of that entry.

       --mtimeless=dateSelect the 'Date modified before (days)' search constraint and set the text of that entry.

       --mtimemore=dateSelect the 'Date modified after (days)' search constraint and set the text of that entry.

       --name=filename Set the text of the 'File is named' entry. Use a full filename or a partial filename with wildcards. See find(1)  for  more
		       details about using wildcards.

       --notnamed=filenSelect  the 'File is not named' search constraint and set the text of that entry. Use a full filename or a partial filename
		       with wildcards.	See find(1) for more details about using wildcards.

       --nouser        Select the 'Owner is unrecognized' search constraint.

       --path=folder   Set the text of the 'Look in folder' entry. Defaults to the current working directory.

       --regex=pattern Select the 'File matches regular expression' search constraint and set the text of that entry. See find(1) for more details
		       about the regular expression patterns that can be used.

       --sizeless=size Select the 'Size is less than (kilobytes)' search constraint and set the text of that entry.

       --sizemore=size Select the 'Size is more than (kilobytes)' search constraint and set the text of that entry.

       --sortby=order  Sort files by one of the following: name, folder, size, type, or date.

       --user=user     Select the  'Owned by user' search constraint and set the text of that entry.

       gnome-std-optionStandard options available for use with most GNOME applications.  See gnome-std-options(5) for more information.

EXAMPLES

       Example 1: Performing a basic search automatically

       example% gnome-search-tool --name=a.out --path=$HOME --autostart

       Example 2: Performing an advanced search automatically

       example% gnome-search-tool --contains=unistd.h --mtimeless=3 --sortby=size      --autostart

EXIT STATUS

       The following exit values are returned:

       0	Application exited successfully

       >0	Application exited with failure

FILES

       The following files are used by this application:

       /usr/bin/gnome-search-toExecutable for Search for Files

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-search-tool	   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       Search for Files Manual

       Latest version of the GNOME Desktop User Guide for your platform.

       find(1), gnome-std-options(5)

NOTES

       Written by Glynn Foster, Sun Microsystems  Inc., 2003.

SunOS 5.10							    2 Oct 2003						      gnome-search-tool(1)