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

NAME

       gnome-search-tool - search for files

SYNOPSIS

       gnome-search-tool [--named=text] [--path=folder] [--sortby=order] [--descending] [--contains=string] [--user=user] [--nouser] [--allmounts]
       [--empty] [--follow] [--group=group] [--hidden]	[--mtimeless=date]  [--mtimemore=date]	[--notnamed=filename]  [--regex=pattern]  [--size-
       less=size] [--sizemore=size] [--start] [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.

       --contains=string       Select  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.

       --hidden 	       Select the 'Show hidden and backup files' search option.

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

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

       --named=text	       Set the text of the 'Name contains' search option.

       --notnamed=filename     Select 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.

       --start		       Automatically start a search.

       --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-options       Standard 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-tool      Executable for Search for Files

ATTRIBUTES

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

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

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, 2006.

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