1Net::LDAP::Extension::RUesferresCho(n3t)ributed Perl DocNuemte:n:tLaDtAiPo:n:Extension::Refresh(3)
2
3
4
6 Net::LDAP::Extension::Refresh - LDAPv3 Refresh extension object (RFC
7 2589)
8
10 use Net::LDAP;
11 use Net::LDAP::Extension::Refresh;
12
13 $ldap = Net::LDAP->new('localhost');
14 $ldap->bind('cn=admin,dc=example,dc=com', password => 'password');
15
16 $mesg = $ldap->refresh(entryName => 'cn=dynamic,dc=example,dc=com',
17 requestTtl => 100);
18 die "error :", $mesg->code(), ": ", $mesg->error() if ($mesg->code());
19 print "TTL changed to ", $mesg->get_ttl(), "\n";
20
22 "Net::LDAP::Extension::Refresh" implements the "Refresh" extended
23 LDAPv3 operation as described in RFC 2589
24
25 It implements no object by itself but extends the Net::LDAP object by
26 another method:
27
29 refresh ( OPTIONS )
30 Send a refresh operation for an object.
31
32 OPTIONS is a list of key/value pairs. The following keys are
33 recognized:
34
35 entryName
36 This option contains the object to refresh. It must be a DN.
37
38 requestTtl
39 This option contains the TTL in seconds requested. The server
40 may choose to set another value as stated in RFC 2589
41
42 get_ttl ( )
43 Return the TTL set by the server during the previous "refresh"
44 call.
45
46 This method is a method of the Net::LDAP::Message response object
47 returned in reply to refresh() in case the refresh() call
48 succeeded.
49
51 Net::LDAP, Net::LDAP::Extension
52
54 Etienne Bagnoud <etienne.bagnoud@irovision.ch> Adapted from Graham Barr
55 Net::LDAP::Extension::SetPassword Documentation adapted from Peter
56 Marschall Net::LDAP::Extension::SetPassword
57
58 Please report any bugs, or post any suggestions, to the perl-ldap
59 mailing list <perl-ldap@perl.org>
60
62 Copyright (c) 2010 Etienne Bagnoud. All rights reserved. This program
63 is free software; you can redistribute it and/or modify it under the
64 same terms as Perl itself.
65
66
67
68perl v5.36.0 2023-01-24 Net::LDAP::Extension::Refresh(3)