1997-04-29 21:37:10 +02:00
|
|
|
#-------------------------------------------------------
|
|
|
|
#
|
1998-09-27 21:12:35 +02:00
|
|
|
# $Id: README,v 1.8 1998/09/27 19:12:24 mergl Exp $
|
1997-04-29 21:37:10 +02:00
|
|
|
#
|
1998-06-01 18:41:27 +02:00
|
|
|
# Copyright (c) 1997, 1998 Edmund Mergl
|
1997-04-29 21:37:10 +02:00
|
|
|
#
|
|
|
|
#-------------------------------------------------------
|
|
|
|
|
|
|
|
DESCRIPTION:
|
|
|
|
------------
|
|
|
|
|
1998-09-27 21:12:35 +02:00
|
|
|
This is version 1.8.0 of pgsql_perl5 (previously called pg95perl5).
|
1997-04-29 21:37:10 +02:00
|
|
|
|
1997-09-17 22:46:29 +02:00
|
|
|
Pgsql_perl5 is an interface between Larry Wall's language perl version 5 and
|
|
|
|
the database PostgreSQL (previously Postgres95). This has been done by using
|
|
|
|
the Perl5 application programming interface for C extensions which calls the
|
|
|
|
Postgres programmer's interface LIBPQ. Pgsql_perl5 tries to implement the LIBPQ-
|
|
|
|
interface as close as possible.
|
1997-04-29 21:37:10 +02:00
|
|
|
|
1997-09-17 22:46:29 +02:00
|
|
|
You have the choice between two different interfaces: the old C-style like
|
1997-04-29 21:37:10 +02:00
|
|
|
interface and a new one, using a more Perl-ish like style. The old style
|
|
|
|
has the benefit, that existing Libpq applications can easily be ported to
|
|
|
|
perl. The new style uses class packages and might be more familiar for C++-
|
1997-09-17 22:46:29 +02:00
|
|
|
programmers.
|
1997-04-29 21:37:10 +02:00
|
|
|
|
1998-09-27 21:12:35 +02:00
|
|
|
NOTE: it is planned to drop the old C-style interface in the next major release
|
|
|
|
of PostgreSQL.
|
|
|
|
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
|
1997-06-02 21:42:14 +02:00
|
|
|
COPYRIGHT:
|
|
|
|
----------
|
|
|
|
|
1997-09-17 22:46:29 +02:00
|
|
|
You may distribute under the terms of either the GNU General Public
|
|
|
|
License or the Artistic License, as specified in the Perl README file.
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
IF YOU HAVE PROBLEMS:
|
|
|
|
---------------------
|
|
|
|
|
1998-09-27 21:12:35 +02:00
|
|
|
Please send comments and bug-reports to <pgsql-interfaces@postgresql.org>
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
Please include the output of perl -v,
|
|
|
|
and perl -V,
|
|
|
|
the version of PostgreSQL,
|
|
|
|
and the version of pgsql_perl5
|
|
|
|
in your bug-report.
|
|
|
|
|
|
|
|
|
|
|
|
REQUIREMENTS:
|
|
|
|
-------------
|
|
|
|
|
1998-09-27 21:12:35 +02:00
|
|
|
- build, test and install Perl5 (at least 5.002)
|
|
|
|
- build, test and install PostgreSQL (at least 6.4)
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
|
|
|
|
PLATFORMS:
|
|
|
|
----------
|
|
|
|
|
|
|
|
This release of pgsql_perl5 has been developed using Linux 2.0 with
|
|
|
|
dynamic loading for the perl extensions. Let me know, if there are
|
1997-09-17 22:46:29 +02:00
|
|
|
any problems with other platforms.
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
|
|
|
|
INSTALLATION:
|
|
|
|
-------------
|
|
|
|
|
1998-06-01 18:41:27 +02:00
|
|
|
Since the perl5 interface is always contained in the source tree of PostgreSQL,
|
|
|
|
it is usually build together with PostgreSQL itself. This can be obtained by
|
|
|
|
adding the option '--with-perl' to the configure command.
|
|
|
|
|
|
|
|
In case you need to build the perl interface stand alone, you need to set the
|
|
|
|
environment variable POSTGRES_HOME, pointing to the PostgreSQL home-directory.
|
|
|
|
Also PostgreSQL needs to be installed having the include files in
|
|
|
|
$POSTGRES_HOME/include and the libs in $POSTGRES_HOME/lib. Then you have to
|
|
|
|
build the module as any standard perl-module with the following commands:
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
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'.
|
1997-09-17 22:46:29 +02:00
|
|
|
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 !
|
1997-04-29 21:37:10 +02:00
|
|
|
|
1998-02-20 22:25:47 +01:00
|
|
|
If testing fails with the message 'login failed', please check if access
|
|
|
|
to the database template1 as well as pgperltest is not protected via pg_hba.conf.
|
|
|
|
|
1997-09-25 23:15:04 +02:00
|
|
|
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:
|
|
|
|
Can't load './blib/arch/auto/Pg/Pg.so' for module Pg: File not found at
|
1997-04-29 21:37:10 +02:00
|
|
|
|
1997-09-17 22:46:29 +02:00
|
|
|
Some linux distributions have an incomplete perl installation.
|
|
|
|
If you have compile errors like "XS_VERSION_BOOTCHECK undeclared", make a
|
1997-09-25 23:15:04 +02:00
|
|
|
'find .../lib/perl5 -name XSUB.h -print'
|
1997-09-17 22:46:29 +02:00
|
|
|
If this file is not present, you need to recompile and reinstall perl.
|
1997-04-29 21:37:10 +02:00
|
|
|
|
1998-02-20 22:25:47 +01:00
|
|
|
Also RedHat 5.0 seems to have an incomplete perl-installation: if
|
|
|
|
you get error message during the installation complaining about a
|
|
|
|
missing perllocal.pod, 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" <drnoble@engsci.sandia.gov>
|
|
|
|
|
|
|
|
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 <danla@dimensional.com>
|
|
|
|
|
|
|
|
|
1997-06-02 21:42:14 +02:00
|
|
|
DOCUMENTATION:
|
|
|
|
--------------
|
|
|
|
|
|
|
|
Detailed documentation can be found in Pg.pm. Use 'perldoc Pg' after
|
|
|
|
installation to read the documentation.
|
|
|
|
|
|
|
|
|
1997-04-29 21:37:10 +02:00
|
|
|
---------------------------------------------------------------------------
|
|
|
|
|
1998-09-27 21:12:35 +02:00
|
|
|
Edmund Mergl <E.Mergl@bawue.de> September 27, 1998
|
1997-04-29 21:37:10 +02:00
|
|
|
|
|
|
|
---------------------------------------------------------------------------
|