FindCompressed

Exodus Development, Inc.

Author: Michael Curry

Date: 2003.11.01 
Document Version: 1.0
Program Release Version: 1.0.1.2
Copyright (C) 2003 by Exodus Development, Inc.  All Rights Reserved.  

This software is available only in accordance with the terms of this license agreement contained in License.html that was included in the original distribution.

The current license agreement may be read online at http://www.exodus-dev.com/products/findcompressed/releases/current/License.html if License.html  was not included in the distribution or cannot be located.

Overview

FindCompressed will search a directory tree for compressed (or uncompressed) files and report found items to a console window.  The output is suitable for use by shell scripts or other utilities that can process standard output.  The exit status returned to the operating system is the number of matching items found.

The Win2k/XP built-in utility, compact.exe, can report this information as well, but the output format is difficult to parse, as it generates loosely structured multiline output.

Sample Output

Given the following directory structure,

+TestFiles
|   Compressed.doc
|   uncompressed.txt
|   
+---Folder1
|       file1.txt
|       
\---Folder2

in which the files Compressed.doc and file1.txt, and the directory Folder1 are compressed using the NTFS compression attribute, FindCompressed will produce the following output:

Search for compressed files in all subdirectories (the default action)

C:>FindCompressed TestFiles
Recursive search of TestFiles for compressed files.
TestFiles\Compressed.doc
TestFiles\Folder1\file1.txt
Found 2 compressed files in 3 items examined.

Search for uncompressed files in all subdirectories (using the -su option)

C:>FindCompressed TestFiles -su
Recursive search of TestFiles for uncompressed files.
TestFiles\uncompressed.txt
Found 1 uncompressed files in 3 items examined.

Requirements

Windows NT4, 2000 or XP with at least one NTFS filesystem available.

Installation

Extract the files into the directory of your choice.  Then open a command prompt, and run FindCompressed.exe.  We suggest that you place FindCompressed somewhere within the existing search path, or modifying your search path to include the directory in which FindCompressed resides.

If you do not already have a Zip file extraction utility, you can download a free evaluation version at http://www.winzip.com.

Usage

FindCompressed Version 1.0.1.1 By Exodus Development, Inc.

FindCompressed [-u] [path] [-su] [-nr] [-nh] [[-ns] | [-so]] [-fp]
  Where:
     u          Prints usage information, then exits.
     path       is the starting path (defaults to current working directory.)
     nr         Nonrecursive search. (Default: OFF)
     su         Specifies a search for uncompressed files. (Default: OFF)
     nh         Disables header output. (Default: OFF)
     ns         Disables summary output. (Default: OFF)
     so         Show summary report only. (Default: OFF)
     fp         Convert path to fully qualified path. (Default: OFF)

Copyright (C) 2003 Exodus Development, Inc. http://www.exodus-dev.com

Upon completion, FindCompressed exits with an exit code (errorlevel for the DOS/CMD batch enthusiasts of the world) that contains the number of found items.  In other words, if you care to know how many matching items were found, a batch script can examine errorlevel, and a unix-like shell can examine the $? pseudovariable.   

The -ns and -so options are mutually exclusive, and specifying both on the command line will result in FindCompressed issuing an error message and exiting with an exit value of -1. 

Known Issues

FindCompressed does not report the compression state of directories that it encounters.  This will be addressed in a future maintenance release.  Check the FindCompressed website or user forum for announcements.

Jump to revision history.

Note

We appreciate any feedback that you may have for us, please use Exodus Development's web-based contact form or send email to support (at) exodus-dev (dot) com. (Please substitute @ for (at) and . for (dot)).

Release History

Date Version Description
2003.11.01 1.0.1.2 Fixed formatting problem in output
2003.11.01 1.0.1.1 Initial release