Userneu is a simple perl script to automate the creation of new user
accounts. It parses a tab-separated list of account names, real names
and school classes (I wrote it to faciliate creating user accounts on my
school's server). As of version 1.34b this list can have an arbitrary
number of fields as long as the username is in the first one. If you
want to have more or less than three fields in the input file you also
have to specify descriptors for these fields using the -D option (see
below.)
This package contains two different scripts, userneu.pl to create a
whole batch of users and userquick.pl to create single users.

It requires some perl modules in order to work, which are listed in
REQUIREMENTS and shipped with the package.

To get an idea of the scripts usage please refer to the script's manual
page in the doc/ directory.

If one of the usernames on the list is already in the passwd database
the script can append random strings (1 or two characters) to the
username until it finds one that doesn't exist yet. This is not the
default behaviour and you have to enable it explicitly.

This script has been tested on FreeBSD with perl 5.8.0 and perl 5.00503
(which comes with FreeBSD by default). It should work with other perl
versions as well.

NetBSD support has been removed from 1.34 onwards as I found useradd(8)
on NetBSD not to accept the password hashes created by the script when I
tested it on a friend's NetBSD machine. As I currently do not have any
spare NetBSD systems I could develop and test on I disabled it for now.
If you need NetBSD support write it, send me a patch and I'll be happy
to include it but personally I won't work on it until I find the time to
install NetBSD on one of my test machines.

Contributions are always welcome, just send them. If you have any
questions regarding the script please be sure to have at least a basic
understanding of how it works (Having read this README and the manual
pages should be sufficient, but if you miss something in that
documentation feel free to tell me so I can add it.)

As of 1.38 I included smbrepair.pl, a script that parses the list of
usernames and passwords output by userneu(8) and creates missing entries
in smbpasswd(5). It can be useful if you forgot the -s switch when you
ran userneu(8) or if you suffer from the samba account creation bug
fixed in 1.38 (see CHANGES for details). smbrepair.pl is just a quick
hack I wrote to clean up the mess the bug in userneu-1.36 left on the
system I administrate, but it should work fine. If in doubt you might
want to have a look at the source code before running it.

Contact information:

Johannes Grassler <johannes.grassler@freenet.de>

My GPG key fingerprint:

pub  1024D/1FCB4CF3 2002-07-03 Johannes Grassler <johannes.grassler@freenet.de>
     Key fingerprint = 5CAF DF5C A5E8 69EA B7C9  2FD9 ADD9 6BF3 1FCB 4CF3

Copyright (c) 2003 Johannes Grassler. All rights reserved. This program
is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License (GPL).
