aboutsummaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2012-01-18 14:53:33 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2012-01-18 14:53:33 +0200
commit984673f60f35f8e6f9a51afeaa8d66bd91e61f34 (patch)
tree82bef8b23db4c8110e296595ddc4dd5cbaebb837 /INSTALL
parent16054e2d129d7c5e956be7b33c29ae6c2ea5c962 (diff)
Add installation instructions
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL100
1 files changed, 99 insertions, 1 deletions
diff --git a/INSTALL b/INSTALL
index d8fc40d..bdc072a 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1 +1,99 @@
-@@ Complete INSTALL instructions \ No newline at end of file
+Prerequisites
+=============
+
+ - libodb http://www.codesynthesis.com/products/odb/
+ - libodbc (UNIX only) http://www.unixodbc.org/
+ - SQL Server Native Client http://msdn.microsoft.com/en-us/sqlserver/aa937733
+
+
+Building on UNIX
+================
+
+The following build instructions are for the Linux/UNIX/Mac OS X
+operating systems as well as for Cygwin and MinGW on Windows.
+
+The standard autotools-based build system is used on these platforms.
+After unpacking the source code archive, change to the libodb-mssql
+package directory (referred to as libodb-mssql/ from now on) and run
+the configure script:
+
+./configure
+
+To see the available configuration options run configure with --help:
+
+./configure --help
+
+The configure script expects the libodb and libodbc headers and
+libraries to be installed in a directory where the C++ compiler and
+linker will search for them by default (normally /usr and /usr/local).
+If these libraries are installed in other directories, you can use the
+CPPFLAGS and LDFLAGS configure variables to specify their locations,
+for example:
+
+./configure CPPFLAGS=-I/opt/libodb/include LDFLAGS=-L/opt/libodb/lib
+
+If libodb is not installed and you would like to use its build
+directory instead, you can use the --with-libodb configure option
+to specify its location, for example:
+
+./configure --with-libodb=/tmp/libodb
+
+As another example, the following configure command only builds shared
+libraries, uses the specified C++ compiler, and compiles with optimization
+and without debug information:
+
+./configure --disable-static CXX=g++-4.5 CXXFLAGS=-O3
+
+Once configuration is complete, run make to build libodb-mssql:
+
+make
+
+Once the build is completed successfully, you can install the libodb-mssql
+headers and libraries using the install target (you may need to do this
+step as root depending on the installation directory):
+
+make install
+
+
+Building on Windows
+===================
+
+The following build instructions are for Windows using Microsoft Visual
+Studio. If you would like to build libodb-mssql with GCC either using
+Cygwin or MinGW, refer to the "Building on UNIX" section above.
+
+The standard Visual Studio project and solution files are used on this
+platform. The provided project files expect the libodb header and import
+library directories to be in the VC++ Directories Include and Library
+search lists. See the INSTALL file in the libodb package directory for
+more information on how to setup the VC++ Directories.
+
+To build libodb-mssql, unpack the source code archive and open the
+libodb-mssql-vc<N>.sln file located in the libodb-mssql package
+directory (referred to as libodb-mssql\ from now on). Here <N> is the
+version of Visual Studio that you are using. Once the solution is open,
+select the desired build configuration (Debug or Release) and platform
+(Win32 or x64) and build the solution.
+
+The resulting 32-bit DLLs and import libraries are placed into the
+libodb-mssql\bin\ and libodb-mssql\lib\ directories, respectively.
+Similarly, the 64-bit DLLs and import libraries are placed into
+libodb-mssql\bin64\ and libodb-mssql\lib64\. The Release versions of
+the import libraries are named odb-mssql.lib and the Debug versions
+are named odb-mssql-d.lib.
+
+To configure Visual Studio to automatically locate the libodb-mssql
+headers, DLLs, and import libraries, add the following paths to your
+VC++ Directories:
+
+Win32:
+
+ Include: ...\libodb-mssql
+ Library: ...\libodb-mssql\lib
+ Executable: ...\libodb-mssql\bin
+
+x64:
+
+ Include: ...\libodb-mssql
+ Library: ...\libodb-mssql\lib64
+ Executable: ...\libodb-mssql\bin64