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.