openldap/contrib/tweb

/*_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/
*                                                                          *
* README                                                                   *
*                                                                          *
* Function:..Introduction to the WWW-X.500 gateway TWEB                    *
*                                                                          *
*                                                                          *
*                                                                          *
* Authors:...Dr. Kurt Spanier & Bernhard Winkler,                          *
*            Zentrum fuer Datenverarbeitung, Bereich Entwicklung           *
*            neuer Dienste, Universitaet Tuebingen, GERMANY                *
*                                                                          *
*                                       ZZZZZ  DDD    V   V                *
*            Creation date:                Z   D  D   V   V                *
*            September 14 1995            Z    D   D   V V                 *
*            Last modification:          Z     D  D    V V                 *
*            September 13 1999          ZZZZ   DDD      V                  *
*                                                                          *
_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/*/


IMPORTANT HINT FOR UPGRADING TO VERSION 2.3.x:

    the config-syntax of ALLOW-STRING DENY-STRING GRANT REFUSE has changed:
    now regular expressions are used enabling shorter config strings.

    the language-files have been extended. Please use the newly provided
    language-files or update your old ones.



INTRODUCTION

   TWEB is based on the Web500gw implementation by Frank Richter, 
   Technische Universitaet Chemnitz-Zwickau, which is based on the 
   go500gw implementation by Tim Howes, University of Michigan.

   TWEB was compiled and tested on LINUX with cc, HPUX 9.05 with the
   HP-ANSI C compiler, as well as SunOS 4.1.2 with the SUN C compiler.
   TWEB was also compiled with gcc on all platforms.

   The UMICH LDAP client library version 3.0 or 3.3
   ( URL:ftp://terminator.rs.itd.umich.edu/ldap/ldap-3.3.tar.Z )
   must be installed on the machine (library path and include file 
   path is configured in Makefile). With QUIPU ICR-2.x the ISODE-
   provided LDAP libraries should be used. As such, TWEB only supports
   LDAP version 2 with the University of Michigan type C API. TWEB is
   also adapted for the OpenLDAP LDAP library, release version 1.1.2
   (http://www.openldap.org).

   An upgrade to LDAP version 3 and a C API standadized by the IETF
   is planned for a not so far away future, most probably in step 
   with the OpenLDAP package.

   TWEB, as provided here is a fully functional core gateway, which
   is extended at the author's site by some local features. These
   extensions are included into the same code base, so that some
   "#ifdef TUE_TEL" or "#ifdef AMBIX" pre-processor statements can
   be found throughout the code. 

   Have a look at the doc sub-directory to get some further documentation.


INSTALLATION

   The installation and configuration of TWEB is described in the
   GETTING-STARTED file. After making and testing the basic TWEB
   you should have a look to file FEATURE-LIST to learn about the 
   several configuration parameters TWEB provides for runtime
   configuration of the program.

   SINCE THE CODE IS ONLY THE CORE GATEWAY, WITH SOME PRIVATE EXTENSIONS
   NOT INCLUDED INTO THAT DISTRIBUTION, DO NOT DELETE CODE BETWEEN

      #ifdef TUE_TEL
      #endif

   AND

     #ifdef AMBIXGW
     #endif

   IN ANY OF THE SUPPORTED FILES !!!


SUPPORT

   Bug reports and flames (but also critical comments) please send to 

       tweb-support@mail500.uni-tuebingen.de. 
    
   For general discussion (e.g., about interesting new features,
   which should be supported), there is a discussion list at

       tweb-l@mail500.uni-tuebingen.de.

   Send requests for subscription to

       tweb-l-request@mail500.uni-tuebingen.de.


TWEB development team, Tuebingen, September, 9th, 1999