mutt_ldap_query.pl version 3.0
==============================

The latest version of the code can be retrieved at 
  ftp://ftp.mutt.org/pub/mutt/contrib

This code is distributed under the GNU General Public License (GPL). See
http://www.opensource.org/gpl-license.html and http://www.opensource.org/.

mutt_ldap_query performs ldap queries using either ldapsearch command
or the perl-ldap module and it outputs the required formatted data for
feeding mutt when using its "External Address Query" feature.

This perl script can be interfaced with mutt by defining in your .muttrc:
  set query_command = "mutt_ldap_query.pl '%s'"
Multiple requests are supported: the "Q" command of mutt accepts as argument
a list of queries (e.g. "Gosse de\ Courville").

usage: mutt_ldap_query [-p] -s <server_name> -b <search_base> -n <server_nickname> <name_to_query> [[<other_name_to_query>] ...]

-p use perl-ldap module instead of ldapsearch (which is the default)
-s query ldap server <server_name>
-b use <search_base> as the starting point for the search instead of the default
-n shortcut for avoiding -s and -b options by using the script builtin
   table of common servers and associated search bases performing a 
   <server_nickname> lookup

examples of queries:
  classical query:
    mutt_ldap_query.pl -s ldap.crm.mot.com -b 'o=Motorola,c=US' Gosse
  and its shortcut version using a nickname
    mutt_ldap_query.pl -n crm Gosse de\ Courville

References:
- perl-ldap module 
  http://www.perl.com/CPAN-local/authors/id/GBARR
- ldapsearch is a ldap server query tool present in ldap-3.3 distribution 
  http://www.umich.edu/~rsug/ldap)
- mutt is the ultimate email client
  http://www.mutt.org
- historical Brandon Blong's "External Address Query" feature patch for mutt
  http://www.fiction.net/blong/programs/mutt/#query

Marc de Courville <marc@courville.org>
December 29, 1999