git.sur5r.net Git - openldap/blob - libraries/msdos/README.CSA

   1 LDAP MSDOS with NCSA Telnet TCP/IP stack README
   2
   3 The lber and ldap client libraries, and the ud client (called BUD on
   4 DOS) have been ported to MSDOS, running over the NCSA Telnet TCP/IP
   5 code (available from ftp.ncsa.uiuc.edu).  Build testing was done with
   6 Microsoft C 5.00 and MSDOS 5.0.  We plan to get Microsoft C 7.0 and
   7 join the 1990s soon....
   8
   9 This port was just completed as this is being written (4 September 1992),
  10 so it goes without saying that the code is largely untested under DOS.
  11 Be sure to report and bugs to us (see the end of this file for where to
  12 report bugs).
  13
  14 None of the other clients included in the distribution have been tested
  15 on the PC.  The synchronous LDAP interface is also untested, although it
  16 does build okay.
  17
  18 MAKING THE DISTRIBUTION
  19 To build the ldap and lber libraries:
  20
  21         1) obtain the NCSA source and build it.  The remainder of this
  22            README will assume the root of the NCSA source is a directory
  23            called "NCSA".
  24
  25         2) Create an NCSA\LDAP directory, and the following three
  26            directories underneath it: h, liblber, libldap.  You should
  27            have a structure that looks like this:
  28                 NCSA\
  29                         LDAP\
  30                                 H\
  31                                 LIBLBER\
  32                                 LIBLDAP\
  33
  34                         (lots of other NCSA directories)
  35
  36         3) Populate them from the distribution (files from the h/, liblber/,
  37            and libldap/ distribution directories get copied to H\,
  38            LIBLBER\, and LIBLDAP\ respectively).
  39
  40         4) Copy additional files for MSDOS to proper places:
  41            distribution file                    PC file
  42              msdos/makefile.msc                   LDAP\MAKEFILE.MSC
  43              msdos/msdos.h                        LDAP\H\MSDOS.H
  44              msdos/lp.c                           LDAP\LIBLBER\LP.C
  45              msdos/makelber.msc                   LDAP\LIBLBER\MAKELBER.MSC
  46              msdos/msdos.c                        LDAP\LIBLBER\MSDOS.C
  47              msdos/makeldap.msc                   LDAP\LIBLDAP\MAKELDAP.MSC
  48              msdos/opendos.c                      LDAP\LIBLDAP\OPENDOS.C
  49
  50         5) If you wish to change any compiler or linker switches, you
  51            should be able to do so just by editing the top-level
  52            MAKEFILE.MSC make file.  There seems to be a problem if you
  53            add -DLDAP_DEBUG: the linker is unable to resolve the
  54            lber_debug variable (defined in liblber/decode.c, used there
  55            and in liblber/io.c).  If anyone can figure out how to get it
  56            to work, let us know.
  57
  58         6) Build the library (this will also build the LDAP test program):
  59              cd NCSA\LDAP
  60              make makefile.msc
  61            If your DOS C compiler is as picky as ours, you will get many
  62            screen fulls of warnings that can safely be ignored.
  63            Note that if you try to make while sitting in the lower
  64            directories (LIBLDAP or LIBLBER), it will fail.  This will
  65            hopefully be cleaned up in a later release.
  66
  67         7) Test the library using LTEST.EXE:
  68              cd to somewhere where there is a proper NCSA CONFIG.TEL file
  69              execute "LTEST <LDAP server host>" from there, and test away.
  70
  71 To build the ud client "BUD":
  72         1) Build the ldap and lber libraries (see above).
  73
  74         2) Create a directory called UD underneath your LDAP directory,
  75            and populate it with all the files from the ud/ directory
  76            from the distribution.  Also add the following files:
  77              msdos/makeud.msc
  78              msdos/protoud.h
  79              macintosh/getopt.c (yes, put this in the LDAP\UD directory)
  80
  81         3) Change any desired options in UD.H or in the LDAP\MAKEFILE.MSC
  82            make file.  You will probably want to set up your own
  83            site-specific values for DEFAULT_BASE and DEFAULT_SERVER (in
  84            UD.H).
  85
  86         4) Uncomment out the lines near the end of LDAP\MAKEFILE.MSC
  87            that define the rules to make ud.
  88
  89         5) Build bud.exe:
  90              cd NCSA\LDAP
  91              make makefile.msc
  92            You should now have a working bud.exe.  Make sure you test
  93            it while in a directory that has a proper NCSA CONFIG.TEL file
  94            in it.
  95
  96 BUG REPORTING
  97
  98     Bug reports should be sent to bug-ldap@terminator.cc.umich.edu.
  99
 100 README Last updated 4 September 1992 Mark Smith