FM / URI

/usr/share/perl5/URI

Name	Size	Mode	Actions
file/	-	0755	rm
urn/	-	0755	rm
data.pm	3390	0644	edit dl rm
Escape.pm	7061	0644	edit dl rm
file.pm	9761	0644	edit dl rm
ftp.pm	1056	0644	edit dl rm
gopher.pm	2428	0644	edit dl rm
Heuristic.pm	6527	0644	edit dl rm
http.pm	425	0644	edit dl rm
https.pm	144	0644	edit dl rm
IRI.pm	794	0644	edit dl rm
ldap.pm	2924	0644	edit dl rm
ldapi.pm	440	0644	edit dl rm
ldaps.pm	144	0644	edit dl rm
mailto.pm	1657	0644	edit dl rm
mms.pm	125	0644	edit dl rm
news.pm	1454	0644	edit dl rm
nntp.pm	127	0644	edit dl rm
nntps.pm	144	0644	edit dl rm
pop.pm	1207	0644	edit dl rm
QueryParam.pm	4861	0644	edit dl rm
rlogin.pm	129	0644	edit dl rm
rsync.pm	207	0644	edit dl rm
rtsp.pm	125	0644	edit dl rm
rtspu.pm	126	0644	edit dl rm
sftp.pm	98	0644	edit dl rm
sip.pm	1695	0644	edit dl rm
sips.pm	143	0644	edit dl rm
snews.pm	172	0644	edit dl rm
Split.pm	2353	0644	edit dl rm
ssh.pm	175	0644	edit dl rm
telnet.pm	128	0644	edit dl rm
tn3270.pm	128	0644	edit dl rm
URL.pm	5487	0644	edit dl rm
urn.pm	2175	0644	edit dl rm
WithBase.pm	3862	0644	edit dl rm
_foreign.pm	107	0644	edit dl rm
_generic.pm	5822	0644	edit dl rm
_idna.pm	2079	0644	edit dl rm
_ldap.pm	3249	0644	edit dl rm
_login.pm	231	0644	edit dl rm
_punycode.pm	5622	0644	edit dl rm
_query.pm	2531	0644	edit dl rm
_segment.pm	416	0644	edit dl rm
_server.pm	3724	0644	edit dl rm
_userpass.pm	1034	0644	edit dl rm

Edit: /usr/share/perl5/URI/ldap.pm (2924B)

# Copyright (c) 1998 Graham Barr <gbarr@pobox.com>. All rights reserved.
# This program is free software; you can redistribute it and/or
# modify it under the same terms as Perl itself.

package URI::ldap;

use strict;
use warnings;

our $VERSION = '5.10';

use parent qw(URI::_ldap URI::_server);

sub default_port { 389 }

sub _nonldap_canonical {
    my $self = shift;
    $self->URI::_server::canonical(@_);
}

__END__

=head1 NAME

URI::ldap - LDAP Uniform Resource Locators

=head1 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,"\n";

=head1 DESCRIPTION

C<URI::ldap> provides an interface to parse an LDAP URI into its
constituent parts and also to build a URI as described in
RFC 2255.

=head1 METHODS

C<URI::ldap> supports all the generic and server methods defined by
L<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
return undefined values, but elements without a default can be empty.
If arguments are given, then a new value is set for the given part
of the URI.

=over 4

=item $uri->dn( [$new_dn] )

Sets or gets the I<Distinguished Name> part of the URI.  The DN
identifies the base object of the LDAP search.

=item $uri->attributes( [@new_attrs] )

Sets or gets the list of attribute names which are
returned by the search.

=item $uri->scope( [$new_scope] )

Sets or gets the scope to be used by the search. The value can be one of
C<"base">, C<"one"> or C<"sub">. If none is given in the URI then the
return value defaults to C<"base">.

=item $uri->_scope( [$new_scope] )

Same as scope(), but does not default to anything.

=item $uri->filter( [$new_filter] )

Sets or gets the filter to be used by the search. If none is given in
the URI then the return value defaults to C<"(objectClass=*)">.

=item $uri->_filter( [$new_filter] )

Same as filter(), but does not default to anything.

=item $uri->extensions( [$etype => $evalue,...] )

Sets or gets 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 is returned.

=back

=head1 SEE ALSO

L<http://tools.ietf.org/html/rfc2255>

=head1 AUTHOR

Graham Barr E<lt>F<gbarr@pobox.com>E<gt>

Slightly modified by Gisle Aas to fit into the URI distribution.

=head1 COPYRIGHT

=cut

cmd: