uri::ldap(3)
NAME
URI::ldap - LDAP Uniform Resource Locators
SYNOPSIS
use URI;
$uri = URI->new("ldap:$uri_string");
$dn = $uri->dn;
$filter = $uri->filter;
@attr = $uri->attributes;
$scope = $uri->scope;
%extn = $uri->extensions;
$uri = URI->new("ldap:"); # start empty
$uri->host("ldap.itd.umich.edu");
$uri->dn("o=University of Michigan,c=US");
$uri->attributes(qw(postalAddress));
$uri->scope('sub');
$uri->filter('(cn=Babs Jensen)');
print $uri->as_string,"0;
DESCRIPTION
"URI::ldap" provides an interface to parse an LDAP URI in
its constituent parts and also build a URI as described in
RFC 2255.
METHODS
"URI::ldap" support all the generic and server methods
defined by URI, plus the following.
Each of the following methods can be used to set or get
the value in the URI. The values are passed in unescaped
form. None of these will return undefined values, but
elements without a default can be empty. If arguments are
given then a new value will be set for the given part of
the URI.
- $uri->dn( [$new_dn] )
- Set or get the Distinguised Name part of the URI. The DN identifies the base object of the LDAP search.
- $uri->attributes( [@new_attrs] )
- Set or get the list of attribute names which will be
returned by the search. - $uri->scope( [$new_scope] )
- Set or get the scope that the search will use. The
value can be one of "base", "one" or "sub". If none is
given in the URI then the return value will default to
"base". - $uri->_scope( [$new_scope] )
- Same as scope(), but does not default to anything.
- $uri->filter( [$new_filter] )
- Set or get the filter that the search will use. If
none is given in the URI then the return value will
default to "(objectClass=*)". - $uri->_filter( [$new_filter] )
- Same as filter(), but does not default to anything.
- $uri->extensions( [$etype => $evalue,...] )
- Set or get the extensions used for the search. The
list passed should be in the form etype1 => evalue1,
etype2 => evalue2,... This is also the form of list
that will be returned.
SEE ALSO
RFC-2255
AUTHOR
Graham Barr <gbarr@pobox.com>
Slightly modified by Gisle Aas to fit into the URI distri
bution.
COPYRIGHT
- Copyright (c) 1998 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.