NAME

Samba::SIDhelper - Create SIDs based on G/UIDs.

VERSION

Version 0.0.0

SYNOPSIS

    use Samba::SIDhelper;

    my $sidhelper = Samba::SIDhelper->new({sid=>'S-1-5-21-1234-56789-10111213'});

    my $sid=$sidhelper->uid2sid('1002');
    if ($sidhelper){
        print "Error!\n";
    }

    $sid=$sidhelper->gid2sid('1002');
    if ($sidhelper){
        print "Error!\n";
    }

METHODS

new

args hash

sid

If this is specified, this base SID will be used instead of trying to automatically figure out what to use.

domain

If this is set to 1, it will try to use get the domain SID instead of the local SID.

    my $sidhelper->new({sid=>'S-1-5-21-1234-56789-10111213'});
    if($sidhelper->{error}){
        print "Error!\n";
    }

uid2sid

Convert a UID to SID.

   my $sid=$sidhelper->uid2sid('1002');
   if ($sidhelper){
       print "Error!\n";
   }

gid2sid

Convert a GID to SID.

   my $sid=$sidhelper->gid2sid('1002');
   if ($sidhelper){
       print "Error!\n";
   }

errorblank

This is a internal function and should not be called.

ERROR CODES

1

"net getdomainsid" exited with a non-zero.

2

"net getlocalsid" exited with a non-zero.

SID DISCOVERY

This requires Samba to be installed. The command net is used, which requires this being ran as root.

CONVERSION METHOD

This uses the method from smbldap-tools.

    $sid=$uid*2+1000
    $sid=$gid*2+1001

This method means both both user and group info is can be stored in the same space. Groups are always odd, while users are always even.

AUTHOR

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

BUGS

Please report any bugs or feature requests to "bug-samba-sidhelper at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Samba-SIDhelper>. 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 Samba::SIDhelper

You can also look for information at:

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

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

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