head	1.9;
access;
symbols
	REL-09_01_0200:1.9
	REL-09_01_0100:1.9
	REL-09_00_0310:1.8
	REL-09_00_0300:1.8
	REL-09_00_0200:1.8
	REL-09_00_0101:1.8
	REL-09_00_0100:1.7
	REL-08_04_0200:1.5
	REL-08_04_0100:1.5
	REL-08_03_0400:1.4
	REL-08_03_0300:1.4
	REL-08_03_0200:1.4
	REL-08_03_0100:1.4
	REL-08_02_0500:1.4
	REL-08_02_0400:1.4
	REL-08_02_0300:1.4
	REL-08_02_0200:1.2
	REL-08_02_0100:1.2
	REL8_1_STABLE:1.2.0.2
	REL-08_01_0200:1.2
	REL-08_01_0102:1.2
	REL-08_01_0101:1.2
	REL-08_01_0100:1.2
	REL-08_01_0006:1.1
	REL-08_01_0005:1.1
	REL-08_01_0004:1.1;
locks; strict;
comment	@# @;


1.9
date	2011.12.29.10.15.58;	author h-saito;	state Exp;
branches;
next	1.8;

1.8
date	2010.10.14.13.45.16;	author h-saito;	state Exp;
branches;
next	1.7;

1.7
date	2010.08.28.00.01.59;	author h-saito;	state Exp;
branches;
next	1.6;

1.6
date	2010.05.29.13.42.07;	author h-saito;	state Exp;
branches;
next	1.5;

1.5
date	2009.04.08.13.50.37;	author h-saito;	state Exp;
branches;
next	1.4;

1.4
date	2007.04.09.14.00.14;	author h-saito;	state Exp;
branches;
next	1.3;

1.3
date	2007.04.09.13.53.42;	author h-saito;	state Exp;
branches;
next	1.2;

1.2
date	2005.11.03.22.07.17;	author dpage;	state Exp;
branches;
next	1.1;

1.1
date	2005.08.27.19.44.47;	author dpage;	state Exp;
branches;
next	;


desc
@@


1.9
log
@Prep release 09.01.0100.
@
text
@<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
    <title>Compiling psqlODBC on Windows</title>
  </head>

  <body bgcolor="#ffffff" text="#000000" link="#ff0000" vlink="#a00000" alink="#0000ff">
  
<h1>Compiling psqlODBC on Windows</h1>

<p>
This 
page describes how to build the PostgreSQL ODBC Driver on Win32 platforms. Microsoft Visual
C++ version 6.0 or Microsoft Visual C++ 2005 Edition. Other compilers may work 
but have not been formally tested. psqlODBC may be built either in the 
VC++ IDE or from the command line:
</p>

<h2>IDE Method</h2>

<p>A Microsoft Visual Studio project file (and workspace) is included in the source tree.
</p>

<p><strong>psqlodbc.dsp</strong>
 can be used with Microsoft Visual C++ 6.0.
</p>

<p><strong>psqlodbc.proj</strong> and 
<strong>psqlodbc.sln</strong>
can be used with Microsoft Visual C++ 2005 Edition (including the Express edition which can be downloaded free of charge from <a href="http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/default.aspx">http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/default.aspx</a>)
</p>

<p>
     Preparation before the build:
</p>
<ol>
  <li>The Windows distribution of PostgreSQL will install the required headers and libraries into C:\Program Files\PostgreSQL\9.1
  <li>OpenSSL should be installed into C:\OpenSSL (OpenSSL binaries can be downloaded from <a href="http://www.slproweb.com/products/Win32OpenSSL.html">http://www.slproweb.com/products/Win32OpenSSL.html</a>)
</li></ol>

<p>
       If you want to change the installation arrangement, it
is necessary to edit the project settings.
</p>

<p>
        Note:
</p>

<p>
The default build settings will create the following driver:
</p>

<ol>
<li>UNICODE support.
<li>libpq and SSL equipped are supported.
<li>Kerberos are supported peculiar by psqlODBC.
<li>ODBCVER is 0x0351. 
<li>The driver filename is "psqlodbc35w.dll".</li></ol>
               
<h2>Command Line Method</h2>
<p>
        Build&nbsp;method:
</p>
<ol>        
<li>Use NMAKE.exe to build the dll for the 32bit environment.<br><br>

    <code>C:\psqlodbc\&gt; nmake /f win32.mak CFG=Release ALL</code><br><br>

    Possible configurations are Release and Debug.<br>
    Possible build types are ALL or CLEAN. <br>&nbsp;</li>
<li>Use NMAKE.exe to build the dll for the 64bit environment.<br><br>

    <code>C:\psqlodbc\&gt; nmake /f win64.mak CFG=Release ALL</code><br><br>

    Possible configurations are Release and Debug.<br>
    Possible build types are ALL or CLEAN.</li></ol>        
  

<p>Note:</p>

<p>
The following build options may be used:
</p>        
  

<p>
<table cellspacing="0" cellpadding="3" width="780" border=1>
  
  <tr>
    <td>Valiable</td>
    <td>Values</td>
    </tr>
  <tr>
    <td>CFG</td>
    <td>Release(default), or Debug</td>
    </tr>
  <tr>
    <td>PG_INC</td>
    <td>$(PROGRAMFILES)\PostgreSQL\9.1\include</td>
    </tr>
  <tr>
    <td>PG_LIB</td>
    <td>$(PROGRAMFILES)\PostgreSQL\9.1\lib\ms</td>
    </tr>
  <tr>
    <td>SSL_INC</td>
    <td>C:\OpenSSL\include</td>
    </tr>
  <tr>
   <td>SSL_LIB</td>
   <td>C:\OpenSSL\lib\VC</td>
    </tr>
  <tr>
    <td>LINKMT</td>
    <td>MT</td>
  </tr>
  <tr>
    <td>ANSI_VERSION</td>
    <td>No (at the Yes, output dll name to psqlodbc30a.dll)</td>
  </tr>
  <tr>
    <td>MSDTC</td>
    <td>Yes (but VC++ 6.0 default is no)</td>
  </tr>
  <tr>
    <td>USE_LIBPQ</td>
    <td>No (libpq is required) </td>
  </tr>
  <tr>
    <td>USE_SSPI</td>
    <td>Yes (secur32 and crypt32 is required) </td>
  </tr>
  <tr>
    <td>USE_GSS</td>
    <td>Yes (use gssapi required, this option is effective at 64bit now) </td>
  </tr>
  </table></p>        

<ol>
<li>UNICODE is default (psqlodbc35w.dll), unless ANSI_VERSION isselected (psqlodbc30a.dll)</li>
<li>libpq.dll is used supported.</li>
<li>SSL and Kerberos are original equipment.</li>
<li>ODBCVER becomes 0x351 when UNICODE is selected, or becomes 0x0300 with ANSI_VERSION == Yes.</li>
<li>If MSDTC == Yes, "pgxalib.dll" is created.</li>
<li>In the MSDTC mode, ANSI_VERSION also creates "pgenlista.dll". or UNICODE creates "pgenlist.dll".</li>
</ol>.
</body>
</html>
@


1.8
log
@Some specification changes.
@
text
@d38 1
a38 1
  <li>The Windows distribution of PostgreSQL will install the required headers and libraries into C:\Program Files\PostgreSQL\9.0
d57 2
a58 1
<li>libpq.dll is used, therefore, SSL and Kerberos are supported.
d101 1
a101 1
    <td>$(PROGRAMFILES)\PostgreSQL\9.0\include</td>
d105 1
a105 1
    <td>$(PROGRAMFILES)\PostgreSQL\9.0\lib\ms</td>
@


1.7
log
@Prep release Version 09.00.0100.
@
text
@d128 9
a136 1
    <td>Yes (libpq is required) </td>
d142 2
a143 1
<li>libpq.dll is used, therefore, SSL and Kerberos are supported.</li>
@


1.6
log
@USE_LIBPQ option forgotten.
@
text
@d38 1
a38 1
  <li>The Windows distribution of PostgreSQL will install the required headers and libraries into C:\Program Files\PostgreSQL\8.4
d100 1
a100 1
    <td>$(PROGRAMFILES)\PostgreSQL\8.4\include</td>
d104 1
a104 1
    <td>$(PROGRAMFILES)\PostgreSQL\8.4\lib\ms</td>
@


1.5
log
@Prep 08.04.0100. adjustment.
@
text
@d126 4
@


1.4
log
@Oops, Fixed mistake of tag
@
text
@d38 1
a38 1
  <li>The Windows distribution of PostgreSQL will install the required headers and libraries into C:\Program Files\PostgreSQL\8.2
d100 1
a100 1
    <td>$(PROGRAMFILES)\PostgreSQL\8.2\include</td>
d104 1
a104 1
    <td>$(PROGRAMFILES)\PostgreSQL\8.2\lib\ms</td>
@


1.3
log
@Addition and correction.
with Dave:-)
@
text
@d132 1
a132 1
<li>If MSDTC == Yes, "pgxalib.dll" is created./li>
@


1.2
log
@Add a VC++ project file.
@
text
@d1 136
a136 48
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
    <title>Compiling psqlODBC on Windows</title>
  </HEAD>

  <body bgcolor="#ffffff" text="#000000" link="#ff0000" vlink="#a00000" alink="#0000ff">
  
<h1>Compiling psqlODBC on Windows</h1>

<p>
This page describes how to build the PostgreSQL ODBC Driver (psqlodbc.dll) on Win32 platforms.
Microsoft Visual C++ version 6.0 or higher is required. Other compilers may work 
but have not been formally tested. The psqlodbc.dll may be built either in the 
VC++ IDE or from the command line:
</p>

<h2>IDE Method</h2>

<p>
A Microsoft Visual C++ 6.0 project file (and workspace) is included in the source tree. Simply
load the project, and build whichever configurations you prefer.

</p>

<h2>Command Line Method</h2>

<p>

<ol>
<li>From a command prompt, run the vcvars32.bat file that comes with Visual C++. This will
setup the environment for using the VC++ compiler.</li>

<li>CD to the directory containing the source code.</li>

<li>Use NMAKE to build the dll eg:<br><br>

    <code>C:\psqlodbc\> nmake /f win32.mak CFG=Release ALL</code><br><br>

    Possible configurations are Release and Debug.<br>
    Possible build types are ALL or CLEAN.</li>
</ol>

</p>

</body>
</html>
@


1.1
log
@Move docs into the source tree.
@
text
@d14 1
a14 1
Microsoft Visual C++ version 4.0 or higher is required. Other compilers may work 
d21 3
a23 31
<ol>
<li>Create a new project workspace with the type DLL.  For the name, type in the
    name "psqlodbc".</li>

<li>The above step creates the directory "psqlodbc" under the 
    "\\&lt;Visual C++ top level directory&gt;\\projects" path to hold the source files.
    (example, \\msdev\\projects\\psqlodbc).  Now, either unzip the source code release
    into this directory or just copy all the files into this directory.</li>

<li>Insert all of the source files (*.c, *.h, *.rc, *.def) into the Visual project
    using the "Insert files into project" command.  You may have to do 2 inserts --
    the first to get the 'c' and header files, and the second to get the def file.
    Note, that from 07.01.0009, the file md5.c should <b>not</b> included in the project,
    this file is only used under *nix - the file win_md5.c is used instead in Win32.
    The file md5.h <b>is</b> required.
    Don't forget the .def file since it is an important part of the release.
    You can even insert ".txt" files into the projects -- they will do nothing.</li>
	
<li>Add the "wsock32.lib" library to the end of the list of libraries for linking
    using the Build settings menu.</li>
	
<li>Select the type of build on the toolbar (i.e., Release or Debug).  This is
    one of the useful features of the visual c++ environment in that you can
    browse the entire project if you build the "Debug" release.  For release
    purposes however, select "Release" build.</li>

<li>Build the dll by selecting Build from the build menu.</li>

<li>When complete, the "psqlodbc.dll" file is under the "Release" subdirectory.
    (i.e., "\\msdev\\projects\\psqlodbc\\release\\psqlodbc.dll")</li>
</ol>
d39 1
a39 1
    <code>C:\\psqlodbc\\> nmake /f win32.mak CFG=Release ALL</code><br><br>
d48 1
a48 1
</html>@

