#--------------------------------------------------------- # # $Id: README,v 1.9 1997/08/23 06:10:55 mergl Exp $ # # Portions Copyright (c) 1994,1995,1996,1997 Tim Bunce # Portions Copyright (c) 1997 Edmund Mergl # #--------------------------------------------------------- DESCRIPTION: ------------ This is version 0.61 of DBD-Pg. DBD-Pg is a PostgreSQL interface for Perl 5 using DBI. For further information about DBI look at: http://www.fugue.com/dbi/ COPYRIGHT: ---------- You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file. IF YOU HAVE PROBLEMS: --------------------- Please send comments and bug-reports to Please include the output of perl -v, and perl -V, the version of PostgreSQL, the version of DBD-Pg, and the version of DBI in your bug-report. REQUIREMENTS: ------------- - build, test and install Perl 5 (at least 5.002) - build, test and install the DBI module (at least 0.89) - build, test and install PostgreSQL (at least 6.1.1) PLATFORMS: ---------- This release of DBD-Pg has been developed using Linux 2.0 with dynamic loading for the perl extensions. Let me know, if there are any problems with other platforms. INSTALLATION: ------------- The Makefile checks the environment variable POSTGRES_HOME as well some standard locations, to find the root directory of your Postgres installation. 1. perl Makefile.PL 2. make 3. make test 4. make install ( 1. to 3. as normal user, not as root ! ) TESTING: -------- Run 'make test'. Note, that the user running this script must have been created with the access rights to create databases *AND* users ! Do not run this script as root ! If you are using the shared library libpq.so, make sure, your dynamic loader is able to find libpq.so. With Linux the command /sbin/ldconfig -v should tell you, where it finds libpq.so. If not, you need to add an appropriate entry to /etc/ld.so.conf or to the environment variable LD_LIBRARY_PATH. Some linux distributions have an incomplete perl installation. If you have compile errors like "XS_VERSION_BOOTCHECK undeclared", make a 'find /usr/lib/perl5 -name XSUB.h -print' If this file is not present, you need to recompile and reinstall perl. SGI users: if you get segmentation faults make sure, you use the malloc which comes with perl when compiling perl (the default is not to). "David R. Noble" --------------------------------------------------------------------------- Edmund Mergl August 20, 1997 ---------------------------------------------------------------------------