Sleepycat DB 3.0

README.build

    Description for building DB 3.0 given the build environment

Platforms
---------

    The Build platforms currently supported include:

	AIX 4.3
	IRIX 6.5 ++
	HP/UX 11.00
	Linux 2.2.1
	OSF/1 V4.0d
	Solaris 2.6
	Windows NT 4.0

Comments: (10/05/1999)
++ not tested yet

UNIX Platforms
--------------

    For Unix platforms, the build process is as follows:

	cvs co -r db_3_1_branch ns/modules/db
	cd ns/modules/db
	builddb

    The 'builddb' command is a korn shell script (should be perl) that
    creates platform-specific, debug/optimized-specific integration and
    output directories, and then configures and builds the libdb pieces

    The 'builddb' command first uses the ns/modules/db/dist/configure script
    to create the platform/debug-specific Makefile and then builds that
    platform/debug-specific version to generate the following files.

    Next, the 'builddb' command runs the generated Makefile to create the
    shared library, static library, header file, and tools for that platform.

    On AIX 4.x, the os_unix/AIX/libdb30.exp file must be copied to the
    built/AIX-full/lib and built/AIX-optimize/lib target directories.
    This file specifies the exported subroutines which can be used (imported)
    by programs using the libdb30.a shared library on AIX.

    To build 64bit support for HP, do builddb -64. 

Configuration for other platforms:
----------------------------------
    We introduce PLATFORMCCFLAGS and PLATFORMLDFLAGS in builddb. If you want
    to add extra compilation flags, use these two, builddb will pass these to
    gmake. If you want to change all the CFLAGS/LDFALGS, then define the 
    CFLAGS/LDFLAGS, export the variables. 


NT Platforms
------------

    For NT platforms, the build process is as follows:

	cvs co -r db_3_1_branch ns/modules/db

	[ set echo=on ]

	builddb[.bat] [ All | Release | Debug | Clean | Help ]

    The 'builddb.bat' command is an NT batch script (should be perl) that
    creates platform-specific, debug/optimized-specific integration and
    output directories, and then configures and builds the libdb pieces.

    The 'builddb.bat' script uses the ns/modules/db/build_win32/Berkeley_DB.dsw
    project file provided by the Sleepycat development team to generate the
    debug-specific (full or optimized) object files and static and shared
    libraries.

