Net::LDAP::posixAccount - Creates new Net::LDAP::Entry objects for a posixAccount entry.

Version 0.0.2

Quick summary of what the module does.

Perhaps a little code snippet.

    use Net::LDAP::posixAccount;

    #Initiates the module with a base DN of 'ou=users,dc=foo'.
    my $foo = Net::LDAP::posixAccount->new({baseDN=>'ou=user,dc=foo'});

    #creates a new entry with the minimum requirements
    my $entry = $foo->create({name=>'vvelox', gid=>'404', uid=>'404'});

    #add it using $ldap, a previously created Net::LDAP object
    $entry->update($ldap);

This initiates the module. It accepts one arguement, a hash. Please See below for accepted values.

This is a required value and is the base that the entry will be created under.

This is a perl boolean value. If this is set to true, the objectClass top is not present.

Creates a new Net::LDAP::Entry object.

The name of the user.

What the common name should be for a user. This defaults to the username if it is not defined.

This is the UID number of a user. If set to 'AUTO', 'Sys::User::UIDhelper' will be used.

This is GID number of a user. If set to 'AUTO', 'Sys::Group::GIDhelper' will be used.

This is the GECOS field for a user. If it is not defined, the name is used.

This is the login shell for the user. If it is not defined, it is set to '/sbin/nologin'.

This is the home directory of a user. If it is not defined, it is set to '/home/<name>'.

This is the attribute that will be used for when creating the entry. 'uid', 'uidNumber', or 'cn' are the accepted value. The default is 'uid'.

This is the LDAP description field. If it is not defined, it is set to gecos.

This is the min UID that will be used if 'uid' is set to 'AUTO'. The default is '1001'.

This is the max UID that will be used if 'uid' is set to 'AUTO'. The default is '64000'.

This is the min GID that will be used if 'gid' is set to 'AUTO'. The default is '1001'.

This is the max GID that will be used if 'gid' is set to 'AUTO'. The default is '64000'.

A internal function user for clearing an error.

Missing baseDN.

'name' not defined.

'uid' not defined.

'gid' not defined.

The primary value is a invalid value.

Zane C. Bowers, <vvelox at vvelox.net>

Please report any bugs or feature requests to bug-net-ldap-posixaccount at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-LDAP-posixAccount. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

You can find documentation for this module with the perldoc command.

    perldoc Net::LDAP::posixAccount

You can also look for information at:

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-LDAP-posixAccount

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/Net-LDAP-posixAccount

* CPAN Ratings

http://cpanratings.perl.org/d/Net-LDAP-posixAccount

* Search CPAN

http://search.cpan.org/dist/Net-LDAP-posixAccount

Copyright 2008 Zane C. Bowers, all rights reserved.

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