README
------

Createusers adds and removes Linux user accounts in bulk. Each new user 
may be given one or all of the following: 

- Login account and home directory
- Personal web space on a local Apache web server
- Personal MySQL database on a local or remote MySQL server
- Personal PostgreSQL database on a local or remote PostgreSQL server
- Samba file sharing account on a local Samba server
- Disk quota via the Linux quota system.

Users may be deleted in bulk. The login, MySQL, PostgreSQL and Samba 
password of any user can be updated with a single command.

Follow the instructions in the INSTALL file to install and set up
createusers. When installed and configured, the following commands will
be available to the root user:

Action                       Command             Command for man page
------                       -------             --------------------
Create users in bulk         createusers         man createusers
Remove users in bulk         removeusers         man removeusers
Change a user's password     updateuserpasswd    man updateuserpasswd
Generate input passwords     passgen             man passgen

Tested platforms
----------------

- Red Hat Linux 6.0, 6.2, 7.0, 7.2
- Suse Linux 6.2
- Turbo Linux 6.0

Createusers is known to work with Bash 1.14.7, MySQL 3.23.32, 
PostgreSQL 7.0.3, Samba 2.0.5a and Apache 1.3.12. 

Reporting bugs
---------------

Please send bug reports to Phil at the Linux for Schools Project.
Email: philjones1@blueyonder.co.uk

Thanks
------

Special thanks to Nigel Pauli at St John's School, UK. 
http://www.st-johns.org.uk/
