README
上传用户:romrleung
上传日期:2022-05-23
资源大小:18897k
文件大小:17k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1.                                      DB_File
  2.                                   Version 1.805
  3.                                   1st Sep 2002
  4.   Copyright (c) 1995-2002 Paul Marquess. All rights reserved. This
  5. program is free software; you can redistribute it and/or modify
  6. it under the same terms as Perl itself.
  7. IMPORTANT NOTICE
  8. ================
  9. If are using the locking technique described in older versions of
  10. DB_File, please read the section called "Locking: The Trouble with fd"
  11. in DB_File.pm immediately. The locking method has been found to be
  12. unsafe. You risk corrupting your data if you continue to use it.
  13. DESCRIPTION
  14. -----------
  15. DB_File is a module which allows Perl programs to make use of the
  16. facilities provided by Berkeley DB version 1. (DB_File can be built
  17. version 2, 3 or 4 of Berkeley DB, but it will only support the 1.x
  18. features),
  19. If you want to make use of the new features available in Berkeley DB
  20. 2.x, 3.x or 4.x, use the Perl module BerkeleyDB instead.
  21. Berkeley DB is a C library which provides a consistent interface to a
  22. number of database formats. DB_File provides an interface to all three
  23. of the database types (hash, btree and recno) currently supported by
  24. Berkeley DB.
  25. For further details see the documentation included at the end of the
  26. file DB_File.pm.
  27. PREREQUISITES
  28. -------------
  29. Before you can build DB_File you must have the following installed on
  30. your system:
  31.     * Perl 5.004_05 or greater.
  32.     * Berkeley DB.
  33.       The official web site for Berkeley DB is http://www.sleepycat.com.
  34.       The latest version of Berkeley DB is always available there. It
  35.       is recommended that you use the most recent version available at
  36.       the Sleepycat site.
  37.       The one exception to this advice is where you want to use DB_File
  38.       to access database files created by a third-party application, like
  39.       Sendmail or Netscape. In these cases you must build DB_File with a
  40.       compatible version of Berkeley DB.
  41.       If you want to use Berkeley DB 2.x, you must have version 2.3.4
  42.       or greater.  If you want to use Berkeley DB 3.x or 4.x, any version
  43.       will do. For Berkeley DB 1.x, use either version 1.85 or 1.86.
  44. BUILDING THE MODULE
  45. -------------------
  46. Assuming you have met all the prerequisites, building the module should
  47. be relatively straightforward.
  48. Step 1 : If you are running either Solaris 2.5 or HP-UX 10 and want
  49.          to use Berkeley DB version 2, 3 or 4, read either the Solaris Notes
  50.          or HP-UX Notes sections below.  If you are running Linux please
  51.          read the Linux Notes section before proceeding.
  52. Step 2 : Edit the file config.in to suit you local installation.
  53.          Instructions are given in the file.
  54. Step 3 : Build and test the module using this sequence of commands:
  55.              perl Makefile.PL
  56.              make
  57.              make test
  58.   NOTE:
  59.       If you have a very old version of Berkeley DB (i.e. pre 1.85),
  60.       three of the tests in the recno test harness may fail (tests 51,
  61.       53 and 55). You can safely ignore the errors if you're never
  62.       going to use the broken functionality (recno databases with a
  63.       modified bval).  Otherwise you'll have to upgrade your DB
  64.       library.
  65. INSTALLATION
  66. ------------
  67.     make install
  68. TROUBLESHOOTING
  69. ===============
  70. Here are some of the common problems people encounter when building
  71. DB_File.
  72. Missing db.h or libdb.a
  73. -----------------------
  74. If you get an error like this:
  75.   cc -c -I/usr/local/include -Dbool=char -DHAS_BOOL
  76.   -O2    -DVERSION="1.64" -DXS_VERSION="1.64" -fpic
  77.   -I/usr/local/lib/perl5/i586-linux/5.00404/CORE -DmDB_Prefix_t=size_t
  78.   -DmDB_Hash_t=u_int32_t DB_File.c
  79.   DB_File.xs:101: db.h: No such file or directory
  80. or this:
  81.   LD_RUN_PATH="/lib" cc -o blib/arch/auto/DB_File/DB_File.so  -shared
  82.   -L/usr/local/lib DB_File.o    -L/usr/local/lib -ldb
  83.   ld: cannot open -ldb: No such file or directory
  84. This symptom can imply:
  85.  1. You don't have Berkeley DB installed on your system at all.
  86.     Solution: get & install Berkeley DB.
  87.  2. You do have Berkeley DB installed, but it isn't in a standard place.
  88.     Solution: Edit config.in and set the LIB and INCLUDE variables to point
  89.               to the directories where libdb.a and db.h are installed.
  90. Undefined symbol db_version
  91. ---------------------------
  92. DB_File seems to have built correctly, but you get an error like this
  93. when you run the test harness:
  94.   $ make test
  95.   PERL_DL_NONLAZY=1 /usr/bin/perl5.00404 -I./blib/arch -I./blib/lib
  96.   -I/usr/local/lib/perl5/i586-linux/5.00404 -I/usr/local/lib/perl5 -e 'use
  97.   Test::Harness qw(&runtests $verbose); $verbose=0; runtests @ARGV;' t/*.t
  98.   t/db-btree..........Can't load './blib/arch/auto/DB_File/DB_File.so' for
  99.   module DB_File: ./blib/arch/auto/DB_File/DB_File.so: undefined symbol:
  100.   db_version at /usr/local/lib/perl5/i586-linux/5.00404/DynaLoader.pm
  101.   line 166.
  102.   at t/db-btree.t line 21
  103.   BEGIN failed--compilation aborted at t/db-btree.t line 21.
  104.   dubious Test returned status 2 (wstat 512, 0x200)
  105. This error usually happens when you have both version 1 and version
  106. 2 of Berkeley DB installed on your system and DB_File attempts to
  107. build using the db.h for Berkeley DB version 2 and the version 1
  108. library. Unfortunately the two versions aren't compatible with each
  109. other. The undefined symbol error is actually caused because Berkeley
  110. DB version 1 doesn't have the symbol db_version.
  111. Solution: Setting the LIB & INCLUDE variables in config.in to point to the
  112.           correct directories can sometimes be enough to fix this
  113.           problem. If that doesn't work the easiest way to fix the
  114.           problem is to either delete or temporarily rename the copies
  115.           of db.h and libdb.a that you don't want DB_File to use.
  116. Undefined symbol dbopen
  117. -----------------------
  118. DB_File seems to have built correctly, but you get an error like this
  119. when you run the test harness:
  120.   ...
  121.   t/db-btree..........Can't load 'blib/arch/auto/DB_File/DB_File.so' for
  122.   module DB_File: blib/arch/auto/DB_File/DB_File.so: undefined symbol:
  123.   dbopen at /usr/local/lib/perl5/5.6.1/i586-linux/DynaLoader.pm line 206.
  124.    at t/db-btree.t line 23
  125.   Compilation failed in require at t/db-btree.t line 23.
  126.   ...
  127. This error usually happens when you have both version 1 and a more recent
  128. version of Berkeley DB installed on your system and DB_File attempts
  129. to build using the db.h for Berkeley DB version 1 and the newer version
  130. library. Unfortunately the two versions aren't compatible with each
  131. other. The undefined symbol error is actually caused because versions
  132. of Berkeley DB newer than version 1 doesn't have the symbol dbopen.
  133. Solution: Setting the LIB & INCLUDE variables in config.in to point to the
  134.           correct directories can sometimes be enough to fix this
  135.           problem. If that doesn't work the easiest way to fix the
  136.           problem is to either delete or temporarily rename the copies
  137.           of db.h and libdb.a that you don't want DB_File to use.
  138. Incompatible versions of db.h and libdb
  139. ---------------------------------------
  140. BerkeleyDB seems to have built correctly, but you get an error like this
  141. when you run the test harness:
  142.   $ make test
  143.   PERL_DL_NONLAZY=1 /home/paul/perl/install/bin/perl5.00560 -Iblib/arch
  144.   -Iblib/lib -I/home/paul/perl/install/5.005_60/lib/5.00560/i586-linux
  145.   -I/home/paul/perl/install/5.005_60/lib/5.00560 -e 'use Test::Harness
  146.   qw(&runtests $verbose); $verbose=0; runtests @ARGV;' t/*.t
  147.   t/db-btree..........
  148.   DB_File needs compatible versions of libdb & db.h
  149.           you have db.h version 2.3.7 and libdb version 2.7.5
  150.   BEGIN failed--compilation aborted at t/db-btree.t line 21.
  151.   ...
  152. Another variation on the theme of having two versions of Berkeley DB on
  153. your system.
  154. Solution: Setting the LIB & INCLUDE variables in config.in to point to the
  155.           correct directories can sometimes be enough to fix this
  156.           problem. If that doesn't work the easiest way to fix the
  157.           problem is to either delete or temporarily rename the copies
  158.           of db.h and libdb.a that you don't want BerkeleyDB to use.
  159.           If you are running Linux, please read the Linux Notes section
  160.           below.
  161. Linux Notes
  162. -----------
  163. Newer versions of Linux (e.g. RedHat 6, SuSe 6) ship with a C library
  164. that has version 2.x of Berkeley DB linked into it. This makes it
  165. difficult to build this module with anything other than the version of
  166. Berkeley DB that shipped with your Linux release. If you do try to use
  167. a different version of Berkeley DB you will most likely get the error
  168. described in the "Incompatible versions of db.h and libdb" section of
  169. this file.
  170. To make matters worse, prior to Perl 5.6.1, the perl binary itself
  171. *always* included the Berkeley DB library.
  172. If you want to use a newer version of Berkeley DB with this module, the
  173. easiest solution is to use Perl 5.6.1 (or better) and Berkeley DB 3.x
  174. (or better).
  175. There are two approaches you can use to get older versions of Perl to
  176. work with specific versions of Berkeley DB. Both have their advantages
  177. and disadvantages.
  178. The first approach will only work when you want to build a version of
  179. Perl older than 5.6.1 along with Berkeley DB 3.x. If you want to use
  180. Berkeley DB 2.x, you must use the next approach. This approach involves
  181. rebuilding your existing version of Perl after applying an unofficial
  182. patch. The "patches" directory in the this module's source distribution
  183. contains a number of patch files. There is one patch file for every
  184. stable version of Perl since 5.004. Apply the appropriate patch to your
  185. Perl source tree before re-building and installing Perl from scratch.
  186. For example, assuming you are in the top-level source directory for
  187. Perl 5.6.0, the command below will apply the necessary patch. Remember
  188. to replace the path shown below with one that points to this module's
  189. patches directory.
  190.     patch -p1 -N </path/to/DB_File/patches/5.6.0
  191. Now rebuild & install perl. You should now have a perl binary that can
  192. be used to build this module. Follow the instructions in "BUILDING THE
  193. MODULE", remembering to set the INCLUDE and LIB variables in config.in.
  194. The second approach will work with both Berkeley DB 2.x and 3.x.
  195. Start by building Berkeley DB as a shared library. This is from
  196. the Berkeley DB build instructions:
  197.     Building Shared Libraries for the GNU GCC compiler
  198.     If you're using gcc and there's no better shared library example for
  199.     your architecture, the following shared library build procedure will
  200.     probably work.
  201.     Add the -fpic option to the CFLAGS value in the Makefile.
  202.     Rebuild all of your .o files. This will create a Berkeley DB library
  203.     that contains .o files with PIC code. To build the shared library,
  204.     then take the following steps in the library build directory:
  205.     % mkdir tmp
  206.     % cd tmp
  207.     % ar xv ../libdb.a
  208.     % gcc -shared -o libdb.so *.o
  209.     % mv libdb.so ..
  210.     % cd ..
  211.     % rm -rf tmp
  212.     Note, you may have to change the gcc line depending on the
  213.     requirements of your system.
  214.     The file libdb.so is your shared library
  215. Once you have built libdb.so, you will need to store it somewhere safe.
  216.     cp libdb.so /usr/local/BerkeleyDB/lib
  217. If you now set the LD_PRELOAD environment variable to point to this
  218. shared library, Perl will use it instead of the version of Berkeley DB
  219. that shipped with your Linux distribution.
  220.     export LD_PRELOAD=/usr/local/BerkeleyDB/lib/libdb.so
  221. Finally follow the instructions in "BUILDING THE MODULE" to build,
  222. test and install this module. Don't forget to set the INCLUDE and LIB
  223. variables in config.in.
  224. Remember, you will need to have the LD_PRELOAD variable set anytime you
  225. want to use Perl with Berkeley DB. Also note that if you have LD_PRELOAD
  226. permanently set it will affect ALL commands you execute. This may be a
  227. problem if you run any commands that access a database created by the
  228. version of Berkeley DB that shipped with your Linux distribution.
  229. Solaris Notes
  230. -------------
  231. If you are running Solaris 2.5, and you get this error when you run the
  232. DB_File test harness:
  233.     libc internal error: _rmutex_unlock: rmutex not held.
  234. you probably need to install a Sun patch. It has been reported that
  235. Sun patch 103187-25 (or later revisions) fixes this problem.
  236. To find out if you have the patch installed, the command "showrev -p"
  237. will display the patches that are currently installed on your system.
  238. HP-UX 10 Notes
  239. --------------
  240. Some people running HP-UX 10 have reported getting an error like this
  241. when building DB_File with the native HP-UX compiler.
  242.     ld: (Warning) At least one PA 2.0 object file (DB_File.o) was detected.
  243.     The linked output may not run on a PA 1.x system.
  244.     ld: Invalid loader fixup for symbol "$000000A5".
  245. If this is the case for you, Berkeley DB needs to be recompiled with
  246. the +z or +Z option and the resulting library placed in a .sl file. The
  247. following steps should do the trick:
  248.   1: Configure the Berkeley DB distribution with the +z or +Z C compiler
  249.      flag:
  250.         env "CFLAGS=+z" ../dist/configure ...
  251.   2: Edit the Berkeley DB Makefile and change:
  252.         "libdb= libdb.a" to "libdb= libdb.sl".
  253.   3: Build and install the Berkeley DB distribution as usual.
  254. HP-UX 11 Notes
  255. --------------
  256. Some people running the combination of HP-UX 11 and Berkeley DB 2.7.7 have
  257. reported getting this error when the run the test harness for DB_File
  258.     ...
  259.     lib/db-btree.........Can't call method "DELETE" on an undefined value at lib/db-btree.t line 216.
  260.     FAILED at test 26
  261.     lib/db-hash..........Can't call method "DELETE" on an undefined value at lib/db-hash.t line 183.
  262.     FAILED at test 22
  263.     ...
  264. The fix for this is to rebuild and install Berkeley DB with the bigfile
  265. option disabled.
  266. IRIX NOTES
  267. ----------
  268. If you are running IRIX, and want to use Berkeley DB version 1, you can
  269. get it from http://reality.sgi.com/ariel. It has the patches necessary
  270. to compile properly on IRIX 5.3.
  271. FEEDBACK
  272. ========
  273. How to report a problem with DB_File.
  274. When reporting any problem, I need the information requested below. 
  275.  1. The *complete* output from running this
  276.         perl -V
  277.     Do not edit the output in any way. 
  278.     Note, I want you to run "perl -V" and NOT "perl -v".
  279.     If your perl does not understand the "-V" option it is too
  280.     old. DB_File needs Perl version 5.00405 or better.
  281.  2. The version of DB_File you have.
  282.     If you have successfully installed DB_File, this one-liner will
  283.     tell you:
  284.        perl -e 'use DB_File; print qq{DB_File ver $DB_File::VERSIONn}'
  285.     If you haven't installed DB_File then search DB_File.pm for a line
  286.     like this:
  287.       $VERSION = "1.20" ;
  288.  3. The version of Berkeley DB you are using.
  289.     If you are using a version older than 1.85, think about upgrading. One
  290.     point to note if you are considering upgrading Berkeley DB - the
  291.     file formats for 1.85, 1.86, 2.0, 3.0 & 3.1 are all different.
  292.     If you have successfully installed DB_File, this command will display
  293.     the version of Berkeley DB it was built with:
  294.        perl -e 'use DB_File; print qq{Berkeley DB ver $DB_File::db_vern}'
  295.  4. A copy the file config.in from the DB_File main source directory.
  296.  5. A listing of directories where Berkeley DB is installed.
  297.     For example, if Berkeley DB is installed in /usr/BerkeleDB/lib and
  298.     /usr/BerkeleyDB/include, I need the output from running this
  299.         ls -l /usr/BerkeleyDB/lib
  300.         ls -l /usr/BerkeleyDB/include
  301.  6. If you are having problems building DB_File, send me a complete log
  302.     of what happened. Start by unpacking the DB_File module into a fresh
  303.     directory and keep a log of all the steps
  304.         [edit config.in, if necessary]
  305.         perl Makefile.PL
  306.         make 
  307.         make test TEST_VERBOSE=1
  308.  7. Now the difficult one. If you think you have found a bug in DB_File
  309.     and you want me to fix it, you will *greatly* enhance the chances
  310.     of me being able to track it down by sending me a small
  311.     self-contained Perl script that illustrates the problem you are
  312.     encountering. Include a summary of what you think the problem is
  313.     and a log of what happens when you run the script, in case I can't
  314.     reproduce your problem on my system. If possible, don't have the
  315.     script dependent on an existing 20Meg database. If the script you
  316.     send me can create the database itself then that is preferred.
  317.     I realise that in some cases this is easier said than done, so if
  318.     you can only reproduce the problem in your existing script, then
  319.     you can post me that if you want. Just don't expect me to find your
  320.     problem in a hurry, or at all. :-)
  321. CHANGES
  322. -------
  323. See the Changes file.
  324. Paul Marquess <Paul.Marquess@btinternet.com>