Debian Codegraph @

INSTALL

raw
1 Prerequisites
2 =============
3
4 - libodb http://www.codesynthesis.com/products/odb/
5 - Boost http://www.boost.org
6
7
8 Building on UNIX
9 ================
10
11 The following build instructions are for the Linux/UNIX/Mac OS X
12 operating systems as well as for Cygwin and MinGW on Windows.
13
14 The standard autotools-based build system is used on these platforms.
15 After unpacking the source code archive, change to the libodb-boost
16 package directory (referred to as libodb-boost/ from now on) and run
17 the configure script:
18
19 ./configure
20
21 To see the available configuration options run configure with --help:
22
23 ./configure --help
24
25 The configure script expects the libodb and Boost headers and libraries
26 to be installed in a directory where the C++ compiler and linker will
27 search for them by default (normally /usr and /usr/local). If these
28 libraries are installed in other directories, you can use the CPPFLAGS
29 and LDFLAGS configure variables to specify their locations, for example:
30
31 ./configure CPPFLAGS=-I/opt/libodb/include LDFLAGS=-L/opt/libodb/lib
32
33 If these libraries are not installed and you would like to use their
34 build directories instead, you can use the --with-libodb, and
35 --with-boost configure options to specify their locations, for example:
36
37 ./configure --with-boost=/tmp/boost
38
39 For the Boost build directory the configure script expects to find the
40 Boost libraries in the stage/lib/ subdirectory.
41
42 As another example, the following configure command only builds shared
43 libraries, uses the specified C++ compiler, and compiles with optimization
44 and without debug information:
45
46 ./configure --disable-static CXX=g++-4.5 CXXFLAGS=-O3
47
48 Once configuration is complete, run make to build libodb-boost:
49
50 make
51
52 Once the build is completed successfully, you can install the libodb-boost
53 headers and libraries using the install target (you may need to do this
54 step as root depending on the installation directory):
55
56 make install
57
58
59 Building on Windows
60 ===================
61
62 The following build instructions are for Windows using Microsoft Visual
63 Studio. If you would like to build libodb-boost with GCC either using
64 Cygwin or MinGW, refer to the "Building on UNIX" section above.
65
66 The standard Visual Studio project and solution files are used on this
67 platform. The provided project files expect the libodb and Boost header
68 and import library directories to be in the VC++ Directories Include and
69 Library search lists. For libodb, see the INSTALL file in the package
70 directory for more information on how to setup the VC++ Directories. For
71 Boost, refer to the Boost documentation.
72
73 To build libodb-boost, unpack the source code archive and open the
74 libodb-boost-vc<N>.sln file located in the libodb-boost package
75 directory (referred to as libodb-boost\ from now on). Here <N> is the
76 version of Visual Studio that you are using. Once the solution is open,
77 select the desired build configuration (Debug or Release) and platform
78 (Win32 or x64) and build the solution.
79
80 The resulting 32-bit DLLs and import libraries are placed into the
81 libodb-boost\bin\ and libodb-boost\lib\ directories, respectively.
82 Similarly, the 64-bit DLLs and import libraries are placed into
83 libodb-boost\bin64\ and libodb-boost\lib64\. The Release versions of
84 the import libraries are named odb-boost.lib and the Debug versions
85 are named odb-boost-d.lib.
86
87 To configure Visual Studio to automatically locate the libodb-boost
88 headers, DLLs, and import libraries, add the following paths to your
89 VC++ Directories:
90
91 Win32:
92
93 Include: ...\libodb-boost
94 Library: ...\libodb-boost\lib
95 Executable: ...\libodb-boost\bin
96
97 x64:
98
99 Include: ...\libodb-boost
100 Library: ...\libodb-boost\lib64
101 Executable: ...\libodb-boost\bin64