FreeTDS User Guide: A Guide to Installing, Configuring, and Running FreeTDS
Prev | Chapter 2. Build FreeTDS | Next

# OS-specific Issues

##

The FreeTDS ODBC driver compiles under

- VC++; `.dsw` and `.dsp` files are included in the `win32` directory.

- Dev-C++

- MingW

- gcc under cygwin.

- The Borland Builder 6.0 compiler is also reported to work, but requires some tweaking of the `#include` statements. We would apply any patches that make this work cleanly.

Threadsafe operation will not be enabled.

From the Department of Double Emulation: FreeTDS builds as a `.dll` under WINE and as a `.a` under Interix. See the mailing list archives (second half of 2003) for details.

## VMS®

FreeTDS will probably build and run on most versions of OpenVMS Alpha 7.0 and later with DEC/Compaq C 6.0 or later. Other prerequisites:

gunzip
vmstar
MMS or MMK

### Build Instructions

Decompress and unpack the source archive using gunzip and vmstar. If you are untarring on an ODS-5 disk, you should use the `/ODS2` or `-o` option to create universally VMS-friendly filenames; otherwise the build will fail to locate some files.

Set default to the top-level source directory and run the configuration script:

        $ @[.vms]configure

This creates a `descrip.mms` in the top-level source directory which you may execute by simply running MMS (if you have the Module Management System that is part of DECset) or MMK (a freeware MMS alternative available from www.madgoat.com).

Further information can be found in the `` in the source distribution.

## OS X®

As of this writing ($Date: 2006/03/12 01:31:16 $), the regular distribution compiles on OS X. Releases prior to 0.63 either did not compile or required patching.

### Alternative build procedure

On 11 March 2004, `<Dmitri Fedortchenko>` offered the following approach, using a local libtool. It is included here as a source of clues, in case you encounter trouble.

Installing with libtool 1.5.2

1. Install the latest libtool from GNU into `/usr/local`, so as not to interfere with the Apple-original.

2. Make sure `/usr/local/bin` is in your `PATH` and `/usr/local/lib` is in your `LIBRARY_PATH`.

3. Go to the FreeTDS source directory and generate the `Makefile`s

       		$ ./configure --disable-libiconv --disable-odbc

4. Overwrite FreeTDS's `libtool` with a symbolic link to your (better) one

       		[1]
       		$ ln -sf /usr/local/bin/libtool

5. To check that you've done everything correctly up to this point,

       		$ ./libtool --version

   libtool should report version 1.5.2 (or whatever version you downloaded, and not 1.4).

6. And finally, of course

       		$ make && make install

## AIX®

AIX® can induce linker indigestion. libtool doesn't always understand that a `.a` file can be a shared library. One solution is to build only static libraries with the `--disable-shared` configure option.

Another problem seems to be that the linker isn't asked to pull in all the requisite libraries. Cf. this helpful mailing list message.

## GNU/Linux distributions that use RPMs

You may find it convenient to make an RPM from the source distribution, in which case you'll be glad to know it is easily done:

    			$ rpmbuild -ta freetds-0.63RC9.tar.gz

### Notes

[1] | If you run configure again, you'll need to perform this step again, because libtool will have been regenerated in its fossilized state.

Prev | Home | Next
How to build: Configure and make | Up | Install FreeTDS