INSTALL

Making and Installing the OpenLDAP Distribution

**
** It is recommended that you read or at least skim through ALL of the
** instructions in this file before attempting to build the software.
**
** You should also check for platform specific hints.
** These are located in doc/install/hints.
**

If you want to build binaries for more than one platform from a single
source tree, skip ahead to the "Building LDAP For More Than One Platform"
section near the end of this file.

If you simply want to build LDAP for a single machine platform, follow
these steps:

 1. untar the distribution and cd to the top:

	% tar xfz openldap-VERSION.tgz
	% cd ldap

    If you are reading this file, you probably have already done this!

 2. Type:
	% ./configure --help

	to list available configuration options.   A description of
	these options is provided in the 'CONFIGURE OPTIONS' section
	below.

	The configure script uses environmental variables for
	determining compiler/linker options.  See the HINTS
	section for commonly used settings. 

	These environment variables are used: 
		CC			C Compiler	(cc, ecgs)
		CFLAGS		C Flags		(-ansi)
		CPPFLAGS	CPP Flags	(-I/path/include -Ddef)
		LDFLAGS		LDFLAGS		(-L/path/lib -llib)

	See the 'USING ENVIRONMENT VARIABLES' section for information
	on how to use the variables. 

 3. edit the file include/ldapconfig.h.edit to configure
    the software for your site (the files are well-commented):

	% vi include/ldapconfig.h.edit

 4. Configure the build system

	% [env settings] ./configure [options]

	If all goes well, the configure script with auto-detect the
	appropriate settings.  Use configure enable/with options and/or
	environment variables to obtain desired results.

 5. Build dependencies

	% make depend

 6. Build the system

	% make

    If all goes well, the system will build as configured.  If not,
	return to step 4 after reviewing the configuration settings.

	You may want to consult the doc/install/hints file for your
	platform.