Short    : Pure CLI command to search files
Uploader : dck@hol.gr (D. Keletsekis)
Author   : dck@hol.gr (D. Keletsekis)
Type     : util/cli
Version  : 1.1
Requires : WB 2.0+


FSearch is a pure CLI command for Listing & Searching files.

Searching of files is fast and the template provided allows 
you to accurately describe the types of files you are looking 
for, thereby drastically reducing the scope of the search.

Fsearch has the following template :

ROOT/A/M        Where to start searching from.
                May be multiple root sources - with wild-cards
                ex : FSearch ram: dh0:mydir#? all
                List all files in all dirs in ram: and all
                files in all dirs matching dh0:mydir#?

                This option must be given. 
                All others are optional.		

PAT/K           (string) File pattern to match
                Only files meeting this pattern will be searched
                ex : FSearch ram: pat=#?.info all
                List all info files in ram: or it's sub-dirs

TXT/K           (string) Text to search for.
                If this option is not specified FSearch will act
                like "list" and will not search the files.
                ex : FSearch ram: txt="my name" all
                Note: By default the search is case-insensitive.

FROM/K          (date) Only search files FROM this date and up.
                Dates must be written as dd-mm-yy.
                ex : FSearch ram: from=07-08-96

TO/K            (date) Only search files UP to this date

MIN/N/K         (number) Only search files more than MIN Kb.
                ex : FSearch ram: min=100 (look for files >= 100k)

MAX/N/K         (number) Only search files less than MAX Kb.

HEADER/K        (string) Only search files which have this header.
                The Header specification may contain wild cards.
                The first 100 bytes of the file will be loaded
                and checked against this Header.
                ex : FSearch ram: header=FORM????ILBM#? all
                will list all iff pictures in ram:

ALL/S           Recursively scan sub-directories

CS=CASESENSITIVE/S      
                Make the search case-sensitive

V=VERBOSE/S     Print Line number & text of lines found.
                The default is to just print the file name on the
                first occurance of the TXT you're looking for.
                With this option all the matches and their 
                context will be displayed. If the line length is 
                over 80 chars it will be clipped.

NOBIN/S         Do not check binary files. Up to 100 bytes of the
                file will be loaded and file will be skipped if
                this header contains any non-ascii characters.

HL=HIGHLIGHT/S  Highlight the search results

INFO/S          Print file size/date/time next to it's name
                No file paths are printed if this option is on.

NOPATH/S        Print only the file name - not the full path.


A great looking, resizable, multitasking GUI is also 
provided (preview included). The gui is independent of the 
command itself, so you can use it (or not) as needed.
To run the GUI you need the Gui4Cli program which you can 
download from Aminet at dev/gui/Gui4Cli.lha

This program is FreeWare, but remains the Copyright of D.Keletsekis.
No guarantees as to its performance or actions is made or implied.
Use it at your own risk. 

D. Keletsekis
November 1997