fowner v1.1
===========================================================================
Copyright (c) 1997-1999 Magnus Bck
http://www.jpl.nu/~magnus/fowner.html
baeck@swipnet.se
===========================================================================

1. Purpose
2. Syntax
3. Downloading
4. Revision history
5. Notes on distribution

===========================================================================
1. Purpose
===========================================================================

Dumps the files and directories being owned by one or many users/groups to
stdout. Subdirectories can be recursed into and the 8+3 filename aliases
can be shown instead of the long filenames to ensure compatibility with old
DOS applications.

===========================================================================
2. Syntax
===========================================================================

FOWNER.EXE [/SHORT] [/S] [/V] /O:[~]<user> ... [<files>] ... [-]

Displays the files and directories in <files> being owned by <user>. A
tilde in front of the user/group displays all files not owned by that
user/group. Note that multiple /O specifictions may be given. If <files> is
not given, the default is *.*. To give user/group names and file specific-
ations that contain spaces, quote the entire parameter (see example
below). If the file specification "-" is given, filenames will be read from
stdin (in addition to any other file specification that may be given).

/S recurses into all subdirectories.

/SHORT displays the 8+3 filename aliases instead.

/V prints a brief reports over how many files that were scanned and how
many of them that matched the criteria.

1.1 Example of use
------------------

fowner /s "/o:~Power Users" %systemroot%\system32

Prints all files not belonging to the Power Users group in the
%systemroot%\system32 directory, including sub-directories.

1.2 Return codes
----------------

Three different error codes are returned and can be examined by the
ERRORLEVEL variable:

0  No error.
1  No users/groups were given on the command line.
2  The system is not running Windows NT, which is required for use.
                 Table 1: Error codes (ERRORLEVEL)

===========================================================================
3. Downloading
===========================================================================

   * fowner-1.1.zip (45 kB) from JPL Data, Sweden.
     http://www.jpl.nu/~magnus/files/fowner-1.1.zip

Previous releases
-----------------

   * fownr100.zip (Version 1.0, Dec 8 1997, 34 kB)
     http://www.jpl.nu/~magnus/files/fownr100.zip

===========================================================================
4. Revision history
===========================================================================

1.1, March 16 1999
------------------

   * Filenames can now be read from stdin instead of being specified on the
     command-line.
   * The documentation previously incorrectly stated that it was impossible
     to have file specifications and users containing spaces. Corrected.
   * Minor memory leak fixed.

1.0, Dec 8 1997
---------------

Initial release.

===========================================================================
5. Notes on distribution
===========================================================================

fowner is freeware and may be freely distributed on any electronic media as
long as nothing is charged for it, except for nominal copying costs. If you
upload it to an FTP och WWW site or some other service, such as BBSs (which
I do encourage), I would appreciate if you'd notify me. The source code may
also be modified but the original copyright must still remain (but can of
course be accompanied by your own if you do modify the source code).

[ End of readme.txt ]