Unix/Linux Go Back    


CentOS 7.0 - man page for net::ldap::extension::setpassword (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Net::LDAP::Extension::SetPasswoUser)Contributed Perl DocumentNet::LDAP::Extension::SetPassword(3)

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

perl v5.16.3				    2013-06-07	     Net::LDAP::Extension::SetPassword(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 11:38 AM.