Back to files

iODBC Driver Manager
Copyright (C) 1995 by Ke Jin <kejin@empress.com> Copyright (C) 1996-2006 by OpenLink Software <iodbc@openlinksw.com> All Rights Reserved.

Introduction

This document describes how to checkout a copy of the CVS tree for development purposes. It also lists the packages that need to be installed prior to generating the necessary scripts and Makefiles to build the project.

CVS access is only needed for developers who want to actively track progress of the iODBC source code and contribute bugfixes or enhancements to the project. It requires basic knowledge about the general layout of open source and GNU projects, the use of autoconf and automake etc, which is beyond the scope of this document. If you have any questions, please email us at <iodbc@openlinksw.com>.

CVS Archive Server Access

OpenLink currently provides read-only CVS Archive access throught the SourceForge.net servers:

$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/iodbc login

(The password is blank)

$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/iodbc co iodbc

Package Dependencies

To generate the configure script and all other build files necessary, please make sure the following packages and recommended versions are installed on your system.

        Package   Version  From
        ========  =======  ==================================
        autoconf  2.57     ftp://ftp.gnu.org/pub/gnu/autoconf
        automake  1.6.3    ftp://ftp.gnu.org/pub/gnu/automake
        libtool   1.4.3    ftp://ftp.gnu.org/pub/gnu/libtool
        gtk+      1.2.10   ftp://ftp.gtk.org/pub/gtk/v1.2

The above version are used for generating the source distributions with are currently generated on a standard RedHat 9 installation. Older version of these packages can sometimes be used, but could cause build problems.

To check the version number of the tools installed on your system, use one of the following commands:

$ autoconf --version
$ automake --version
$ libtoolize --version
$ gtk-config --version

Generate build files

To generate the configure script and all related build files, use one of the following commands:

$ autoreconf --install

or use the supplied script in your CVS checkout directory:

$ ./bootstrap.sh

If the above commands succeed without any error messages, please use the following command to check out all the options you can use:

$ ./configure --help

Certain build targets are only enabled when the --enable-maintainer-mode flag is added to configure.

Please read the files INSTALL and README in this directory for further information on how to configure the package and install it on your system.

Submitting fixes and enhancements

Patches and new contributions can be submitted as diffs from the current CVS archive by:

$ cvs add newfiles

$ cvs -z3 diff -uN > diffs

Patches and contributions can be send to the OpenLink iODBC source archive manager at <iodbc@openlinksw.com> to be included the next distribution. Please provide accompanying documentation on which bugs are fixed or new features are introduced.