Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Net::LDAP::Extension::UseraContributed PerNet::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
	       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.

perl v5.32.1			  2015-04-Net::LDAP::Extension::SetPassword(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Net::LDAP::Extension::SetPassword&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help