README
上传用户:blenddy
上传日期:2007-01-07
资源大小:6495k
文件大小:5k
源码类别:

数据库系统

开发平台:

Unix_Linux

  1. #-------------------------------------------------------
  2. #
  3. # $Id: README,v 1.8 1998/09/27 19:12:24 mergl Exp $
  4. #
  5. # Copyright (c) 1997, 1998  Edmund Mergl
  6. #
  7. #-------------------------------------------------------
  8. DESCRIPTION:
  9. ------------
  10. This is version 1.8.0 of pgsql_perl5 (previously called pg95perl5).
  11. Pgsql_perl5 is an interface between Larry Wall's language perl version 5 and 
  12. the database PostgreSQL (previously Postgres95). This has been done by using 
  13. the Perl5 application programming interface for C extensions which calls the 
  14. Postgres programmer's interface LIBPQ. Pgsql_perl5 tries to implement the LIBPQ-
  15. interface as close as possible.
  16. You have the choice between two different interfaces: the old C-style like 
  17. interface and a new one, using a more Perl-ish like style. The old style 
  18. has the benefit, that existing Libpq applications can easily be ported to 
  19. perl. The new style uses class packages and might be more familiar for C++-
  20. programmers. 
  21. NOTE: it is planned to drop the old C-style interface in the next major release 
  22.       of PostgreSQL. 
  23. COPYRIGHT:
  24. ----------
  25. You may distribute under the terms of either the GNU General Public
  26. License or the Artistic License, as specified in the Perl README file.
  27. IF YOU HAVE PROBLEMS:
  28. ---------------------
  29. Please send comments and bug-reports to <pgsql-interfaces@postgresql.org>
  30. Please include the output of perl -v,
  31.                          and perl -V,
  32.            the version of PostgreSQL,
  33.            and the version of pgsql_perl5
  34. in your bug-report.
  35. REQUIREMENTS:
  36. -------------
  37.   - build, test and install Perl5          (at least 5.002)
  38.   - build, test and install PostgreSQL     (at least 6.4)
  39. PLATFORMS:
  40. ----------
  41.   This release of pgsql_perl5 has been developed using Linux 2.0 with 
  42.   dynamic loading for the perl extensions. Let me know, if there are 
  43.   any problems with other platforms. 
  44. INSTALLATION:
  45. -------------
  46. Since the perl5 interface is always contained in the source tree of PostgreSQL, 
  47. it is usually build together with PostgreSQL itself. This can be obtained by 
  48. adding the option '--with-perl' to the configure command. 
  49. In case you need to build the perl interface stand alone, you need to set the 
  50. environment variable POSTGRES_HOME, pointing to the PostgreSQL home-directory. 
  51. Also PostgreSQL needs to be installed having the include files in 
  52. $POSTGRES_HOME/include and the libs in $POSTGRES_HOME/lib. Then you have to 
  53. build the module as any standard perl-module with the following commands: 
  54. 1.   perl Makefile.PL
  55. 2.   make
  56. 3.   make test
  57. 4.   make install
  58. ( 1. to 3. as normal user, not as root ! )
  59. TESTING:
  60. --------
  61. Run 'make test'.
  62. Note, that the user running this script must have been created with the access 
  63. rights to create databases *AND* users ! Do not run this script as root ! 
  64. If testing fails with the message 'login failed', please check if access 
  65. to the database template1 as well as pgperltest is not protected via pg_hba.conf. 
  66. If you are using the shared library libpq.so check if your dynamic loader 
  67. finds libpq.so. With Linux the command /sbin/ldconfig -v should tell you, 
  68. where it finds libpq.so. If ldconfig does not find libpq.so, either add an 
  69. appropriate entry to /etc/ld.so.conf and re-run ldconfig or add the path to 
  70. the environment variable LD_LIBRARY_PATH. 
  71. A typical error message resulting from not finding libpq.so is: 
  72.   Can't load './blib/arch/auto/Pg/Pg.so' for module Pg: File not found at
  73. Some linux distributions have an incomplete perl installation. 
  74. If you have compile errors like "XS_VERSION_BOOTCHECK undeclared", make a 
  75.           'find .../lib/perl5 -name XSUB.h -print'
  76. If this file is not present, you need to recompile and reinstall perl. 
  77. Also RedHat 5.0 seems to have an incomplete perl-installation: if 
  78. you get error message during the installation complaining about a 
  79. missing perllocal.pod, you need to recompile and reinstall perl. 
  80. SGI users: if you get segmentation faults make sure, you use the malloc which 
  81.            comes with perl when compiling perl (the default is not to).
  82.            "David R. Noble" <drnoble@engsci.sandia.gov>
  83. HP users: if you get error messages like:
  84.               can't open shared library: .../lib/libpq.sl
  85.               No such file or directory
  86.           when running the test script, try to replace the
  87.           'shared' option in the LDDFLAGS with 'archive'.
  88.           Dan Lauterbach <danla@dimensional.com>
  89. DOCUMENTATION:
  90. --------------
  91. Detailed documentation can be found in Pg.pm. Use 'perldoc Pg' after 
  92. installation to read the documentation. 
  93. ---------------------------------------------------------------------------
  94.    Edmund Mergl <E.Mergl@bawue.de>                       September 27, 1998
  95. ---------------------------------------------------------------------------