pjs/directory/buildsdk.txt

======================================================================
                    NETSCAPE DIRECTORY SDK FOR C: 
                         BUILD INSTRUCTIONS
======================================================================
For information on the Netscape Directory SDK source release,
see http://www.mozilla.org/directory/

Unix/Linux Build Instructions
-----------------------------

System Requirements:
    32MB of RAM, 128MB of swap, recommended 64MB of RAM.

Tool Requirements:
    Native C compiler or GNU C/C++ compiler 2.7.2 
      (or a more recent version)
    GNU make 3.74 or a more recent version

Instructions:
1. Uncompress and extract the source files by entering the
   following command (or your preferred variant of this command):

   gzip -dc <filename>.tar.gz | tar -xvf -

2. Set and unset the following environment variables.

   In csh/tcsh: 
      setenv MOZILLA_CLIENT 1
      setenv NO_MDUPDATE 1
      unsetenv MOZ_LI 
      unsetenv MOZ_LITE 
      unsetenv MOZ_MEDIUM 
      unsetenv NO_SECURITY

   In sh/bash/ksh:
      MOZILLA_CLIENT=1
      NO_MDUPDATE=1
      export MOZILLA_CLIENT NO_MDUPDATE
      unset MOZ_LI 
      unset MOZ_LITE 
      unset MOZ_MEDIUM 
      unset NO_SECURITY

3. Build the SDK by entering the following commands:

   cd ns
   gmake

   The SDK will be built and copied into the following directories:
       mozilla/dist/public/ldap - header files
       mozilla/dist/<architecture>/bin - LDAP API shared object/library


Windows Build Instructions
--------------------------

System Requirements:
    Windows NT 3.51 or 4.0 (4.0 preferred).

Tool Requirements:
    Microsoft Visual C++ version 4.2 or a more recent version 
    GNU Tools for Windows (you can find these on the Internet). 
      Specifically, you'll need: 
        cp.exe
        rm.exe
      Here are some sample download sites to find these: 
        Cygnus (http://www.cygnus.com/misc/gnu-win32)
        GNU (http://www.gnu.org/order/ftp.html)
        MIT (ftp://prep.ai.mit.edu/pub/gnu)
      Netscape uses internally modified versions of the following tools: 
        gmake.exe
        shmsdos.exe
        uname.exe
      You can download them from http://www.mozilla.org/download-mozilla.html
      (click the Windows Build Tools link).  When you unzip the file, the
      tools will be located in the windows\bin\x86 directory. 
    Netscape-developed tools (makedep.exe, txt2rc.exe, waitfor.exe),
      which are located in the mozilla\cmd\winfe\mkfiles32 directory

    All of these tools need to be put in your path.

Extracting the Source Files:
    The source files for the Directory C SDK are zipped in the file 
    ldap-c-sdk.zip.  When unzipping the file, make sure to specify
    that you want to preserve the directory structure.  For example,
    make sure that "Use Folder Names" is checked.

Instructions:
    NOTE: Make sure to run the commands from a standard Windows NT 
    command prompt.  Although you may be able to use other shells 
    to build the SDK, you may need to adjust the makefiles for 
    the shell that you are using.
1. Set the following environment variables (within the command session, 
   either manually or via a script), or within the system environment 
   through the Control Panel | System control panel): 
       set HOME=(your home directory) 
       set MOZ_BITS=32
       set MOZ_NT=351 (if running NT 3.51, don't set otherwise) 
       set MOZ_SRC=(top of your source tree, drive letter and path. 
         For example, set MOZ_SRC=d:\mozilla_src, if the mozilla 
         directory is at d:\mozilla_src\mozilla.)
       set MOZ_TOOLS=(location of the bin directory containing your 
         GNU tools. The build looks for MOZ_TOOLS\bin\gmake.exe, 
         so make sure that the MOZ_TOOLS environment variable 
         is set correctly.)
       set PATH=%MOZ_TOOLS%\bin;%PATH% 
       set TEMP=(your temp directory) 
       set TMP=(your temp directory) 
       set VERBOSE=1 

   Unset the following environment variables:
       set MOZ_MEDIUM= 
       set MOZ_LITE= 
       set NO_SECURITY= 
       set MOZ_LI= 
       set MOZ_DATE= 

2. Enter the following commands to build the SDK: 
       cd ns 
       nmake -f ldapsdk.mak build_ldap  

   The SDK will be built and copied into the following directories:
       mozilla\dist\public\ldap - header files
       mozilla\dist\Win32_d.obj\bin - LDAP API DLL (nsldap32.dll)
       mozilla\dist\Win32_d.obj\lib - import and static libraries
                                   (nsldap32.lib, nsldap32s.lib)

Notes:
    This build process does not use Visual C++ generated project files. 
      (Reasons for this include size, maintainability, and the long-term 
      desire to use tools like gmake or plug-and-play developer tools.) 
      This does not preclude you from using the Visual C++ IDE or its debugger. 

Common Build Problems: 
    If the build fails with the message "'.\WIN32' unexpected", 
      you didn't set the environment variables correctly.  Check for 
      extra spaces at the end of the set statements (this is a 
      common problem when copying and pasting commands). 
    If directory-related errors are reported, check the full path to 
      the source for any spaces. Make sure that when you originally extracted 
      the source files, you used a utility that understands long filenames. 
      If you are not sure if your extraction utility understands long filenames, 
      use Info-Zip.  (You can get this from ftp://ftp.cdrom.com/pub/infozip.)


--------------------------------------------------------
Copyright (c) 1998 Netscape Communications Corporation.
(http://home.netscape.com/misc/contact_info.html)