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.  OpenLDAP 2.x is not yet supported.
  15
  16 It uses GNU autoconf.  It builds and installs without requiring
  17 parallel directories, but it does require that Tcl and Extended Tcl
  18 are installed in the directory pointed to by --prefix (/usr/local
  19 by default).
  20
  21 For further info, try "./configure --help".
  22
  23 For example, I run:
  24
  25     ./configure  --prefix=/opt/neotcl --enable-shared \
  26         --with-ldap=/usr/local/ldap
  27
  28 Remember that --prefix must be the same prefix used when building
  29 and installint Tcl.
  30
  31 Netscape configuration has not been well tested, and you may have to
  32 play with the resulting Makefile to get it to work.  In particular,
  33 you will probably need to modify the LDAP_LIBFLAGS.  However, the
  34 C code itself is reasonably well tested with Netscape.
  35
  36 This module will install a regular shell (ldaptclsh) a windowing
  37 shell (ldapwish) a library, a pkgIndex.tcl, and a manpage (ldap.n).
  38
  39 If your Tcl installation has been configured with --enable-shared,
  40 then you must also use --enable-shared here.
  41
  42 Shared libraries and Tcl packages.
  43
  44 If Tcl is built with --enable-shared, AND OpenLDAP (or another version
  45 for that matter) has been build to create -llber and -lldap as shared
  46 libaries, AND you build ldaptcl with --enable-shared, it should be
  47 possible to run a plain Tcl interpreter (eg. tclsh8.0) and do
  48
  49                 package require Ldaptcl
  50
  51 which will install the "ldap" command into the interpreter.
  52
  53 You may need to set the LD_LIBRARY_PATH environment variable appropriately,
  54 or use -R or -W,-rpath ld command options to resolve the search for ldap
  55 and lber libraries.
  56
  57 This package was test built on a Alpha OSF4.0e with the native C
  58 compiler.
  59
  60 You may email comments or bug fixes to openldap-devel@OpenLDAP.org,
  61 or to kunkee@OpenLDAP.org.