NAME

prov_user - a command line interface for provisioning users and groups

SYNOPSIS

prov_user --action=[]

Action is one of the following:

create   - creates a new system user
modify   - make changes to an existing user
destroy  - remove a user from the system
suspend  - disable an account
restore  - restore an account

Other parameters are optional. Unless you specify --noprompt, you will be prompted for fill in any missing values.

--username
--comment   - gecos description
--domain    - a domain name, if associated with the account
--expire    - account expiration date
--gid       - group id
--homedir   - the full path to the users home directory
--password
--quota     - disk quota (in MB)
--shell
--uid       - user id
--verbose   - enable debugging options

USAGE

prov_user --action create  --user=matt --pass='neat0app!'
prov_user --action destroy --user=matt
prov_user --action modify  --user=matt --quota=500

DESCRIPTION

prov_user is a command line interface to the Provision::User provisioning modules.

CONFIGURATION AND ENVIRONMENT

Default settings are found in provision.conf, which should be located in your systems local etc directory (/etc, /usr/local/etc, or /opt/local/etc).

DEPENDENCIES

A list of all the other modules that this module relies upon, including any restrictions on versions, and an indication whether these required modules are part of the standard Perl distribution, part of the module's distribution, or must be installed separately.

AUTHOR

Matt Simerson, <matt at tnpi.net>

LICENCE AND COPYRIGHT

Copyright (c) 2008 The Network People, Inc. (info@tnpi.net)

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.