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

MySQL数据库

开发平台:

Visual C++

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