gnome-search-tool(1) User Commands gnome-search-tool(1)NAMEgnome-search-tool - search for files
SYNOPSISgnome-search-tool [--named=text] [--path=folder] [--sortby=order]
[--descending] [--contains=string] [--user=user] [--nouser] [--all‐
mounts] [--empty] [--follow] [--group=group] [--hidden] [--mtime‐
less=date] [--mtimemore=date] [--notnamed=filename] [--regex=pattern]
[--sizeless=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 con‐
straint and set the text of that entry. Use a
full filename or a partial filename with wild‐
cards. 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 con‐
straint.
--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 con‐
straint and set the text of that entry. Use a
full filename or a partial filename with wild‐
cards. See find(1) for more details about
using wildcards.
--nouser Select the 'Owner is unrecognized' search con‐
straint.
--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 │gnome/gnome-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)