NAME

Sys::User::UIDhelper - Helps for locating free UIDs.

VERSION

Version 0.0.1

SYNOPSIS

This finds a

    use Sys::User::UIDhelper;

    #implements it with the default values
    my $foo = Sys::User::UIDhelper->new();

    #sets the min to 0 and the max to 4000
    my $foo = Sys::User::UIDhelper->new({max=>'0', min=>'4000'});

    #finds the first free one
    my $first = $foo->firstfree();
    if(defined($first)){
        print $first."\n";
    }else{
        print "not found\n";
    }

    #finds the first last one
    my $last = $foo->lastfree();
    if(defined($last)){
        print $last."\n";
    }else{
        print "not found\n";
    }

EXPORT

FUNCTIONS

new

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

min

The minimum UID.

max

The maximum UID.

firstfree

This finds the first free UID. If it returns undef, no free ones were found.

lastfree

This finds the first last UID. If it returns undef, no free ones were found.

Todo

Implement various backends for system, LDAP, and passwd.

AUTHOR

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

BUGS

Please report any bugs or feature requests to "bug-sys-user-uidhelper at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Sys-User-UIDhelper>. 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 Sys::User::UIDhelper

You can also look for information at:

RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Sys-User-UIDhelper>
AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Sys-User-UIDhelper>
CPAN Ratings
<http://cpanratings.perl.org/d/Sys-User-UIDhelper>
Search CPAN
<http://search.cpan.org/dist/Sys-User-UIDhelper>

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

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