GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::LDAP::EXTENSION::SETPASSWORD (3)

.ds Aq ’

NAME

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

CONTENTS

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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::LDAP::EXTENSION::SETPASSWORD (3) 2015-04-02

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.