NAME

prov_user.pl - a command line interface for provisioning system accounts

SYNOPSIS

prov_user.pl <action>

Where 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

Additionally, --username is required but if you fail to pass it, you'll be prompted.

--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

When there are required options that are not set on the command line, you will be prompted for them.

USAGE

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

DESCRIPTION

prov_user.pl 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). All rights reserved.

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.