UserMod script for Samba Server for eCS (OS/2) Version 2.2.1
============================================================

Copyright (C) netlabs.org 2007-2009

usermod.cmd is the new universal user manipulation script for the Samba
Server for eCS(OS/2). It integrates the functionality found in its 
predecessors useradd.cmd, userdel.cmd and userren.cmd in one universal
script.

The enclosed useradd.cmd, userdel.cmd and userren.cmd are just forwarder
scripts and just call usermod.cmd with appropriate parameters in order
to use the new usermod.cmd in situations were it is impossible to update
smb.conf.

UserMod has 5 modes of operation:

Add a new kLIBC user:  usermod -a "username" 
Add a machine account: usermod -a "machinename$" 
Remove a kLIBC user:   usermod -x "username"
Rename a kLIBC user:   usermod -r "oldusername" "newusername"
Display help:          usermod /? 
Display help:          usermod -? 
Display help:          usermod -H

Running usermod without a paramter just rewrites the kLIBC password database.

Unlike its predecessors, usermod.cmd not only adds/removes/renames users in
master.passwd, but also takes care of the group file. In addition usermod.cmd
acts more intelligently, when dealing with GID allocation, as it knows suitable 
GIDs for the well-known group IDs (root: 512, users: 513, machines: 515).

usermod.cmd inherited a lot of code from smbusers.exe, which should make it
more robust and less picky.

Author: Herwig Bauernfeind, (c) 2009
Mailto: herwig.bauernfeind@aon.at