[Summary view] [Print] [Text view]

   1  =head1 NAME
   2  
   3  Net::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  
  31  The B<Net::LDAP::Reference> object represents a reference (sometimes
  32  called a "referral") returned by the directory from a search.
  33  
  34  =head1 METHODS
  35  
  36  =over 4
  37  
  38  =item references
  39  
  40  Returns a list of references from the server.
  41  
  42  =back
  43  
  44  =head1 SEE ALSO
  45  
  46  L<Net::LDAP>,
  47  L<Net::LDAP::Search>
  48  
  49  =head1 AUTHOR
  50  
  51  Graham Barr E<lt>gbarr@pobox.comE<gt>.
  52  
  53  Please report any bugs, or post any suggestions, to the perl-ldap mailing list
  54  E<lt>perl-ldap@perl.orgE<gt>.
  55  
  56  =head1 COPYRIGHT
  57  
  58  Copyright (c) 1997-2004 Graham Barr. All rights reserved. This program is
  59  free software; you can redistribute it and/or modify it under the same
  60  terms as Perl itself.
  61  
  62  =cut