<productname>Windows</productname>.

</para>

<para>

Finally, the client access library

(<application>libpq</application>) can be built using

<productname>Visual C++ 7.1</productname> or

<productname>Borland C++</productname> for compatibility with statically

linked applications built using these tools.

</para>

<para>

Building using <productname>MinGW</productname> or

<productname>Cygwin</productname> uses the normal build system, see

</sect2>

</sect1>

<sect1 id="install-windows-libpq">

<title>Building <application>libpq</application> with

<productname>Visual C++</productname> or

<productname>Borland C++</productname></title>

<para>

Using <productname>Visual C++ 7.1-9.0</productname> or

<productname>Borland C++</productname> to build libpq is only recommended

if you need a version with different debug/release flags, or if you need a

static library to link into an application. For normal use the

<productname>MinGW</productname> or

<productname>Visual Studio</productname> or

<productname>Windows SDK</productname> method is recommended.

</para>

<para>

To build the <application>libpq</application> client library using

<productname>Visual Studio 7.1 or later</productname>, change into the

<filename>src</filename> directory and type the command:

<screen>

<userinput>nmake /f win32.mak</userinput>

</screen>

</para>

<para>

To build a 64-bit version of the <application>libpq</application>

client library using <productname>Visual Studio 8.0 or

later</productname>, change into the <filename>src</filename>

directory and type in the command:

<screen>

<userinput>nmake /f win32.mak CPU=AMD64</userinput>

</screen>

See the <filename>win32.mak</filename> file for further details

about supported variables.

</para>

<para>

To build the <application>libpq</application> client library using

<productname>Borland C++</productname>, change into the

<filename>src</filename> directory and type the command:

<screen>

<userinput>make -N -DCFG=Release /f bcc32.mak</userinput>

</screen>

</para>

<sect2>

<title>Generated Files</title>

<para>

The following files will be built:

<variablelist>

<varlistentry>

<term><filename>interfaces\libpq\Release\libpq.dll</filename></term>

<listitem>

<para>

The dynamically linkable frontend library

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><filename>interfaces\libpq\Release\libpqdll.lib</filename></term>

<listitem>

<para>

Import library to link your programs to <filename>libpq.dll</filename>

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><filename>interfaces\libpq\Release\libpq.lib</filename></term>

<listitem>

<para>

Static version of the frontend library

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

<para>

Normally you do not need to install any of the client files. You should

place the <filename>libpq.dll</filename> file in the same directory

as your applications executable file. Do not install

<filename>libpq.dll</filename> into your <filename>Windows</>,

<filename>System</> or <filename>System32</> directory unless

absolutely necessary.

If this file is installed using a setup program, then it should

be installed with version checking using the

<symbol>VERSIONINFO</symbol> resource included in the file, to

ensure that a newer version of the library is not overwritten.

</para>

<para>

If you are planning to do development using <application>libpq</application>

on this machine, you will have to add the

<filename>src\include</filename> and

<filename>src\interfaces\libpq</filename> subdirectories of the source

tree to the include path in your compiler's settings.

</para>

<para>

To use the library, you must add the

<filename>libpqdll.lib</filename> file to your project. (In Visual

C++, just right-click on the project and choose to add it.)

</para>

</sect2>

</sect1>

</chapter>

# tarballs.

ifneq (,$(SHLIB_EXPORTS))

distprep: lib$(NAME)dll.def lib$(NAME)ddll.def blib$(NAME)dll.def

distprep: lib$(NAME)dll.def lib$(NAME)ddll.def

UC_NAME = $(shell echo $(NAME) | tr 'abcdefghijklmnopqrstuvwxyz' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ')

lib$(NAME)dll.def: $(SHLIB_EXPORTS)

echo '; DEF file forwin32.mak release build and forMakefile.shlib (MinGW)' >$@

echo '; DEF file for Makefile.shlib (MinGW)' >$@

echo 'LIBRARY LIB$(UC_NAME).dll' >>$@

echo 'EXPORTS' >>$@

sed -e '/^#/d' -e 's/^\(.*[ ]\)\([0-9][0-9]*\)/ \1@ \2/' $< >>$@

lib$(NAME)ddll.def: $(SHLIB_EXPORTS)

echo '; DEF file forwin32.mak debug build' >$@

echo '; DEF file forMakefile.shlib (MinGW)' >$@

echo 'LIBRARY LIB$(UC_NAME)D.dll' >>$@

echo 'EXPORTS' >>$@

sed -e '/^#/d' -e 's/^\(.*[ ]\)\([0-9][0-9]*\)/ \1@ \2/' $< >>$@

blib$(NAME)dll.def: $(SHLIB_EXPORTS)

echo '; DEF file for bcc32.mak (Borland C++ Builder)' >$@

echo 'LIBRARY BLIB$(UC_NAME)' >>$@

echo 'EXPORTS' >>$@

sed -e '/^#/d' -e 's/^\(.*[ ]\)\([0-9][0-9]*\)/ _\1@ \2/' $< >>$@

echo >>$@

echo '; Aliases for MS compatible names' >> $@

sed -e '/^#/d' -e 's/^\(.*[ ]\)\([0-9][0-9]*\)/ \1= _\1/' $< | sed 's/ *$$//' >>$@

endif # SHLIB_EXPORTS

ifneq (,$(SHLIB_EXPORTS))

maintainer-clean-lib:

rm -f lib$(NAME)dll.def lib$(NAME)ddll.def blib$(NAME)dll.def

rm -f lib$(NAME)dll.def lib$(NAME)ddll.def

endif

#undef mkdir

#defineWSA_NOT_ENOUGH_MEMORY(WSAENOBUFS)

#defineWSATYPE_NOT_FOUND(WSABASEERR+109)

#defineEAI_AGAINWSATRY_AGAIN

#defineEAI_BADFLAGSWSAEINVAL

#defineEAI_FAILWSANO_RECOVERY

externsize_tstrlcpy(char*dst,constchar*src,size_tsiz);

#if !defined(HAVE_RANDOM)&& !defined(__BORLANDC__)

#if !defined(HAVE_RANDOM)

externlongrandom(void);

#error "should be included via atomics.h"

#pragma intrinsic(_ReadWriteBarrier)

#definepg_compiler_barrier_impl()_ReadWriteBarrier()

#if defined(_MSC_VER)|| defined(__BORLANDC__)

#if defined(_MSC_VER)

#defineENABLE_SSPI 1

#undef mkdir

#undef near

#defineSIGTTIN21

#defineSIGTTOU22/* Same as SIGABRT -- no problem, I hope */

#defineSIGWINCH28

#defineSIGUSR130

#defineSIGUSR231

#defineputenv(x) pgwin32_putenv(x)

#defineunsetenv(x) pgwin32_unsetenv(x)

typedef__int64ssize_t;

typedefunsigned shortmode_t;

#defineS_IRUSR _S_IREAD

#defineS_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)

#defineS_ISREG(m) (((m) & S_IFMT) == S_IFREG)

#defineF_OK 0

#defineW_OK 2

#defineDLSUFFIX ".dll"

#defineINVALID_FILE_ATTRIBUTES ((DWORD) -1)

#defineO_RANDOM0x0010/* File access is primarily random */

#defineO_SEQUENTIAL0x0020/* File access is primarily sequential */

#defineO_TEMPORARY0x0040/* Temporary file bit */

#defineO_SHORT_LIVED0x1000/* Temporary storage file, try not to flush */

#define_O_SHORT_LIVEDO_SHORT_LIVED

#defineS_IRGRP 0

#defineS_IWGRP 0

#defineS_IXGRP 0

#defineS_IWOTH 0

#defineS_IXOTH 0

#defineS_IRWXO 0