Zane C. Bowers-Hadley

NAME

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

VERSION

Version 0.0.2

SYNOPSIS

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

FUNCTIONS

new

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

baseDN

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

topless

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

create

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

name

The name of the user.

cn

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

uid

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

gid

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

gecos

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

loginShell

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

home

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

primary

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

description

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

minUID

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

maxUID

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

minGID

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

maxGID

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

errorBlank

A internal function user for clearing an error.

Error Codes

0

Missing baseDN.

1

'name' not defined.

2

'uid' not defined.

3

'gid' not defined.

4

The primary value is a invalid value.

AUTHOR

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

BUGS

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.

SUPPORT

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

    perldoc Net::LDAP::posixAccount

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

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.