Zane C. Bowers-Hadley > Net-LDAP-posixAccount > Net::LDAP::posixAccount

Download:
Net-LDAP-posixAccount-0.0.2.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.0.2   Source  

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.

syntax highlighting: