git.sur5r.net Git - openldap/blob - libraries/macintosh/README

   1 LDAP Macintosh README
   2
   3 The lber and ldap client libraries have been ported to Macintosh.
   4 Build testing was originally done with Think C 5.0.4 and MPW 3.2, both
   5 running under System 7.1.  Recently, it has been built using Metrowerks
   6 CodeWarrior 8.0 and Symantec C++ 7.0.3.  The libaries have been tested
   7 under System 7.0, 7.1, and 7.5, and are believed to run under any
   8 System later than 6.0.  None of the LDAP clients included in the
   9 distribution have been tested on the Mac.
  10
  11 MAKING THE DISTRIBUTION
  12 The instructions included here are for Symantec C 7.0.4, but the steps
  13 are very similar for the other environments.
  14
  15 To build the ldap and lber libraries (easiest to do as one project):
  16
  17         1) create a new project that contains the following files:
  18                 libraries/liblber/decode.c
  19                 libraries/liblber/encode.c
  20                 libraries/liblber/io.c
  21                 libraries/macintosh/tcp/dnr.c
  22                 libraries/macintosh/tcp/tcp.c
  23                 libraries/macintosh/macos-ip.c
  24                 libraries/macintosh/strings.c
  25           plus all the .c files in libraries/libldap/, except test.c,
  26           tmpltest.c, and os-ip.c.
  27
  28         2) put all of the .h files in include/, libraries/macintosh/,
  29            libraries/libldap and libraries/macintosh/tcp somewhere
  30            in the same folder where the project is located.
  31
  32         3) Add the MacTraps, MacTraps2, Unix, and ANSI-small libraries
  33            (included with Symantec/ThinkC) to the project.
  34
  35         3) Bring up the Edit menu "Options..." dialog and set the following:
  36              Language Settings:
  37                 Strict Prototype Enforcement/Require Prototypes
  38              Prefix:
  39                 #define MACOS
  40                 #define NEEDPROTOS
  41                 #define NEEDGETOPT
  42                 #define NO_USERINTERFACE
  43                 #define FILTERFILE      "ldapfilter.conf"
  44                 #define TEMPLATEFILE    "ldaptemplates.conf"
  45
  46              If you want to build a version of the library that does
  47              not have any global variables (such as for inclusion in a
  48              driver or other code module), add a "#define NO_GLOBALS"
  49              to the Prefix.  The only catch is that the tcp/dnr.c
  50              file needs changes to remove the global variables.
  51
  52              If you want support for referrals (optionally enabled
  53              for each LDAP connection), add '#define LDAP_REFERRALS'
  54              to the prefix list.  This is recommended.
  55
  56         4) Compile the project (Bring Up To Date under the Project menu)
  57
  58         5) If you would like to use the libldap/test.c program to test the
  59            library in an ugly console window, you will need to add the
  60            test.c file itself and the full ANSI library (instead of
  61            ANSI-small) to the project, and don't define NO_USERINTERFACE.
  62
  63 BUG REPORTING
  64
  65     Bug reports should be sent to bug-ldap@terminator.cc.umich.edu.
  66
  67 README Last updated 11 April 1996 by Mark Smith