Category : File Managers
Archive   : TOOLS.ZIP
Filename : READ.ME

The following files are included in the TOOLS.ZIP file:

READ.ME - The file you are reading.

GO.EXE - GO searches for the specified file and will change to the drive
and/or directory where the file is found. Wildcards are allowed
and the user is given the option of GOing to a file, continuing
the search, or aborting the search. For example:

go [drive:[\path\]]foo.exe

GO without any parameters gives help. If a beginning path is not
specified GO will begin in the root directory of the current (or
specified) drive and search recursively.


HEXDUMP.EXE - Hexdump does just that - it dumps a file to the screen in
debug format. For example:

hexdump file=hexdump.exe

will create the following:

-----------------------------------------------------------------

Hex listing of HEXDUMP.EXE at 15:16:14 on FEB 01, 1991
Starting at beginning of file and printing entire file.

0 4D 5A 14 01 24 00 04 01-43 00 1D 01 FF FF 4B 04 MZ $ C K
16 00 10 00 00 8E 06 00 00-20 00 00 00 00 00 00 00
32 16 00 00 00 C7 00 00 00-0C 01 00 00 B3 01 00 00


-------------------------------------------------------------------
HEXDUMP without any parameters will give help. ESC or CTRL-A will
abort HEXDUMP. HEXDUMP has the following parameters:

FILE - Specifies the file to be dumped. This is a required parameter.
START - Specifies the starting byte position within FILE to start
dumping. Defaults to beginning of file.
BYTES - Specifies the number of bytes to dump. If specified, it must
be an integer <= 65535, otherwise it defaults to the entire
file, regardless of the size of the file.

hexdump file= [start= [bytes=]]

XDIR.EXE - XDIR is YADP (Yet Another Directory Program). It does all the
things that a directory program should do:

- descend into subdirectories
- sort by date & time, size, name
- print total space occupied by listed files (shame on you DIR!)
- show file attributes
- lists hidden/system files
- selectively list files with specific attributes

FOR example:

xdir -w -d [drive:[\path\]]*.dat

xdir -? gives help. ESC or CTRL-A aborts XDIR. XDIR has the follow-
ing parameters:

-? : Help
-w : Wide directory listing
-d : Descend into subdirectories
-p : Pause after each screen
-1 : Sort by name
-2 : Sort by date
-3 : Sort by size

The following flags determine which file attributes will be used
as search criteria. If any of the following flags are used, only
files with the specified attributes will be displayed. If you
specify more than one attribute the list will be ORed so that any
file with any of the specified attributes will be displayed.

-s : System files
-r : Read only files
-h : Hidden files
-a : Archive (modified since last backup)
-i : Directories

Defaults: No help, not wide, no descend, no pause, no sort; list
ALL files in the current directory.

xdir [-parm [-parm]] [drive:[\path\[file]]]

The narrow output from XDIR looks like:

-----------------------------------------------------------

xdir *.exe

xDIR V1.5 (xdir -? for help)
Volume in drive C is DRIVE_C

Directory of C:\BIN\TOOLS\*.EXE

GO EXE 17395 1-Feb-1991 2:58p ----a
XDIR EXE 26020 31-Jan-1991 2:41p ----a
XCOM EXE 22307 1-Feb-1991 2:43p ----a
FLIST EXE 17588 31-Jan-1991 2:19p ----a
JD EXE 86644 31-Jan-1991 2:49p ----a
JDMAINT EXE 125284 31-Jan-1991 2:54p ----a
FREE EXE 6964 31-Jan-1991 2:42p ----a
HEXDUMP EXE 18196 1-Feb-1991 3:12p ----a

8 files, 0 directories, 320398 bytes, 1660928 bytes free of 39897088 total.
The date is 01 FEB 1991. The time is 3:56 pm.

-----------------------------------------------------------

The wide output from XDIR looks like:

-----------------------------------------------------------

xdir -w *.exe

xDIR V1.5 (xdir -? for help)
Volume in drive C is DRIVE_C

Directory of C:\BIN\TOOLS\*.EXE

GO EXE 17k XDIR EXE 26k XCOM EXE 22k FLIST EXE 18k
JD EXE 85k JDMAINT EXE 123k FREE EXE 7k HEXDUMP EXE 18k

8 files, 0 directories, 320398 bytes, 1632256 bytes free of 39897088 total.
The date is 01 FEB 1991. The time is 4:47 pm.

-----------------------------------------------------------

XCOM.EXE - XCOM finds and performs COMMAND[S] on . It will
recursively search for files (wildcards are allowed) and when
it finds a match it will perform the specified command[s] on
the file. Multiple commands may be performed on the file, and
special characters allow substitution of the file name only
or the file name and path into the command[s]. For example:

xcom file=[drive:[\path\]]*.exe do="copy ~ e:^|del ~" ask=yes descend

XCOM without any parameters gives help. ESC or CTRL-A will abort
XCOM. If a beginning path is not specified XCOM will begin in the
current directory of the current (or specified) drive. XCOM will
search recursively if the DESCEND parameter is specified. XCOM has
the following parameters:

FILE - Specifies the file(s) to search for.

DO - One or more commands to perform when FILE is located. The
command do not have to be related to FILE (although I'm not
sure why else you would use this program). If the ~ (tilde)
character is found in a command the fully qualified pathname
will be inserted in the command at the location where the
tilde was located. If the ^ (caret) is found in a command the
filename only will be inserted in the command at the location
where the caret was located. For example, if the filename is
C:\LANG\TP\XL.PAS, the command

DO="del ~"

would be executed as

del C:\LANG\TP\XL.PAS

whereas

DO="del ^"

would be executed as

del XL.PAS

Multiple commands (up to a maximum of twenty) can be separated
by the | character. For example:

DO="copy ~ e:|del ~"

ASK - ASK or ASK=Y (default) will cause XCOM to pause before the
command(s) is executed. ASK=N will preclude vetoing the
command. Be careful!

DESCEND - If descend is specified XCOM will look into subdirectories
of the current (or specified) directory. The default is no
descend.



FLIST.EXE - FLIST is YAWP (Yet Another Whereis Program). It will recursively
search for. For example:

flist [drive:[\path\]]*.foo

Flist without any parameters gives help. If a beginning path is not
specified FLIST will begin in the root directory of the current (or
specified) drive and search recursively. Output from FLIST is
formatted as follows:

-----------------------------------------------------------------

flist flist.*

16659 10-Sep-1990 2:04p C:\BIN\FLIST.EXE
17588 31-Jan-1991 2:19p C:\BIN\TOOLS\FLIST.EXE
17528 31-Jan-1991 2:18p C:\BIN\TOOLS\SOURCE\FLIST.MOD
324 31-Jan-1991 1:40p C:\BIN\TOOLS\SOURCE\FLIST.MAK
6755 31-Jan-1991 2:19p C:\BIN\TOOLS\SOURCE\FLIST.OBJ
17588 31-Jan-1991 2:19p C:\BIN\TOOLS\SOURCE\FLIST.EXE
No more.

-----------------------------------------------------------------

JD.EXE - JD is short for JumpDir. The premise is simple: you maintain
a database with the complete drive:\path specification for
directories along with a short name for the directory. Then,
rather than going through the following:

d:
cd \pra\program\demon\source

you would type:

jd demon (or whatever name you have associated with that directory).

JD takes care of changing to the correct drive and directory. JD
without any parameters will list all current definitions. JD uses
the following files:
JD.DAT - data file
JD.IDX - index file
JD.DFL - schema file

JDMAINT.EXE - JDMAINT is the companion program that allows you to maintain
the JD data file. JDMAINT is executed without any parameters. All
of the JD*.* files should be located in the same directory, and that
directory should be in your PATH variable.

FREE.EXE - FREE shows the amount of available disk space on each drive. If
no drive is specified the current drive is used. For example:

free a c d - or -
free acd

will show available space on drives a, c and d. Free ? will give
help. Output from free looks like:

-----------------------------------------------------------------

free c

Bytes available on drive C ¯ 1,626,112

-----------------------------------------------------------------


All of the programs are written in Modula-2 and compiled with the
Stony Brook Compiler V2.2 and linked with Stony Brook Linker M2LINK V2.2.
These programs are released into the Public Domain without any restrictions
on their use or distribution.

Rick Owen
EG&G Idaho, Inc.
P.O. Box 1625
Idaho Falls, ID 83415-1609
(208) 526-6912