unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

Net::LDAP::Extension::UseraContributed PNet::LDAP::Extension::SetPassword(3pm)



NAME
       Net::LDAP::Extension::SetPassword - LDAPv3 Modify Password extension
       object

SYNOPSIS
        use Net::LDAP;
        use Net::LDAP::Extension::SetPassword;

        $ldap = Net::LDAP->new( "ldap.mydomain.eg" );

        $ldap->bind('cn=Joe User,cn=People,dc=mydomain,dc=eg",
                    password => 'oldPassword');

        $mesg = $ldap->set_password( oldpasswd => 'oldPassword' );

        die "error: ", $mesg->code(), ": ", $mesg->error()  if ($mesg->code());

        print "changed your password to", $mesg->gen_password() , "\n";

DESCRIPTION
       "Net::LDAP::Extension::SetPassword" implements the "Modify Password"
       extended LDAPv3 operation as described in RFC 3062.

       It implements no object by itself but extends the Net::LDAP object by
       another method:

METHODS
       set_password ( OPTIONS )
           Set the password for a user.

           OPTIONS is a list of key/value pairs. The following keys are
           recognized:

           user
               If present, this option contains the octet string
               representation of the user associated with the request.
               Depending on how users are identified in the directory this
               string may or may not be a DN according to RFC 2253.

               If this option is not present, the request acts up upon the
               password of the user currently associated with the LDAP
               session.

           oldpasswd
               This option, if present, must contain the current password of
               the user for whom this operation is performed.

               It depends on the server's implementation in which cirumstances
               this option is allowed to be missing.

           newpasswd
               If present, this option contains the desired password for the
               user for whom the operation is performed.

               Depending on the server's implementation this option may be
               required by the LDAP server.

       gen_password ( )
           Return the password generated in the previous "set_password()"
           call.

           This method is a method of the Net::LDAP::Message response object
           returned in reply to "set_password()" in case the "set_password()"
           call succeeded.

           By this method the caller can query for the value of the password
           in case he did not call "set_password()" with the "newpasswd"
           option.

SEE ALSO
       Net::LDAP, Net::LDAP::Extension

AUTHOR
       Graham Barr <gbarrATpobox.com>, documentation by Peter Marschall
       <peterATadpm.de>.

       Please report any bugs, or post any suggestions, to the perl-ldap
       mailing list <perl-ldapATperl.org>

COPYRIGHT
       Copyright (c) 2002-2004 Graham Barr. All rights reserved. This program
       is free software; you can redistribute it and/or modify it under the
       same terms as Perl itself.



perl v5.10.0                      2008-0Net::LDAP::Extension::SetPassword(3pm)