git.sur5r.net Git - openldap/blob - contrib/ldaptcl/README

   1 Copyright (c) 1998-1999 NeoSoft, Inc.
   2
   3 For licensing information, see the file neoXldap.c and/or the COPYRIGHT
   4 file contained in the directory you found this file.
   5
   6 This directory contains an extension to Tcl to interface with an
   7 LDAP server.  While this software is being released to the OpenLDAP
   8 community, it is the authors' intention that support continue (and
   9 be added) for other client libraries as well.  As time goes on, it
  10 is expected that code will converge rather than diverge.
  11
  12 Support is provided for University of Michigan LDAP version 3.3,
  13 OpenLDAP, and Netscape.  The default configuration supports
  14 OpenLDAP 1.2.4 and above.
  15
  16 OpenLDAP 2.x is supported, but there is not yet any support for
  17 using SASL or TLS.  There may be interface changes in the LDAP API
  18 which the author is unaware of (a leak was recently fixed for the
  19 return values of ldap_first/next_attribute() calls).
  20
  21 It uses GNU autoconf.  It builds and installs without requiring
  22 parallel directories, but it does require that Tcl and Extended Tcl
  23 are installed in the directory pointed to by --prefix (/usr/local
  24 by default).
  25
  26 For further info, try "./configure --help".
  27
  28 For example, I run:
  29
  30     ./configure  --prefix=/opt/neotcl --enable-shared \
  31         --with-ldap=/usr/local/ldap
  32
  33 Remember that --prefix must be the same prefix used when building
  34 and installint Tcl.
  35
  36 Netscape configuration has not been well tested, and you may have to
  37 play with the resulting Makefile to get it to work.  In particular,
  38 you will probably need to modify the LDAP_LIBFLAGS.  However, the
  39 C code itself is reasonably well tested with Netscape.
  40
  41 This module will install a regular shell (ldaptclsh) a windowing
  42 shell (ldapwish) a library, a pkgIndex.tcl, and a manpage (ldap.n).
  43
  44 If your Tcl installation has been configured with --enable-shared,
  45 then you must also use --enable-shared here.
  46
  47 Shared libraries and Tcl packages.
  48
  49 If Tcl is built with --enable-shared, AND OpenLDAP (or another version
  50 for that matter) has been build to create -llber and -lldap as shared
  51 libaries, AND you build ldaptcl with --enable-shared, it should be
  52 possible to run a plain Tcl interpreter (eg. tclsh8.0) and do
  53
  54                 package require Ldaptcl
  55
  56 which will install the "ldap" command into the interpreter.
  57
  58 You may need to set the LD_LIBRARY_PATH environment variable appropriately,
  59 or use -R or -W,-rpath ld command options to resolve the search for ldap
  60 and lber libraries.
  61
  62 This package was test built on a Alpha OSF4.0e with the native C
  63 compiler.
  64
  65 Please email comments or bug fixes to openldap-devel@OpenLDAP.org,
  66 or to kunkee@OpenLDAP.org.  I would also like to know if you are
  67 using this interface, so I invite you to drop me an email if you do.