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 the COPYRIGHT
   4 file contains 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.
  14
  15 It uses GNU autoconf.  It builds and installs without requiring
  16 parallel directories, but it does require that Tcl and Extended Tcl
  17 are installed in the directory pointed to by --prefix (/usr/local
  18 by default).
  19
  20 For further info, try "./configure --help".
  21
  22 For example, I run:
  23
  24     ./configure  --prefix=/opt/neosoft97 --enable-shared \
  25         --with-ldap=/usr/isp2000/ldap
  26
  27 Remember that --prefix must be the same prefix used when building
  28 and installint Tcl.
  29
  30 Netscape configuration has not been well tested, and you may have to
  31 play with the resulting Makefile to get it to work.  In particular,
  32 you will probably need to modify the LDAP_LIBFLAGS.  However, the
  33 C code itself is reasonably well tested with Netscape.
  34
  35 This module will install a regular shell (ldaptclsh) a windowing
  36 shell (ldapwish) a library, a pkgIndex.tcl, and a manpage (ldap.n).
  37
  38 If your Tcl installation has been configured with --enable-shared,
  39 then it is highly recommended that you also use --enable-shared
  40 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 This may require that you set the LD_LIBRARY_PATH environment variable
  54 appropriately, or use -R or -W,-rpath ld command options.
  55 It also may require that you modify the
  56 If you configure with --enable-shared, and you have shared libraries
  57 for -lldap and -llber, then you might be able to
  58 "package require Ldaptcl", provided that everything is set up
  59 exactly right, ie. -R ld flags, LD_LIBRARY_PATH environment variables,
  60 etc.
  61
  62 This package was test built on a Sparc Solaris 2.5 using the SUN Pro C
  63 compiler.
  64
  65 You may email comments or bug fixes to openldap-devel@OpenLDAP.org,
  66 or to kunkee@OpenLDAP.org.