]> git.sur5r.net Git - openldap/blob - build/PORTS
Sync with HEAD (fix global schemadn)
[openldap] / build / PORTS
1 This file gives some helpful hints for building LDAP on various machines.
2
3 LDAP has been built and tested on the following platforms.  It will
4 probably build fine under similar versions of the OS (e.g. it has
5 been built and tested under SunOS 4.1.4, but probably builds fine
6 under all SunOS 4.1.x systems).
7
8 If you port LDAP to a new platform, let us know so we can add it here.
9 See the end of this file for some hints on doing a port.  The following
10 tables give some indication of the level of support there is for various
11 platforms where the LDAP release has been built.  Key:
12
13     X - all pieces are known to build and work
14     B - all pieces build and are believed to work
15     S - some pieces build and work
16     O - an older LDAP release has been ported here; current status unknown
17     ? - unknown
18     - - does not build and/or work at all
19
20 ** Unix and Unix-like platforms:
21
22  OS Version     libraries   clients    ldapd    slapd    slurpd
23  ----------     ---------   -------    -----    -----    ------
24  AIX 3.2.5          X          X         B        B        -(1)
25
26  HP-UX 9.05         X          X         ?        B        -(1)
27
28  Linux 1.3.76       X          X         O        X        -(1)
29
30  FreeBSD 2.0.5      X          X         ?        B        ?
31
32  NETBSD 0.9a        O          O         ?        ?        ?
33
34  NeXTSTEP 3.2       O          O         ?        ?        ?
35
36  SunOS 4.1.4        X          X         X        X        X
37
38  SunOS 5.5          X          X         B        X        X
39  (Solaris 2.5)
40
41  Ultrix 4.3         X          X         B        B        ?
42
43  OSF/1 3.2          X          X         X        X        ?
44
45  IRIX 5.x/6.x       B          B         ?        B        ?
46
47  NCR MP-RAS 2.3     X          X         ?        ?        ?
48
49 (1) - required threads support not provided by vendor
50
51 ** Non-Unix Platforms:
52
53  OS Version     libraries   clients    ldapd    slapd    slurpd
54  ----------     ---------   -------    -----    -----    ------
55  MacOS 7.5          X          -         -        -        -
56      (see the file libraries/macintosh/README for build instructions)
57
58  MSDOS              O          S         -        -        -
59      (see the file libraries/msdos/README for build instructions)
60
61  MS-Windows 3.x     O          -         -        -        -
62      (see the file libraries/msdos/README.WSA for build instructions)
63
64  MS-Win NT & 95     O          ?         ?        ?        ?
65
66  VMS                X          S         X        X        ?
67      (see the file libraries/vms/README.VMS for build instructions)
68
69
70 ** Hints on Porting LDAP to a New Platform
71
72 If your platform is not listed here, you will need to do a port.  The
73 place to start for Unix systems is by creating a new directory under
74 the LDAP build/platforms directory and creating an appropriate
75 Make-platform file.  It is probably easiest to start by duplicating a
76 directory there that is for a platform similar to yours.
77
78 Variables commonly set in the Make-platform files include:
79
80 CC              - compiler to use, e.g. CC=cc or CC=gcc
81 PLATFORMCFLAGS  - flags added to every compile
82 PLATFORMLDFLAGS - flags added to every link
83 PLATFORMLIBS    - extra libraries needed (added to the end of all link commands)
84 LDBMLIB         - ndbm library, needed if not in libc (e.g. LDBMLIB=-lndbm)
85 NEEDUNPROTO=yes - set if your compiler doesn't understand prototypes; see the
86                       sunos4-cc and hpux-cc files for example usage
87 INSTALL         - BSD-like install command; if necessary, you can use a script
88                       we provide:  INSTALL=$(LDAPSRC)/build/install.sh
89 RANLIB          - command to convert libraries for efficient random access;
90                       if your system has no ranlib, use RANLIB = ""
91 other commands  - see the file build/Make-append for a list
92
93 You will also need to modify the top-level LDAP Makefile .make-platform
94 rule to know about your platform.  Finally, you should look through the
95 include/portable.h file and make any necessary adjustments.
96
97 Please send changes via e-mail to:  ldap-support@umich.edu so they can be
98 incorporated into future releases.