README for pwutils

The pwutils project is a collection of reporting and query tools related to
pwdb files and similar user information. It is meant more as a teaching tool
for new sysadmins and programmers, however, by itself the package has several
useful utils.

ABOUT

These are a small collection of user tools I have written. So far these include:

	- pwuser:   Clone of the BSD userinfo command. Prints all but gecos.
    - pwuserep: Simple perl program that prints a nice user report. It
                includes a filter list of typical system users you might not
                want to see.
	- pwgrprep: Simple perl program that prints a nice group report.
    - pwgrps:   Clone of the GNU shell utils groups script.
    - pwdf:     Displays how much space either a user or all users is
                using in their home directory.
	- pwinfo:   Grok a variety of data regarding a single user name.
    - pwutil:   A full front end  to all of the above commands.

REQUIREMENTS

Perl 5.0.8 or up
GCC (just about any past 2.95 - this was test from 2-4)
Python-2.4 or up
A POSIX compliant shell (bash, ksh or sh-posix)

CONFIGURATION

Please note that two programs, pwuserep and pwdf have an @exceptions
array that can be tweaked to your liking. It is used to filter out
any accounts you do not want to see. There are two nonsensical alpha
strings in it already to use as examples.

INSTALLATION

One of the programs is written in C. Plus I (now) like to differentiate
a *source* script versus the executable. So simply do the following:

	cd ~/user
	./configure
	make
	make install

Other targets are:

 uninstall - removes the scripts and programs.
 clean     - removes executable versions in the source directory.

TODO - see TODO file
AUTHORS - see AUTHORS file
LICENSE - see LICENSE file

