X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=install%2F5.005%2FDBD-Pg-1.22-fixvercmp%2FREADME;fp=install%2F5.005%2FDBD-Pg-1.22-fixvercmp%2FREADME;h=7edebde9a8fe1a88aa2f87a33b609ef391d9c355;hp=0000000000000000000000000000000000000000;hb=ee146c3eada3bdb419ba471dd6df5e889d7dd7e5;hpb=c29fa7acc16efcc86af06077e739fca8b783c3c1 diff --git a/install/5.005/DBD-Pg-1.22-fixvercmp/README b/install/5.005/DBD-Pg-1.22-fixvercmp/README new file mode 100644 index 000000000..7edebde9a --- /dev/null +++ b/install/5.005/DBD-Pg-1.22-fixvercmp/README @@ -0,0 +1,166 @@ + +DBD::Pg -- the DBI PostgreSQL interface for Perl + +# $Id: README,v 1.1 2004-04-29 09:21:28 ivan Exp $ + +DESCRIPTION: +------------ + +This is version 1.21 of DBD-Pg. The web site for this interface is at: + + http://gborg.postgresql.org/project/dbdpg/projdisplay.php + +For further information about DBI look at: + + http://dbi.perl.org/ + +For information about PostgreSQL, visit: + + http://www.postgresql.org/ + +COPYRIGHT: +---------- + + Portions Copyright (c) 1994,1995,1996,1997 Tim Bunce + Copyright (c) 1997,1998,1999,2000 Edmund Mergl + Copyright (c) 2002 Jeffrey W. Baker + Copyright (c) 2002 PostgreSQL Global Development Group + +You may distribute under the terms of either the GNU General Public +License or the Artistic License, as specified in the Perl README file. + + +HOW TO GET THE LATEST VERSION: +------------------------------ + +Use the following URL to look for new versions of this module: + + http://gborg.postgresql.org/project/dbdpg/projdisplay.php + +or + + http://www.perl.com/CPAN/modules/by-module/DBD/ + +Note, that this request will be redirected automatically to the +nearest CPAN site. + + +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, the version of DBI, and details about your platform +in your bug-report. + + +REQUIREMENTS: +------------- + + build, test, and install Perl 5 (at least 5.005) + build, test, and install the DBI module (at least 1.30) + build, test, and install PostgreSQL (at least 7.3) + build, test, and install Test::Simple (at least 0.17) + +INSTALLATION: +------------- + +By default Makefile.PL uses App:Info to find the location of the +PostgreSQL library and include directories. However, if you want to +control it yourself, define the environment variables POSTGRES_INCLUDE +and POSTGRES_LIB, or POSTGRES_HOME. + + 1. perl Makefile.PL + 2. make + 3. make test + 4. make install + +Do steps 1 to 3 as normal user, not as root! + + +TESTING: +-------- + +The tests are designed to connect to a live database. The following +environment variables must be set for the tests to run: + + DBI_DSN=dbi:Pg:dbname= + DBI_USER= + DBI_PASS= + +If you are using the shared library libpq.so check if your dynamic +loader finds libpq.so. With Linux the command /sbin/ldconfig -v should +tell you, where it finds libpq.so. If ldconfig does not find libpq.so, +either add an appropriate entry to /etc/ld.so.conf and re-run ldconfig +or add the path to the environment variable LD_LIBRARY_PATH. + +A typical error message resulting from not finding libpq.so is: + + install_driver(Pg) failed: Can't load './blib/arch/auto/DBD/Pg/Pg.so' + for module DBD::Pg: File not found at + +If you get an error message like: + + perl: error while loading shared libraries: + /usr/lib/perl5/site_perl/5.6.0/i386-linux/auto/DBD/Pg/Pg.so: undefined + symbol: PQconnectdb + +when you call DBI->connect, then your libpq.so was probably not seen at +build-time. This should have caused 'make test' to fail; did you really +run it and look at the output? Check the setting of POSTGRES_LIB and +recompile DBD-Pg. + +Some linux distributions have incomplete perl installations. If you have +compile errors like "XS_VERSION_BOOTCHECK undeclared", do: + + find .../lib/perl5 -name XSUB.h -print + +If this file is not present, you need to recompile and re-install 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" + +HP users: if you get error messages like: + + can't open shared library: .../lib/libpq.sl + No such file or directory + +when running the test script, try to replace the 'shared' option in the +LDDFLAGS with 'archive'. Dan Lauterbach + + +FreeBSD users: if you get during make test the error message: + + 'DBD driver has not implemented the AutoCommit attribute' + +recompile the DBI module and the DBD-Pg module and disable optimization. +This error message is due to the broken optimization in gcc-2.7.2.1. + +If you get compiler errors like: + In function `XS_DBD__Pg__dr_discon_all_' + `sv_yes' undeclared (first use in this function) + +It may be because there is a 'patchlevel.h' file from another package +(such as 'hdf') in your POSTGRES_INCLUDE dir. The presence of this file +prevents the compiler from finding the perl include file +'mach/CORE/patchlevel.h'. Do 'pg_config --includedir' to identify the +POSTGRES_INCLUDE dir. Rename patchlevel.h whilst you build DBD::Pg. + + +Sun Users: if you get compile errors like: + + /usr/include/string.h:57: parse error before `]' + +then you need to remove from pgsql/include/libpq-fe.h the define for +strerror, which clashes with the definition in the standard include +file. + +Win32 Users: Running DBD-Pg scripts on Win32 needs some configuration work +on the server side: + + o add a postgres user with the same name as the NT-User + (eg Administrator) + o make sure, that your pg_hba.conf on the server is configured, + such that a connection from another host will be accepted