- <Chapter Id="install-win32">
- <Title>Installation on Win32</Title>
- <Abstract>
- <Para>
- Build and installation instructions for <ProductName>Postgres</ProductName>
- v6.4 client libraries on Win32.
- </Para>
- </Abstract>
- <Sect1>
- <Title>Building the libraries</Title>
- <Para>
- The makefiles included in <ProductName>Postgres</ProductName> are written
- for <ProductName>Microsoft Visual C++</ProductName>, and will probably
- not work with other systems. It should be possible to compile the libaries
- manually in other cases.
- </Para>
- <Para>
- To build the libraries, change directory into the <filename>src</filename>
- directory, and type the command
- <programlisting>
- nmake /f win32.mak
- </programlisting>
- This assumes that you have <ProductName>Visual C++</ProductName> in your
- path.
- </Para>
- <Para>
- The following files will be built:
- <ItemizedList Mark="bullet" Spacing="compact">
- <ListItem>
- <Para>
- <filename>interfaceslibpqReleaselibpq.dll</filename>
- - The dynamically linkable frontend library
- </Para>
- </ListItem>
- <ListItem>
- <Para>
- <filename>interfaceslibpqReleaselibpqdll.lib</filename>
- - Import library to link your program to libpq.dll
- </Para>
- </ListItem>
- <ListItem>
- <Para>
- <filename>interfaceslibpqReleaselibpq.lib</filename> - Static library version of the frontend library
- </Para>
- </ListItem>
- <ListItem>
- <Para>
- <filename>binpsqlReleasepsql.exe</filename> - The <ProductName>Postgresql</ProductName> interactive SQL monitor
- </Para>
- </ListItem>
- </ItemizedList>
- </Para>
- </Sect1>
- <Sect1>
- <Title>Installing the libraries</Title>
- <Para>
- The only part of the library to really be installed is the
- <filename>libpq.dll</filename> library. This file should in most cases
- be placed in the <filename>WINNTSYSTEM32</filename> directory (or in
- <filename>WINDOWSSYSTEM</filename> on a Windows 95/98 system). If this
- file is installed using a setup program, it should be installed with
- version checking using the VERSIONINFO resource included in the file,
- to ensure that a newer version of the library is not overwritten.
- </Para>
- <Para>
- If you plan to do development using libpq on this machine, you will have
- to add the <filename>srcinclude</filename> and
- <filename>srcinterfaceslibpq</filename> directories to the include
- path in your compilers settings.
- </Para>
- </Sect1>
- <Sect1>
- <Title>Using the libraries</Title>
- <Para>
- To use the libraries, you must add the <filename>libpqdll.lib</filename>
- file to your project (in Visual C++, just right-click on the project and
- chose to add it).
- </Para>
- <Para>
- Once this is done, it should be possible to use the library just as you
- would on a Unix platform.
- </Para>
- </Sect1>
- </Chapter>
- <!-- Keep this comment at the end of the file
- Local variables:
- mode: sgml
- sgml-omittag:t
- sgml-shorttag:t
- sgml-minimize-attributes:nil
- sgml-always-quote-attributes:t
- sgml-indent-step:1
- sgml-indent-data:t
- sgml-parent-document:nil
- sgml-default-dtd-file:"./reference.ced"
- sgml-exposed-tags:nil
- sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
- sgml-local-ecat-files:nil
- End:
- -->