1=head1 NAME
2
3Net::LDAP::Reference - search reference
4
5=head1 SYNOPSIS
6
7  use Net::LDAP;
8
9  $ldap->search( @search_args, callback => \&process);
10
11  sub process {
12    my $mesg = shift;
13    my $obj = shift;
14    if (!$obj) {
15      # Search complete
16    }
17    elsif ($obj->isa('Net::LDAP::Reference')) {
18      my $ref;
19
20      foreach $ref ($obj->references) {
21        # process ref
22      }
23    }
24    else {
25      # Process Net::LDAP::Entry
26    }
27  }
28
29=head1 DESCRIPTION
30
31The B<Net::LDAP::Reference> object represents a reference (sometimes
32called a "referral") returned by the directory from a search.
33
34=head1 METHODS
35
36=over 4
37
38=item references
39
40Returns a list of references from the server.
41
42=back
43
44=head1 SEE ALSO
45
46L<Net::LDAP>,
47L<Net::LDAP::Search>
48
49=head1 AUTHOR
50
51Graham Barr E<lt>gbarr@pobox.comE<gt>.
52
53Please report any bugs, or post any suggestions, to the perl-ldap mailing list
54E<lt>perl-ldap@perl.orgE<gt>.
55
56=head1 COPYRIGHT
57
58Copyright (c) 1997-2004 Graham Barr. All rights reserved. This program is
59free software; you can redistribute it and/or modify it under the same
60terms as Perl itself.
61
62=cut
63