X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=INSTALL;h=77fe82016acb5f9ca5974c695192cb793faf4bf2;hb=73b48936a7fc57f77de66260df699f22bf01aa26;hp=3e3fbca00f6878282269856d0009ca4c7083f7cc;hpb=a45bbea505288849f3bc01f19a828143d9679967;p=openldap diff --git a/INSTALL b/INSTALL index 3e3fbca00f..77fe82016a 100644 --- a/INSTALL +++ b/INSTALL @@ -4,11 +4,14 @@ 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. ** +** The OpenLDAP Quick Start Guide is available at: +** http://www.openldap.org/faq/index.cgi?file=172 +** ** The OpenLDAP Installation FAQ is available at: ** http://www.openldap.org/faq/index.cgi?file=8 ** -** You should also check for platform specific hints. -** These are located in doc/install/hints or: +** You should also check for platform specific hints located on +** on our web site. ** http://www.openldap.org/faq/index.cgi?file=9 ** @@ -22,9 +25,10 @@ these steps: 1. untar the distribution and cd to the top: % tar xfz openldap-VERSION.tgz - % cd ldap + % cd openldap-VERSION - If you are reading this file, you probably have already done this! + replacing VERSION to match the version you downloaded. If you are + reading this file, you probably have already done this! 2. Type: % ./configure --help @@ -47,12 +51,7 @@ these steps: 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 + 3. Configure the build system % [env settings] ./configure [options] @@ -60,11 +59,11 @@ these steps: appropriate settings. Use configure enable/with options and/or environment variables to obtain desired results. - 5. Build dependencies + 4. Build dependencies % make depend - 6. Build the system + 5. Build the system % make @@ -74,13 +73,13 @@ these steps: You may want to consult the doc/install/hints file for your platform. - 7. Test the standalone system + 6. Test the standalone system This step requires the standalone LDAP server (slapd) with LDBM support. % cd tests - % make + % make test If all goes well, the system has been built as configured. If not, return to step 4 after reviewing your configuration settings. @@ -88,11 +87,10 @@ these steps: You may want to consult the doc/install/hints file for your platform. - 8. install the binaries and man pages. You may need to be superuser to + 7. install the binaries and man pages. You may need to be superuser to do this (depending on where you are installing things): - % su - # make install + % su root -c make install That's it! @@ -157,8 +155,9 @@ The configure script will also use your environmental variables for determining compiler/linker options. This can be used to manual specify features and compilation options. -NOTE: If you change environment setting, be sure to remove - any config.cache before running ./configure. +WARNING: Executable built in your environment may not run + in your user's environments. The portability of + executables between environments is your responsibility. Supported Environmental Variables CC C compiler (cc, egcc) @@ -170,10 +169,11 @@ Supported Environmental Variables * Including alternative compilers Use the CC environment variable to tell configure to - use a specific compiler. For example, to use ecgs - instead of the compiler configure choose, use: + use a specific compiler. For example, to use GNU + C Compiler instead of the compiler configure choose, + use: - [env] CC=egcc ./configure + [env] CC=gcc ./configure You can also use CC use specific flags with the specified compiler. For example, to require strict