ZIPFIND Ver. 1.0
Copyright (c) 1991
ZIPFIND searches ZIP or ARC files for text strings. ZIPFIND displays
each line of each archived file that contains the desired string, and
provides the following benefits:
o Any type of file stored in an ARC or ZIP file can be searched
for any text string.
o You can use your own text search program to provide more
powerful search options. Many programs (e.g. GREP variants)
provide pattern searches and special output options not
To search an ARC or ZIP file for a string:
zipfind [options] "searchstring" filespec
is zero or more MS-DOS FIND command options. In version 5.0 of
MS-DOS the options are:
/v Display lines that do NOT contain the search string.
/c Display the number of lines that contain the search
string, but not the lines themselves.
/n Display the line number beside each line.
/i Ignore the case of characters when comparing.
See the MS-DOS User's Reference for more information on these
options. If you use your own text search program, use its
options instead of these.
is the string to look for. Quotes must surround the string if
it contains blanks or other white space characters, or the
characters ">", "<", or "|".
lists the names of one or more ARC or ZIP files to search. Use
wildcard characters ("?" and "*") to specify groups of files.
If you specify a file name without an extension, ZIPFIND
searches both ARC and ZIP files. If you specify a directory,
ZIPFIND searches all ARC and ZIP files in the directory.
ZIPFIND normally displays its results on the screen, but you can use
MS-DOS output redirection (via ">", ">>", or "|" on the command line) to
direct the search listing to a file or another program.
The following examples illustrate the use of ZIPFIND:
Search ZIP file letters.zip for the string "Pam":
ZIPFIND Pam letters.zip
Search ARC files letters.arc and back.arc and ZIP files letters.zip
and back.zip for the string "IBM". Use the /i option so that case
is ignored when comparing and the /c option so that only the number
of matching lines is shown:
ZIPFIND /i /c "IBM" letters back
Search all ARC files and all ZIP files in the current directory for
the string "Mike Albert". Direct the results to file find.txt
instead of the screen. Use the /i option so that case is ignored
ZIPFIND /i "Mike Albert" . >find.txt
3 ADVANCED USE
ZIPFIND can use a text search program you provide instead of the MS-DOS
FIND command. When ZIPFIND uses your program, you must specify options
recognized by your program, not MS-DOS FIND. Also, if your program
expects the search string before the options on the command line, then
enter the arguments in that order.
To use your own program, name it grep.com or grep.exe and place it in a
library on your search path. ZIPFIND will use your program instead of
See the next section for search program requirements.
4 ZIPFIND REQUIREMENTS
ZIPFIND can be used on any IBM-compatible computer running under MS-DOS
versions 2.0 and later.
ZIPFIND uses pkxarc to process ARC files and pkunzip to process ZIP
files, so these programs must be available as needed in libraries on
your search path. Both programs are produced by PKWARE Inc. and are
available on CompuServe and other BBS's.
ZIPFIND places temporary files in a work directory, and requires enough
free space to store the largest archived file to be searched. ZIPFIND
uses the TEMP or TMP environment variable to locate this directory. If
neither variable is defined, ZIPFIND uses the current directory. Unless
there's an error, ZIPFIND deletes the directory and all temporary files
when it finishes. If an error occurs ZIPFIND does not delete the files,
so you can examine them to analyze the problem. The name of the work
directory is [email protected]
ZIPFIND is designed to work with many different text search programs,
but it does impose some requirements, i.e.:
The program must support output redirection (i.e. the ">" command
line option). Programs that output only to the screen can't be
The program must accept arguments in the order:
"searchstring" [options] filespec
[options] "searchstring" filespec
Note that in both cases the filespec is last.
Options must start with either "-" or "/", e.g. the "i" option must
be specified as either "/i" or "-i".
When the program lists the name of a file, it must show the path
name as it was passed to it on the command line. In particular,
when a full path name in upper case letters without wild cards is
specified, the listing must identify the file in exactly the same
ZIPFIND has been successfully tested with the following text search
GGREP by Sam Baxter (available on CompuServe in forum IBMSYS,
Library 3, file ggrep.arc).
FGREP by Christopher Dunford (available on CompuServe in forum
IBMAPP, Library 2, file fgrep.arc).
GREP by DECUS, Kern, Smith, and Brigs (available on CompuServe in
forum IBMAPP, Library 2, file grep.arc).
GREP by Borland International Inc. (packaged with Borland language
ZIPFIND does not work with the following program:
Text Search by Peter Norton (output redirection is not supported and
the file name is the first argument).
5 ZIPFIND MESSAGES
ZIPFIND Error: is not an ARC or ZIP file.
ZIPFIND only processes ARC and ZIP files. You specified file
that has an extension other than .arc or .zip.
ZIPFIND Error: Couldn't create directory .
ZIPFIND tried to create directory and was unsuccessful.
Check if is a legal place to create a directory. If not,
look at the TEMP or TMP environment variables which ZIPFIND used
to determine and change which ever one is present to
indicate a legal directory. If this fails, contact ZIPFIND
ZIPFIND Error: Couldn't redirect standard output.
ZIPFIND tried to redirect the standard output from an archive or
find program to a file and was unsuccessful. This problem
should not occur under normal operation. Contact ZIPFIND
ZIPFIND Error: Couldn't find archive program .
ZIPFIND couldn't find program which is needed to unarchive a
file. Make sure that you have program on your system, and
that its library is on your search path. You can view your
search path by typing "path" at the MS-DOS prompt; the directory
that contains should be listed. If it isn't, edit your
autoexec.bat file to add the needed library to the path
statement and reboot your system. If this fails, contact
ZIPFIND Error: Couldn't find find.com, find.exe, grep.com, or
ZIPFIND couldn't locate a text search program. If you want to
use your own text search program, make sure that it's named
grep.com or grep.exe and that its library is in your search
path. If you want to use the MS-DOS FIND command, make sure
that the MS-DOS directory (usually named MSDOS or DOS) is on
your search path, and that find.com or find.exe hasn't been
deleted from that directory. If this fails, contact ZIPFIND
ZIPFIND Error: Couldn't interpret archive program listing.
ZIPFIND couldn't interpret the listing produced when it ran the
archive program to list the archive contents. This could occur
if you have a new version of the archive program that ZIPFIND
doesn't support, or if the files pkxarc.exe or pkunzip.exe
aren't the real archive programs. Since an error occurred
ZIPFIND did not delete the listing file, so you can examine it
(in the ZIPFIND work directory [email protected]@$.DIR) to see what is
wrong. If this fails, contact ZIPFIND support for assistance.
ZIPFIND Error: Couldn't open archive program listing file .
ZIPFIND Error: Couldn't open find program listing file .
ZIPFIND tried to open file which it previously created and
was unsuccessful. This problem should not occur under normal
operation. Contact ZIPFIND support for assistance.
ZIPFIND Error: Insufficient disk space at . File only
ZIPFIND tried to create a file in directory and couldn't
because of insufficient space. ZIPFIND was only able to search
part of file , so it might have missed a matching string. If
there's more space on a different drive, change the TEMP or TMP
environment variable to indicate that drive. If this fails,
contact ZIPFIND support.
ZIPFIND Error: Insufficient memory.
ZIPFIND Error: Spawn to "" failed; insufficient memory.
ZIPFIND needs more memory to run. Since ZIPFIND requires
relatively little memory, you probably have run into this
problem with other programs and know what to do. If you don't
know what to do, contact ZIPFIND support.
ZIPFIND Error: Internal error - insufficient buffer size.
ZIPFIND ran out of internal buffer space. This error should not
occur in normal operation. Contact ZIPFIND support.
ZIPFIND Error: Spawn to "" failed; errno=.
ZIPFIND tried to spawn program and failed. The spawn
returned an error code of . If you're familiar with MS-DOS
error codes, you can look up the code to determine what went
wrong. Otherwise, contact ZIPFIND support.
ZIPFIND Error: User aborted program.
You used Ctrl-C or Ctrl-Break to abort ZIPFIND before it
ZIPFIND Error: You must identify at least one file to search.
When you invoked ZIPFIND you didn't specify the files to search
on the command line. You must specify the search string
followed by at least one file or directory specification.
ZIPFIND Error: "" returned error code .
ZIPFIND spawned archive program to access an archive, but it
indicated a problem by returning error code . If ZIPFIND
recognizes the error code, it displays a description of the
error in the message. If not, look up the error code in the
documentation provided with your archive program to determine
the problem. Since an error occurred ZIPFIND did not delete the
archive program listing file, so you can examine it (in the
ZIPFIND work directory [email protected]@$.DIR) to see what is wrong. You
can also rerun the command manually and examine the results. If
this fails, contact ZIPFIND support.
6 LICENSING, WARRANTY, REGISTRATION, and SUPPORT
ZIPFIND is distributed as shareware. I encourage you to try ZIPFIND and
share it with friends as long as:
The ZIPFIND program and this documentation file are not modified and
are distributed together.
ZIPFIND is not provided as a part of any other product.
No fees, beyond a reasonable fee for media, duplication, or
downloading costs, are charged.
ZIPFIND is not used for commercial, government, or business purposes
without registration. Each registration is for a single person or a
If you find ZIPFIND useful and decide to use it regularly, you are
required to register. All registration payments will be donated to
Oxfam America, an international development and disaster relief agency.
It's a worthy charity that I've been supporting for many years. For
more information on Oxfam see section 6.
When you register you get the satisfaction of saving lives in Africa,
Asia, and South America, and encourage me to produce more software at
reasonable prices. You also get the following benefits:
I'll notify you of new ZIPFIND versions when they become available.
I'll send an updated version of ZIPFIND (and my other shareware
products) to you at no additional cost. You can request this at any
time. I'll do this once per registered user.
I'll answer any questions you have on ZIPFIND and its use. You can
contact me at the address shown below or via CompuServe mail.
If any important bugs are found I will notify you.
I'll make an attempt (but can't guarantee) to fix any problems you
Registration is $25. Please make your check payable to Oxfam America -
I'll send your checks to Oxfam and record your registration information.
I'll also accept original canceled checks or receipts from Oxfam that
list you as the donor. Please send payments, registration information,
and any other correspondence to:
P. O. Box 2100
Chelmsford, MA 01824
I can also be reached via CompuServe mail; my userid is [70325,1134].
Anyone can order the latest version of ZIPFIND directly from me for a
fee of $5.00. Just send the order (make sure it contains your mailing
address) with your check to the above address. You'll receive a 5 1/4
inch 360Kb floppy disk containing the executable and documentation
files. If you need other formats (5 1/4 inch 1.2Mb or 3 1/2 inch
1.44Mb) I can provide them. I'll also include other shareware products
I produce. If you live outside North America, please send extra money
for the increased postage.
I welcome all comments and suggestions concerning ZIPFIND. I'd like to
know how you are using ZIPFIND, where you obtained it, and what
problems, bugs, or weaknesses you find. If you tell me about
enhancements or changes you're interested in, I'll make an effort to
This program is provided "as is" without warranty of any kind, either
express or implied, but not limited to the implied warranties of
merchantability or fitness for a particular purpose. The entire risk as
to the results and performance of the program is assumed by the user.
Should the program prove defective, the user assumes the entire cost of
all necessary servicing, repair, or correction.
7 OXFAM AMERICA
As stated in Oxfam literature,
"Oxfam America is an international agency that funds self-help
development projects and disaster relief in poor countries in
Africa, Asia, and Latin America, and also prepares and distributes
educational materials for people in the United States on the issues
of development and hunger. The name "Oxfam" comes from the Oxford
Committee for Famine Relief, founded in England in 1942. Oxfam
America, based in Boston, was formed in 1970, and is one of seven
autonomous Oxfams around the world (Great Britain, Australia,
Belgium, Canada, Quebec, Hong Kong and the United States). Oxfam is
a nonsectarian, nonprofit agency that neither seeks or accepts U.S.
government funds. All contributions are tax-deductible to the
extent permitted by law."
For more information, you can phone Oxfam at 617-482-1211, or write to
Boston, MA 02116
8 ZIPFIND REVISION HISTORY
ZIPFIND version 1.0 - 12/5/91
Initial release of ZIPFIND program.