NAME

Net::LDAP::Control::SortResult - LDAPv3 sort result control object

SYNOPSIS

 use Net::LDAP::Control::Sort;
 use Net::LDAP::Constant qw( LDAP_CONTROL_SORTRESULT );

 $sort = Net::LDAP::Control::Sort->new(
   order => "cn -age"
 );

 $mesg = $ldap->search( @args, control => [ $sort ]);

 ($resp) = $mesg->control( LDAP_CONTROL_SORTRESULT );

 print "Results are sorted\n" if $resp and !$resp->result;

DESCRIPTION

Net::LDAP::Control::SortResult is a sub-class of Net::LDAP::Control. It provides a class for manipulating the LDAP sort request control 1.2.840.113556.1.4.474

A sort result control will be returned by the server in response to a search with a sort control. If a sort result control is not returned then the user may assume that the server does not support sorting and the resutls are not sorted.

CONSTRUCTOR ARGUMENTS

result

attr

METHODS

Net::LDAP::Control::SortResult provides the following methods in addition to those defined by Net::LDAP::Control

result [ RESULT ]

attr [ ATTR ]

RESULT CODES

Possible results from a sort request are listed below. See Net::LDAP::Constant for a definition of each.

LDAP_SUCCESS

LDAP_OPERATIONS_ERROR

LDAP_TIMELIMIT_EXCEEDED

LDAP_STRONG_AUTH_REQUIRED

LDAP_ADMIN_LIMIT_EXCEEDED

LDAP_NO_SUCH_ATTRIBUTE

LDAP_INAPPROPRIATE_MATCHING

LDAP_INSUFFICIENT_ACCESS

LDAP_BUSY

LDAP_UNWILLING_TO_PERFORM

LDAP_OTHER

SEE ALSO

Net::LDAP, Net::LDAP::Control::Sort, Net::LDAP::Control

AUTHOR

Graham Barr <gbarr@pobox.com>

Please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap-dev@lists.sourceforge.net>

COPYRIGHT

Copyright (c) 1999-2000 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.

$Id: //depot/ldap/lib/Net/LDAP/Control/SortResult.pm#3 $