The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

VERSION

Version 1.0.0

SYNOPSIS

    use Net::LDAP::posixGroup;

    my $foo = Net::LDAP::posixGroup->new(baseDN=>'ou=group,dc=foo');

    # creates a new for the group newGroup with a GID of 404 and members of user1 and user2.
    my $entry = $foo->create(name=>'newGroup', gid=>'404', members=>['user1', 'user2']);

    print $entry->ldif;

FUNCTIONS

new

This initiates the object.

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

The following args are required.

    - name ::  The group name.

    - gid :: The numeric GID of a group.

The following are optional.

    - description :: A optional LDAP desciption.

    - primary :: The accepted values are 'cn' and 'gidNumber'.
        - default :: cn

Error Codes

All error codes are considered fatal, allowing for easy cheacking via eval.

1, noGroupName

No group name specified.

2, noGID

No GID specified.

3, invalidPrimary

The primary is a invalid value.

4, noBaseDN

Missing baseDN.

AUTHOR

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

BUGS

Please report any bugs or feature requests to bug-net-ldap-posixgroup at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-LDAP-posixGroup. 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::posixGroup

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2023 Zane C. Bowers-Hadley, all rights reserved.

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