10139N/A<!
DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
10139N/A<!
ENTITY cmd "gnome-search-tool">
10139N/A<!
ENTITY suncopy "Copyright (c) 2003,2006 Sun Microsystems, Inc. All Rights Reserved.">
10139N/A<
refentry id="gnome-search-tool-1">
10139N/A<
refmeta><
refentrytitle>gnome-search-tool</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A<
refmiscinfo class="date">2 Oct 2003</
refmiscinfo>
10139N/A<
refmiscinfo class="sectdesc">&man1;</
refmiscinfo>
10139N/A<
refmiscinfo class="software">&release;</
refmiscinfo>
10139N/A<
refmiscinfo class="arch">generic</
refmiscinfo>
10139N/A<
refmiscinfo class="copyright">&suncopy;</
refmiscinfo>
10139N/A<
indexterm><
primary>gnome-search-tool</
primary></
indexterm><
indexterm><
primary>
10139N/Asearch for files</
primary></
indexterm><
refnamediv id="gnome-search-tool-1-name">
10139N/A<
refname>gnome-search-tool</
refname><
refpurpose>search for files</
refpurpose></
refnamediv>
10139N/A<
refsynopsisdiv id="gnome-search-tool-1-synp"><
title>&synp-tt;</
title>
10139N/A<
cmdsynopsis><
command>&cmd;</
command>
10139N/A<
arg choice="opt"><
option>-named=<
replaceable>text</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-path=<
replaceable>folder</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-sortby=<
replaceable>order</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-descending</
option></
arg>
10139N/A<
arg choice="opt"><
option>-contains=<
replaceable>string</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-user=<
replaceable>user</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-nouser</
option></
arg>
10139N/A<
arg choice="opt"><
option>-allmounts</
option></
arg>
10139N/A<
arg choice="opt"><
option>-empty</
option></
arg>
10139N/A<
arg choice="opt"><
option>-follow</
option></
arg>
10139N/A<
arg choice="opt"><
option>-group=<
replaceable>group</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-hidden</
option></
arg>
10139N/A<
arg choice="opt"><
option>-mtimeless=<
replaceable>date</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-mtimemore=<
replaceable>date</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-notnamed=<
replaceable>filename</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-regex=<
replaceable>pattern</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-sizeless=<
replaceable>size</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-sizemore=<
replaceable>size</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-start</
option></
arg>
10139N/A<
arg choice="opt"><
option role="nodash"><
replaceable>gnome-std-options</
replaceable></
option></
arg>
10139N/A<
refsect1 id="gnome-search-tool-1-desc"><
title>&desc-tt;</
title>
10139N/A<
para>The Search for Files application enables you to search for files on
10139N/Ayour system. Search for Files uses the <
citerefentry><
refentrytitle>find</
refentrytitle>
10139N/A<
manvolnum>1</
manvolnum></
citerefentry> command.</
para>
10139N/A<
refsect1 id="gnome-search-tool-1-opts"><
title>&opts-tt;</
title>
10139N/A<
para>The following options are supported:</
para>
10139N/A<
variablelist termlength="medium"><
varlistentry><
term><
option>-allmounts</
option></
term>
10139N/A<
listitem><
para>Select the 'Search other filesystems' search constraint.</
para>
10139N/A<
varlistentry><
term><
option>-contains=<
replaceable>string</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Contains the text' search constraint and set the
10139N/Atext of that entry. Use a full filename or a partial filename with wildcards.
10139N/ASee <
citerefentry><
refentrytitle>find</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A</
citerefentry> for more details about using wildcards.</
para>
10139N/A<
varlistentry><
term><
option>-descending</
option></
term><
listitem><
para>Set
10139N/Asort order to descending. The default sort order is ascending.</
para>
10139N/A<
varlistentry><
term><
option>-empty</
option></
term><
listitem><
para>Select the
10139N/A'File is empty' search constraint.</
para>
10139N/A<
varlistentry><
term><
option>-follow</
option></
term><
listitem><
para>Select
10139N/Athe 'Follow symbolic links' search constraint.</
para>
10139N/A<
varlistentry><
term><
option>-group=<
replaceable>group</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Owned by group' search constraint and set the
10139N/A<
varlistentry><
term><
option>-hidden</
option></
term><
listitem><
para>Select the
10139N/A'Show hidden and backup files' search option.</
para>
10139N/A<
varlistentry><
term><
option>-mtimeless=<
replaceable>date</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Date modified before (days)' search constraint
10139N/Aand set the text of that entry.</
para>
10139N/A<
varlistentry><
term><
option>-mtimemore=<
replaceable>date</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Date modified after (days)' search constraint
10139N/Aand set the text of that entry.</
para>
10139N/A<
varlistentry><
term><
option>-named=<
replaceable>text</
replaceable></
option></
term>
10139N/A<
listitem><
para>Set the <
replaceable>text</
replaceable> of the 'Name contains' search option.</
para>
10139N/A<
varlistentry><
term><
option>-notnamed=<
replaceable>filename</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'File is not named' search constraint and set the
10139N/Atext of that entry. Use a full filename or a partial filename with wildcards.
10139N/ASee <
citerefentry><
refentrytitle>find</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A</
citerefentry> for more details about using wildcards.</
para>
10139N/A<
varlistentry><
term><
option>-nouser</
option></
term><
listitem><
para>Select
10139N/Athe 'Owner is unrecognized' search constraint.</
para>
10139N/A<
varlistentry><
term><
option>-path=<
replaceable>folder</
replaceable></
option></
term>
10139N/A<
listitem><
para>Set the text of the 'Look in folder' entry. Defaults to the
10139N/Acurrent working directory.</
para>
10139N/A<
varlistentry><
term><
option>-start</
option></
term><
listitem><
para>Automatically
10139N/A<
varlistentry><
term><
option>-regex=<
replaceable>pattern</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'File matches regular expression' search constraint
10139N/Aand set the text of that entry. See <
citerefentry><
refentrytitle>find</
refentrytitle>
10139N/A<
manvolnum>1</
manvolnum></
citerefentry> for more details about the regular
10139N/Aexpression patterns that can be used.</
para>
10139N/A<
varlistentry><
term><
option>-sizeless=<
replaceable>size</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Size is less than (kilobytes)' search constraint
10139N/Aand set the text of that entry.</
para>
10139N/A<
varlistentry><
term><
option>-sizemore=<
replaceable>size</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Size is more than (kilobytes)' search constraint
10139N/Aand set the text of that entry.</
para>
10139N/A<
varlistentry><
term><
option>-sortby=<
replaceable>order</
replaceable></
option></
term>
10139N/A<
listitem><
para>Sort files by one of the following: name, folder, size, type,
10139N/A<
varlistentry><
term><
option>-user=<
replaceable>user</
replaceable></
option></
term>
10139N/A<
listitem><
para>Select the 'Owned by user' search constraint and set the
10139N/A<
varlistentry><
term><
option role="nodash"><
replaceable>gnome-std-options</
replaceable></
option></
term>
10139N/A<
listitem><
para>Standard options available for use with most GNOME applications.
10139N/ASee <
citerefentry><
refentrytitle>gnome-std-options</
refentrytitle><
manvolnum>
10139N/A5</
manvolnum></
citerefentry> for more information.</
para>
10139N/A<
refsect1 id="gnome-search-tool-1-exam"><
title>&exam-tt;</
title>
10139N/A<
example role="example"><
title>Performing a basic search automatically</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; --name=
a.out --path=$HOME --autostart
10139N/A<
example role="example"><
title>Performing an advanced search automatically
10139N/A<
para><
screen>example% <
userinput>&cmd; --contains=
unistd.h --mtimeless=3 --sortby=size --autostart
10139N/A<
refsect1 id="gnome-search-tool-1-exit"><
title>&exit-tt;</
title>
10139N/A<
para>The following exit values are returned:</
para>
10139N/A<
variablelist termlength="xtranarrow"><
varlistentry><
term><
returnvalue>0</
returnvalue></
term>
10139N/A<
listitem><
para>Application exited successfully</
para>
10139N/A<
varlistentry><
term><
returnvalue>>0</
returnvalue></
term><
listitem><
para>Application
10139N/A<
refsect1 id="gnome-search-tool-1-file"><
title>&file-tt;</
title>
10139N/A<
para>The following files are used by this application:</
para>
10139N/A<
variablelist termlength="wide"><
varlistentry><
term><
filename>/
usr/
bin/&cmd;</
filename>
10139N/A</
term><
listitem><
para>Executable for Search for Files</
para>
10139N/A<
refsect1 id="gnome-search-tool-1-attr"><
title>&attr-tt;</
title>
10139N/A<
para>See <
olink targetdocent="REFMAN5" localinfo="attributes-5"><
citerefentry>
10139N/A<
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry></
olink>
10139N/Afor descriptions of the following attributes:</
para>
10139N/A<
tgroup cols="2" colsep="1" rowsep="1"><
colspec colname="COLSPEC0" colwidth="1*">
10139N/A<
colspec colname="COLSPEC1" colwidth="1*">
10139N/A<
row><
entry align="center" valign="middle">ATTRIBUTE TYPE</
entry><
entry align="center" 10139N/Avalign="middle">ATTRIBUTE VALUE</
entry></
row>
10139N/A<
row><
entry colname="COLSPEC0"><
para>Interface stability</
para></
entry><
entry 10139N/Acolname="COLSPEC1"><
para>Volatile</
para></
entry></
row>
10139N/A<
refsect1 id="gnome-search-tool-1-also"><
title>&also-tt;</
title>
10139N/A<!--Reference to another man page--> 10139N/A<!--Reference to a Help manual--> 10139N/A<
para><
citetitle>Search for Files Manual</
citetitle></
para>
10139N/A<
para>Latest version of the <
citetitle>GNOME Desktop User Guide</
citetitle> for your platform.</
para>
10139N/A<
para><
citerefentry><
refentrytitle>find</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A</
citerefentry>, <
citerefentry><
refentrytitle>gnome-std-options</
refentrytitle>
10139N/A<
manvolnum>5</
manvolnum></
citerefentry></
para>
10139N/A<
refsect1 id="gnome-search-tool-1-note"><
title>¬e-tt;</
title>
11933N/A<
para>Written by Glynn Foster, Sun Microsystems Inc., 2003, 2006.</
para>