~ubuntu-branches/ubuntu/gutsy/psqlodbc/gutsy

« back to all changes in this revision

Viewing changes to README.unix

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2004-05-13 10:47:36 UTC
  • Revision ID: james.westby@ubuntu.com-20040513104736-a530gmn0p3knep89
Tags: upstream-07.03.0200
ImportĀ upstreamĀ versionĀ 07.03.0200

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
psqlODBC README for *nix Systems
 
2
================================
 
3
 
 
4
Since psqlODBC has be moved from the main PostgreSQL source tree, we have yet
 
5
to create a new build system for the driver. Peter Eisentraut was kind enough
 
6
provide a build environment for us which is now included in psqlODBC tarballs.
 
7
 
 
8
Installation
 
9
============
 
10
 
 
11
To install, just  try something like:
 
12
 
 
13
% tar -zxvf psqlodbc-7.2.3.tar.gz
 
14
% cd postgresql-7.2.3
 
15
% ./configure
 
16
% make
 
17
% make install
 
18
 
 
19
The configure script will accept the following useful options:
 
20
 
 
21
--with-iodbc
 
22
--with-unixodbc
 
23
--with-odbcinst=DIR
 
24
--enable-pthreads (thread-safe driver on some platforms)
 
25
--help
 
26
 
 
27
Building a distribution
 
28
=======================
 
29
 
 
30
The following text is Peter's instructions for using the build environment and
 
31
is only relevant to psqlODBC developers.
 
32
 
 
33
From: Peter Eisentraut [peter_e@gmx.net]
 
34
Sent: 07 October 2002 20:24
 
35
To: pgsql-odbc@postgresql.org
 
36
Subject: [ODBC] Unix build
 
37
 
 
38
I managed to find a Libtool version that works, so here's the
 
39
independent build infrastructure for ODBC on Unix.
 
40
 
 
41
The patch also removes all the non-multibyte code.  This goes together
 
42
with the build system change, because there no longer is a way to turn
 
43
on multibyte explicitly.  You should make the required changes to the
 
44
Windows build files.
 
45
 
 
46
The following files need to be checked into CVS: configure.ac and
 
47
Makefile.am.  GNUmakefile can be removed.  I recommend that you do not
 
48
check in all the files generated by auto* (see below).  It can get
 
49
pretty messy to keep track of them.
 
50
 
 
51
* Prerequisites
 
52
 
 
53
Autoconf 2.52 or higher
 
54
Automake 1.6.* (Lower versions are rejected, version 1.7 untested.)
 
55
Libtool 1.4.2a (CVS from stable branch, maybe 1.4.2 works as well)
 
56
PostgreSQL source tree (7.3 branch)
 
57
 
 
58
* Bootstrapping
 
59
 
 
60
First, copy libtool.m4 into source directory.  Be sure to pick the one
 
61
from the right Libtool version.  Then run
 
62
 
 
63
aclocal -I . -I $PGSRC/config
 
64
libtoolize --force --copy
 
65
autoconf
 
66
autoheader
 
67
automake --add-missing --copy
 
68
 
 
69
You can run 'make maintainer-clean' to remove all the files this generates.
 
70
 
 
71
* Building
 
72
 
 
73
./configure
 
74
make
 
75
make install
 
76
 
 
77
configure has the same options that the PostgreSQL configure used to
 
78
have for ODBC, namely --with-iodbc, --with-unixodbc, and
 
79
--with-odbcinst=DIR.
 
80
 
 
81
* Version Number
 
82
 
 
83
The previous build infrastructure set a shared library version number
 
84
of 0.27.  I've used this as a package version number, but it does not
 
85
correspond to version.h in any way.  This needs to be thought out.
 
86
 
 
87
* Making a Source Distribution
 
88
 
 
89
'make dist' makes a file psqlodbc-0.27.tar.gz.  It's even better to
 
90
use 'make distcheck', which runs a number of tests to see if the
 
91
distribution is internally consistent.
 
92
 
 
93
The distribution does not contain any Windows-specific files (*.def,
 
94
maybe others).  If it is desired to include them, edit Makefile.am.
 
95