# Net::LDAP::Extension::SetPassword - phpMan

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

            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 circumstances
            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 by the server in response to the
        "set_password()" call when applicable. The server will not generate
        a new password if "newpasswd" was passed to "set_password()".

        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 <<gbarr@pobox.com>>, documentation by Peter Marschall
    <<peter@adpm.de>>.

    Please report any bugs, or post any suggestions, to the perl-ldap
    mailing list <<perl-ldap@perl.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.