head 1.2;
access;
symbols
RPM_4_2_1:1.1.1.5
RPM_4_2:1.1.1.5
RPM_4_1_1:1.1.1.5
RPM_4_1:1.1.1.4
RPM_4_0_5:1.1.1.3
RPM_4_0_4:1.1.1.2
RPM_4_0_3:1.1.1.1
RPM:1.1.1;
locks; strict;
comment @# @;
1.2
date 2008.01.02.09.54.53; author rse; state dead;
branches;
next 1.1;
commitid z4cpSiAhOCXk5PLs;
1.1
date 2001.07.23.20.45.37; author rse; state Exp;
branches
1.1.1.1;
next ;
1.1.1.1
date 2001.07.23.20.45.37; author rse; state Exp;
branches;
next 1.1.1.2;
1.1.1.2
date 2002.01.08.00.30.11; author rse; state Exp;
branches;
next 1.1.1.3;
1.1.1.3
date 2003.01.18.13.49.01; author rse; state Exp;
branches;
next 1.1.1.4;
1.1.1.4
date 2001.10.15.03.47.34; author rse; state Exp;
branches;
next 1.1.1.5;
1.1.1.5
date 2003.01.18.14.04.59; author rse; state Exp;
branches;
next ;
desc
@@
1.2
log
@remove the ancient RPM 4.2.1 source tree copy
@
text
@
Berkeley DB Reference Guide: Configuring Berkeley DB
- Berkeley DB Reference Guide:
- Building Berkeley DB for UNIX systems
|
  
|
Configuring Berkeley DB
There are several options that you can specify when configuring Berkeley DB.
Although only the Berkeley DB-specific ones are described here, most of the
standard GNU autoconf options are available and supported. To see a
complete list of the options, specify the --help flag to the configure
program.
The Berkeley DB specific options are as follows:
- --enable-compat185
- To compile or load Berkeley DB 1.85 applications against this release of the
Berkeley DB library, enter --enable-compat185 as an argument to configure.
This will include Berkeley DB 1.85 API compatibility code in the library.
- --enable-cxx
- To build the Berkeley DB C++ API, enter --enable-cxx as an argument to
configure.
- --enable-debug
- To build Berkeley DB with -g as a compiler flag and with DEBUG
#defined during compilation, enter --enable-debug as an argument to
configure. This will create a Berkeley DB library with debugging symbols, as
well as load various routines that can be called from a debugger to
display pages, cursor queues, and so forth. This option should not be
specified when configuring to build production binaries.
- --enable-debug_rop
- To build Berkeley DB to output log records for read operations, enter
--enable-debug_rop as an argument to configure. This option should not
be specified when configuring to build production binaries.
- --enable-debug_wop
- To build Berkeley DB to output log records for write operations, enter
--enable-debug_wop as an argument to configure. This option should not
be specified when configuring to build production binaries.
- --enable-diagnostic
- To build Berkeley DB with run-time debugging checks, enter --enable-diagnostic
as an argument to configure. This will cause a number of special checks
to be performed when Berkeley DB is running. Applications built using this
option should not share database environments with applications built
without this option. This option should not be specified when
configuring to build production binaries.
- --enable-dump185
- To convert Berkeley DB 1.85 (or earlier) databases to this release of Berkeley DB,
enter --enable-dump185 as an argument to configure. This will build the
db_dump185 utility, which can dump Berkeley DB 1.85 and 1.86 databases
in a format readable by the Berkeley DB db_load utility.
The system libraries with which you are loading the db_dump185
utility must already contain the Berkeley DB 1.85 library routines for this
to work because the Berkeley DB distribution does not include them. If you
are using a non-standard library for the Berkeley DB 1.85 library routines,
you will have to change the Makefile that the configuration step creates
to load the db_dump185 utility with that library.
- --enable-java
- To build the Berkeley DB Java API, enter --enable-java as an argument to
configure. To build Java, you must also build with shared libraries.
Before configuring, you must set your PATH environment variable to
include javac. Note that it is not sufficient to include a symbolic
link to javac in your PATH because the configuration process uses the
location of javac to determine the location of the Java include files
(for example, jni.h). On some systems, additional include directories
may be needed to process jni.h; see Changing compile or
load options for more information.
- --disable-largefile
- Some systems, notably versions of HP/UX and Solaris, require special
compile-time options in order to create files larger than 2^32 bytes.
These options are automatically enabled when Berkeley DB is compiled. For
this reason, binaries built on current versions of these systems may
not run on earlier versions of the system because the library and system
calls necessary for large files are not available. To disable building
with these compile-time options, enter --disable-largefile as an argument
to configure.
- --enable-posixmutexes
- To force Berkeley DB to use the POSIX pthread mutex interfaces for underlying
mutex support, enter --enable-posixmutexes as an argument to configure.
The Berkeley DB library requires that the POSIX pthread implementation support
mutexes shared between multiple processes, as described for the
pthread_condattr_setpshared and pthread_mutexattr_setpshared interfaces.
In addition, this configuration option requires that Berkeley DB be linked
with the -lpthread library. On systems where POSIX mutexes are the
preferred mutex support (for example, HP-UX), they will be selected
automatically.
- --enable-rpc
- To build the Berkeley DB RPC client code and server utility, enter --enable-rpc
as an argument to configure. The --enable-rpc option requires that RPC
libraries already be installed on your system.
- --disable-shared, --disable-static
- On systems supporting shared libraries, Berkeley DB builds both static and
shared libraries by default. (Shared libraries are built using
the GNU
Project's Libtool distribution, which supports shared library builds
on many (although not all) systems.) To not build shared libraries,
configure using the --disable-shared option. To not build static
libraries, configure using the --disable-static option.
- --enable-tcl
- To build the Berkeley DB Tcl API, enter --enable-tcl as an argument to
configure. This configuration option expects to find Tcl's tclConfig.sh
file in the /usr/local/lib directory. See the --with-tcl
option for instructions on specifying a non-standard location for the
Tcl installation. See Loading Berkeley DB
with Tcl for information on sites from which you can download Tcl and
which Tcl versions are compatible with Berkeley DB. To build Tcl, you must
also build with shared libraries.
- --enable-test
- To build the Berkeley DB test suite, enter --enable-test as an argument to
configure. To run the Berkeley DB test suite, you must also build the Tcl
API. This option should not be specified when configuring to build
production binaries.
- --enable-uimutexes
- To force Berkeley DB to use the UNIX International (UI) mutex interfaces for
underlying mutex support, enter --enable-uimutexes as an argument to
configure. This configuration option requires that Berkeley DB be linked with
the -lthread library. On systems where UI mutexes are the preferred
mutex support, (for example, SCO's UnixWare 2), they will be selected
automatically.
- --enable-umrw
- Rational Software's Purify product and other run-time tools complain
about uninitialized reads/writes of structure fields whose only purpose
is padding, as well as when heap memory that was never initialized is
written to disk. Specify the --enable-umrw option during configuration
to mask these errors. This option should not be specified when
configuring to build production binaries.
- --with-embedix=DIR
- To build Berkeley DB for Embedix, configure with --with-embedix=DIR, where
DIR is the directory in which Embedix is installed. If "=DIR" is not
specified, a default installation directory of /opt/Embedix is
used. This configuration option creates an Embedix Component Descriptor
file (ECD) for Berkeley DB. To configure for Embedix, you must also specify
the --with-rpm option.
- --with-rpm=DIR
- To build Berkeley DB as an RPM software package, configure with --with-rpm=DIR,
where DIR is the directory in which the gzipped tar archive file of the
distribution may be found. This configuration option will create an
RPM specification file from which the RPM software package can be built,
using the "make" command.
- --with-tcl=DIR
- To build the Berkeley DB Tcl API, enter --with-tcl=DIR, replacing DIR with
the directory in which the Tcl tclConfig.sh file may be found. See
Loading Berkeley DB with Tcl for information
on sites from which you can download Tcl and which Tcl versions are
compatible with Berkeley DB. To build Tcl, you must also build with shared
libraries.
- --with-uniquename=NAME
- To build Berkeley DB with unique symbol names (in order to avoid conflicts
with other application modules or libraries), enter --with-uniquename=NAME,
replacing NAME with a string that to be appended to every Berkeley DB symbol.
If "=NAME" is not specified, a default value of "_MAJORMINOR" is used,
where MAJORMINOR is the major and minor release numbers of the Berkeley DB
release. See Building with
multiple versions of Berkeley DB for more information.
Copyright Sleepycat Software
@
1.1
log
@Initial revision
@
text
@d1 1
a1 1
@
1.1.1.1
log
@Import: RPM 4.0.3
@
text
@@
1.1.1.2
log
@Import: RPM 4.0.4
@
text
@d1 1
a1 1
d32 6
a37 7
--enable-debugTo build Berkeley DB with -g as a compiler flag and with
DEBUG #defined during compilation, enter --enable-debug as an
argument to configure. This will create a Berkeley DB library and utilities
with debugging symbols, as well as load various routines that can be
called from a debugger to display pages, cursor queues, and so forth.
If installed, the utilities will not be stripped. This option should
not be specified when configuring to build production binaries.
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d18 1
a18 1
There are several arguments you can specify when configuring Berkeley DB.
d20 4
a23 4
standard GNU autoconf arguments are available and supported. To see a
complete list of possible arguments, specify the --help flag to the
configure program.
The Berkeley DB specific arguments are as follows:
d37 1
a37 1
If installed, the utilities will not be stripped. This argument should
d40 1
a40 1
--enable-debug_rop as an argument to configure. This argument should not
d43 1
a43 1
--enable-debug_wop as an argument to configure. This argument should not
d48 2
a49 2
argument should not share database environments with applications built
without this argument. This argument should not be specified when
d83 7
a89 20
This is rarely necessary: POSIX mutexes will be selected automatically
on systems where they are the preferred implementation.
The --enable-posixmutexes configuration argument is normally used in
two ways: First, when there are multiple mutex implementations available
and the POSIX mutex implementation is not the preferred one (for
example, on Solaris where the LWP mutexes are used by default). Second,
by default the Berkeley DB library will only select the POSIX mutex
implementation if it supports mutexes shared between multiple processes,
as described for the pthread_condattr_setpshared and
pthread_mutexattr_setpshared interfaces. The --enable-posixmutexes
configuration argument can be used to force the selection of POSIX
mutexes in this case, which can improve application performance
significantly when the alternative mutex implementation is a
non-blocking one (for example test-and-set assembly instructions).
However, configuring to use POSIX mutexes when the implementation does
not have inter-process support will only allow the creation of private
database environments, that is, environments where the
DB_PRIVATE flag is specified to the DB_ENV->open method.
Specifying the --enable-posixmutexes configuration argument may require
that Berkeley DB be linked with the -lpthread library.
d92 1
a92 1
as an argument to configure. The --enable-rpc argument requires that RPC
d100 2
a101 2
configure using the --disable-shared argument. To not build static
libraries, configure using the --disable-static argument.
d104 1
a104 1
configure. This configuration argument expects to find Tcl's tclConfig.sh
d106 1
a106 1
argument for instructions on specifying a non-standard location for the
d114 1
a114 1
API. This argument should not be specified when configuring to build
d118 4
a121 8
configure. This is rarely necessary: UI mutexes will be selected
automatically on systems where they are the preferred implementation.
The --enable-uimutexes configuration argument is normally used when
there are multiple mutex implementations available and the UI mutex
implementation is not the preferred one (for example, on Solaris where
the LWP mutexes are used by default).
Specifying the --enable-uimutexes configuration argument may require
that Berkeley DB be linked with the -lthread library.
d125 3
a127 3
written to disk. Specify the --enable-umrw argument during
configuration to mask these errors. This argument should not be
specified when configuring to build production binaries.
d131 1
a131 1
used. This configuration argument creates an Embedix Component Descriptor
d133 1
a133 9
the --with-rpm argument.
--with-mutex=MUTEXTo force Berkeley DB to use a specific mutex implementation, configure with
--with-mutex=MUTEX, where MUTEX is the mutex implementation you want.
For example, --with-mutex=x86/gcc-assembly will configure Berkeley DB to use
the x86 GNU gcc compiler based test-and-set assembly mutexes. This is
rarely necessary and should be done only when the default configuration
selects the wrong mutex implementation. A list of available mutex
implementations can be found in the distribution file
dist/aclocal/mutex.ac.
d136 1
a136 1
distribution may be found. This configuration argument will create an
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2
d4 1
d19 1
a19 1
There are several options that you can specify when configuring Berkeley DB.
d21 4
a24 4
standard GNU autoconf options are available and supported. To see a
complete list of the options, specify the --help flag to the configure
program.
The Berkeley DB specific options are as follows:
d38 1
a38 1
If installed, the utilities will not be stripped. This option should
d41 1
a41 1
--enable-debug_rop as an argument to configure. This option should not
d44 1
a44 1
--enable-debug_wop as an argument to configure. This option should not
d49 2
a50 2
option should not share database environments with applications built
without this option. This option should not be specified when
d84 20
a103 7
The Berkeley DB library requires that the POSIX pthread implementation support
mutexes shared between multiple processes, as described for the
pthread_condattr_setpshared and pthread_mutexattr_setpshared interfaces.
In addition, this configuration option requires that Berkeley DB be linked
with the -lpthread library. On systems where POSIX mutexes are the
preferred mutex support (for example, HP-UX), they will be selected
automatically.
d106 1
a106 1
as an argument to configure. The --enable-rpc option requires that RPC
d114 2
a115 2
configure using the --disable-shared option. To not build static
libraries, configure using the --disable-static option.
d118 1
a118 1
configure. This configuration option expects to find Tcl's tclConfig.sh
d120 1
a120 1
option for instructions on specifying a non-standard location for the
d128 1
a128 1
API. This option should not be specified when configuring to build
d132 8
a139 4
configure. This configuration option requires that Berkeley DB be linked with
the -lthread library. On systems where UI mutexes are the preferred
mutex support, (for example, SCO's UnixWare 2), they will be selected
automatically.
d143 3
a145 3
written to disk. Specify the --enable-umrw option during configuration
to mask these errors. This option should not be specified when
configuring to build production binaries.
d149 1
a149 1
used. This configuration option creates an Embedix Component Descriptor
d151 9
a159 1
the --with-rpm option.
d162 1
a162 1
distribution may be found. This configuration option will create an
@
1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d1 2
a2 2
a3 1
d18 1
a18 1
There are several arguments you can specify when configuring Berkeley DB.
d20 4
a23 4
standard GNU autoconf arguments are available and supported. To see a
complete list of possible arguments, specify the --help flag to the
configure program.
The Berkeley DB specific arguments are as follows:
d37 1
a37 1
If installed, the utilities will not be stripped. This argument should
d40 1
a40 1
--enable-debug_rop as an argument to configure. This argument should not
d43 1
a43 1
--enable-debug_wop as an argument to configure. This argument should not
d48 2
a49 2
argument should not share database environments with applications built
without this argument. This argument should not be specified when
d83 7
a89 20
This is rarely necessary: POSIX mutexes will be selected automatically
on systems where they are the preferred implementation.
The --enable-posixmutexes configuration argument is normally used in
two ways: First, when there are multiple mutex implementations available
and the POSIX mutex implementation is not the preferred one (for
example, on Solaris where the LWP mutexes are used by default). Second,
by default the Berkeley DB library will only select the POSIX mutex
implementation if it supports mutexes shared between multiple processes,
as described for the pthread_condattr_setpshared and
pthread_mutexattr_setpshared interfaces. The --enable-posixmutexes
configuration argument can be used to force the selection of POSIX
mutexes in this case, which can improve application performance
significantly when the alternative mutex implementation is a
non-blocking one (for example test-and-set assembly instructions).
However, configuring to use POSIX mutexes when the implementation does
not have inter-process support will only allow the creation of private
database environments, that is, environments where the
DB_PRIVATE flag is specified to the DB_ENV->open method.
Specifying the --enable-posixmutexes configuration argument may require
that Berkeley DB be linked with the -lpthread library.
d92 1
a92 1
as an argument to configure. The --enable-rpc argument requires that RPC
d100 2
a101 2
configure using the --disable-shared argument. To not build static
libraries, configure using the --disable-static argument.
d104 1
a104 1
configure. This configuration argument expects to find Tcl's tclConfig.sh
d106 1
a106 1
argument for instructions on specifying a non-standard location for the
d114 1
a114 1
API. This argument should not be specified when configuring to build
d118 4
a121 8
configure. This is rarely necessary: UI mutexes will be selected
automatically on systems where they are the preferred implementation.
The --enable-uimutexes configuration argument is normally used when
there are multiple mutex implementations available and the UI mutex
implementation is not the preferred one (for example, on Solaris where
the LWP mutexes are used by default).
Specifying the --enable-uimutexes configuration argument may require
that Berkeley DB be linked with the -lthread library.
d125 3
a127 3
written to disk. Specify the --enable-umrw argument during
configuration to mask these errors. This argument should not be
specified when configuring to build production binaries.
d131 1
a131 1
used. This configuration argument creates an Embedix Component Descriptor
d133 1
a133 9
the --with-rpm argument.
--with-mutex=MUTEXTo force Berkeley DB to use a specific mutex implementation, configure with
--with-mutex=MUTEX, where MUTEX is the mutex implementation you want.
For example, --with-mutex=x86/gcc-assembly will configure Berkeley DB to use
the x86 GNU gcc compiler based test-and-set assembly mutexes. This is
rarely necessary and should be done only when the default configuration
selects the wrong mutex implementation. A list of available mutex
implementations can be found in the distribution file
dist/aclocal/mutex.ac.
d136 1
a136 1
distribution may be found. This configuration argument will create an
@