.-.-.-.-.-

PK�8�\��^��A�AChangesnu�[���

1.842 14 July 2018

* Document the MaocOS build failures & how MacPort can work around th eissue.
     # 125238
     # 125585
     # RT 133280

* Write all test db files into a directory created by File::Temp
     Protects against any possible races if running a parallel build.

* #96357: DB_File destructor is not thread-safe
     Added CLONE_SKIP to DB_File.pm and included the test db-threads.t from the patch.
     Note - This only works with perl >= 5.8.7

1.841 2 Apr 2018

* #124944 allow ppport.h-less builds in core

1.840 29 Dec 2016

* #119569: Failed to install DB_File-1.839 into Linux

1.839 29 Dec 2016

* #119557: DB_File.xs: unused-parameter warnings
   * #107642: unused arg

1.838 15 May 2016

* #101342: R_SETCURSOR compiler warning
     #111726: Coverity finding: flagSet() test always false

1.837 9 Jan 2016

* DB_File: database UTF-8 documentation
     RT #110248

* Coverity finding: status variable ignored multiple times
     RT #111725

1.836 6 Jan 2016

* Confirm build with BDB 6.2

1.835 23 Dec 2014

* Silence more compiler warnings

1.834 11 Dec 2014

* Makefile.PL: version check is missing a zero
     RT #100844

1.833 9 Dec 2014

* More Silence compiler warnings

* 1.832 breaks bleadperl C89 build
     RT #100812

1.832 8 Dec 2014

* Silence compiler warnings

* #96126: build failure in blead

* C++ change from blead

1.831 15 November 2013

* C99 comment is a nogo
     RT #90383

1.830 2 November 2013

* Memory leaks when failed to open db
     RT #89589

* DB_File uses AutoLoader for no reason
     RT #88258

1.829 7 July 2013

* make realclean: removing all files
     RT #68214

* Documented the issue where the error below

BDB0588 At least one secondary cursor must be specified to DB->join

* DB_File installs to wrong place for CPAN version
     RT #70420
     Makefile.PL prevents INSTALLDIRS on command line.
     RT #68287: Makefile.PL prevents INSTALLDIRS on command line.

* typo fix
     RT #85335

1.828 7 May 2013

* Minor change to build with Berkeley DB 6.x

1.827 25 Jan 2012

* DB_File.pm - Don't use "@_" construct
     [RT #79287]

1.826 25 Jan 2012

* t/db-btree.t - fix use of "length @array"
     [RT #74336]

1.825 24 Jan 2012

* t/db-btree.t - fix use of "length @array"
     [RT #74336]

1.824 6 Aug 2011

* Amendments to tests to work in blead
     [RT #70108]

1.823 6 Aug 2011

* croak if attempt to freeze/thaw DB_File object
     [RT #69985]

1.822 12 March 2011

* Link rot
     [rt.cpan.org #68739]

1.822 12 March 2011

* Keep DB_File's warnings in sync with perl's
     [rt.cpan.org #66339]

1.821 10 January 2011

* Fixed typos & spelling errors.
     [perl #81792]

1.820 28 March 2009

* remove MAN3PODS from Makefile.PL to match core.

1.819 18 February 2009

* t/db-recno.t fails if run in a path that contains spaces
     [rt.cpan.org #43288]

1.818 21 January 2009

* Updated Makefile.PL for Strawberry Perl. 
     Patch suggested by David Golden.

* Remove IRIX notes from README. The page referenced doesn't exist
     anymore.

1.817 27 March 2008

* Updated dbinfo

* Applied core patch 32299 - Re-apply change #30562

* Applied core patch 32208

* Applied core patch 32884 - use MM->parse_version() in Makefile.PL

* Applied core patch 32883 -  Silence new warning grep in void context warning

* Applied core patch 32704 to remove use of PL_na in typemap

* Applied core patch 30562 to fix a build issue on OSF

1.816 28 October 2007

* Clarified the warning about building with a different version of
     Berkeley DB that is used at runtime.

* Also made the boot version check less strict.
     [rt.cpan.org #30013]

1.815 4 February 2007

* A few casting cleanups for building with C++ from Steve Peters.

* Fixed problem with recno which happened if you changed directory after
     opening the database. Problem reported by Andrew Pam.

1.814 11 November 2005

* Fix from Dominic Dunlop to tidy up an OS-X specific warning in
     db-btree.t.

* Silenced a warning about $DB_File::Error only being used once.
     Issue spotted by Dominic Dunlop.

1.813 31st October 2005

* Updates for Berkeley DB 4.4

1.812 9th October 2005

* Added libscan to Makefile.PL

* Fixed test failing under windows

1.811 12th March 2005

* Fixed DBM filter bug in seq

1.810 7th August 2004

* Fixed db-hash.t for Cygwin

* Added substr tests to db-hast.t

* Documented AIX build problem in README.

1.809 20th June 2004

* Merged core patch 22258

* Merged core patch 22741

* Fixed core bug 30237. 
     Using substr to pass parameters to the low-level Berkeley DB interface
     causes problems with Perl 5.8.1 or better.
     typemap fix supplied by Marcus Holland-Moritz.

1.808 22nd December 2003

* Added extra DBM Filter tests.

* Fixed a memory leak in ParseOpenInfo, which whould occur if the
     opening of the database failed. Leak spotted by Adrian Enache.

1.807 1st November 2003

* Fixed minor typos on pod documentation - reported by Jeremy Mates &
     Mark Jason Dominus.

* dbinfo updated to report when a database is encrypted.

1.806 22nd October 2002

* Fixed problem when trying to build with a multi-threaded perl.

* Tidied up the recursion detection code.

* merged core patch 17844 - missing dTHX declarations.

* merged core patch 17838

1.805 1st September 2002

* Added support to allow DB_File to build with Berkeley DB 4.1.X

* Tightened up the test harness to test that calls to untie don't generate
     the "untie attempted while %d inner references still exist" warning.

* added code to guard against calling the callbacks (compare,hash & prefix) 
     recursively.

* passing undef for the flags and/or mode when opening a database could cause
     a "Use of uninitialized value in subroutine entry" warning. Now silenced.

* DBM filter code beefed up to cope with read-only $_.

1.804 2nd June 2002

* Perl core patch 14939 added a new warning to "splice". This broke the
     db-recno test harness. Fixed.

* merged core patches 16502 & 16540.

1.803 1st March 2002

* Fixed a problem with db-btree.t where it complained about an "our"
     variable redeclaration.

* FETCH, STORE & DELETE don't map the flags parameter into the
     equivalent Berkeley DB function anymore.

1.802 6th January 2002

* The message about some test failing in db-recno.t had the wrong test
     numbers. Fixed.

* merged core patch 13942.

1.801 26th November 2001

* Fixed typo in Makefile.PL

* Added "clean" attribute to Makefile.PL
 
1.800 23rd November 2001

* use pport.h for perl backward compatibility code.

* use new  ExtUtils::Constant module to generate XS constants.

* upgrade Makefile.PL upgrade/downgrade code to toggle "our" with
     "use vars"

1.79 22nd October 2001

* Added a "local $SIG{__DIE__}" inside the eval that checks for
     the presence of XSLoader s suggested by Andrew Hryckowin.

* merged core patch 12277.

* Changed NEXTKEY to not initialise the input key. It isn't used anyway.

1.79 22nd October 2001

* Fixed test harness for cygwin

1.78 30th July 2001

* the test in Makefile.PL for AIX used -plthreads. Should have been
     -lpthreads

* merged Core patches 
        10372, 10335, 10372, 10534, 10549, 10643, 11051, 11194, 11432

* added documentation patch regarding duplicate keys from Andrew Johnson

1.77 26th April 2001

* AIX is reported to need -lpthreads, so Makefile.PL now checks for
     AIX and adds it to the link options.

* Minor documentation updates.

* Merged Core patch 9176

* Added a patch from Edward Avis that adds support for splice with
     recno databases.

* Modified Makefile.PL to only enable the warnings pragma if using perl
     5.6.1 or better.

1.76 15th January 2001

* Added instructions for using LD_PRELOAD to get Berkeley DB 2.x to work
     with DB_File on Linux. Thanks to Norbert Bollow for sending details of
     this approach.

1.75 17th December 2000

* Fixed perl core patch 7703

* Added support to allow DB_File to be built with Berkeley DB 3.2 --
     btree_compare, btree_prefix and hash_cb needed to be changed.

* Updated dbinfo to support Berkeley DB 3.2 file format changes.

1.74 10th December 2000

* A "close" call in DB_File.xs needed parenthesised to stop win32 from
     thinking it was one of its macros.

* Updated dbinfo to support Berkeley DB 3.1 file format changes.

* DB_File.pm & the test hasness now use the warnings pragma (when
     available).

* Included Perl core patch 7703 -- size argument for hash_cb is different
     for Berkeley DB 3.x

* Included Perl core patch 7801 -- Give __getBerkeleyDBInfo the ANSI C
     treatment.

* @a = () produced the warning 'Argument "" isn't numeric in entersub'
     This has been fixed. Thanks to Edward Avis for spotting this bug.

* Added note about building under Linux. Included patches.

* Included Perl core patch 8068 -- fix for bug 20001013.009 
     When run with warnings enabled "$hash{XX} = undef " produced an
     "Uninitialized value" warning. This has been fixed.

1.73 31st May 2000

* Added support in version.c for building with threaded Perl.

* Berkeley DB 3.1 has reenabled support for null keys. The test
     harness has been updated to reflect this.

1.72 16th January 2000

* Added hints/sco.pl

* The module will now use XSLoader when it is available. When it
     isn't it will use DynaLoader.

* The locking section in DB_File.pm has been discredited. Many thanks
     to David Harris for spotting the underlying problem, contributing
     the updates to the documentation and writing DB_File::Lock (available
     on CPAN).

1.71 7th September 1999

* Fixed a bug that prevented 1.70 from compiling under win32

* Updated to support Berkeley DB 3.x

* Updated dbinfo for Berkeley DB 3.x file formats.

1.70 4th August 1999

* Initialise $DB_File::db_ver and $DB_File::db_version with
     GV_ADD|GV_ADDMULT -- bug spotted by Nick Ing-Simmons.

* Added a BOOT check to test for equivalent versions of db.h &
     libdb.a/so.

1.69 3rd August 1999

* fixed a bug in push -- DB_APPEND wasn't working properly.

* Fixed the R_SETCURSOR bug introduced in 1.68

* Added a new Perl variable $DB_File::db_ver
   
1.68 22nd July 1999

* Merged changes from 5.005_58

* Fixed a bug in R_IBEFORE & R_IAFTER processing in Berkeley DB
     2 databases.

* Added some of the examples in the POD into the test harness.

1.67 6th June 1999

* Added DBM Filter documentation to DB_File.pm

* Fixed DBM Filter code to work with 5.004

* A few instances of newSVpvn were used in 1.66. This isn't available in
     Perl 5.004_04 or earlier. Replaced with newSVpv.

1.66 15th March 1999

* Added DBM Filter code

1.65 6th March 1999

* Fixed a bug in the recno PUSH logic.
   * The BOOT version check now needs 2.3.4 when using Berkeley DB version 2

1.64 21st February 1999

* Tidied the 1.x to 2.x flag mapping code.
   * Added a patch from Mark Kettenis <kettenis@wins.uva.nl> to fix a flag
     mapping problem with O_RDONLY on the Hurd
   * Updated the message that db-recno.t prints when tests 51, 53 or 55 fail.

1.63 19th December 1998

* Fix to allow DB 2.6.x to build with DB_File
   * Documentation updated to use push,pop etc in the RECNO example &
     to include the find_dup & del_dup methods.

1.62 30th November 1998

Added hints/dynixptx.pl.
   Fixed typemap -- 1.61 used PL_na instead of na

1.61 19th November 1998

Added a note to README about how to build Berkeley DB 2.x when
   using HP-UX.
   Minor modifications to get the module to build with DB 2.5.x
   Fixed a typo in the definition of O_RDONLY, courtesy of Mark Kettenis.

1.60
   Changed the test to check for full tied array support

1.59
   Updated the license section.

Berkeley DB 2.4.10 disallows zero length keys. Tests 32 & 42 in
   db-btree.t and test 27 in db-hash.t failed because of this change.
   Those tests have been zapped.

Added dbinfo to the distribution.

1.58
   Tied Array support was enhanced in Perl 5.004_57. DB_File now
   supports PUSH,POP,SHIFT,UNSHIFT & STORESIZE.

Fixed a problem with the use of sv_setpvn. When the size is
   specified as 0, it does a strlen on the data.  This was ok for DB
   1.x, but isn't for DB 2.x.

1.57
   If Perl has been compiled with Threads support,the symbol op will be
   defined. This clashes with a field name in db.h, so it needs to be
   #undef'ed before db.h is included.

1.56
   Documented the Solaris 2.5 mutex bug

1.55
   Merged 1.16 changes.

1.54

Fixed a small bug in the test harness when run under win32
   The emulation of fd when useing DB 2.x was busted.

1.53

Added DB_RENUMBER to flags for recno.

1.52

Patch from Nick Ing-Simmons now allows DB_File to build on NT.
   Merged 1.15 patch.

1.51

Fixed the test harness so that it doesn't expect DB_File to have
    been installed by the main Perl build.

Fixed a bug in mapping 1.x O_RDONLY flag to 2.x DB_RDONLY equivalent

1.50

DB_File can now build with either DB 1.x or 2.x, but not both at
    the same time.

1.16

A harmless looking tab was causing Makefile.PL to fail on AIX 3.2.5

Small fix for the AIX strict C compiler XLC which doesn't like
    __attribute__ being defined via proto.h and redefined via db.h. Fix
    courtesy of Jarkko Hietaniemi.

1.15

Patch from Gisle Aas <gisle@aas.no> to suppress "use of undefined
    value" warning with db_get and db_seq.

Patch from Gisle Aas <gisle@aas.no> to make DB_File export only the
    O_* constants from Fcntl.

Removed the DESTROY method from the DB_File::HASHINFO module.

Previously DB_File hard-wired the class name of any object that it
    created to "DB_File". This makes sub-classing difficult. Now
    DB_File creats objects in the namespace of the package it has been
    inherited into.

1.14

Made it illegal to tie an associative array to a RECNO database and
    an ordinary array to a HASH or BTREE database.

1.13

Minor changes to DB_FIle.xs and DB_File.pm

1.12

Documented the incompatibility with version 2 of Berkeley DB.

1.11

Documented the untie gotcha.

1.10

Fixed fd method so that it still returns -1 for in-memory files
    when db 1.86 is used.

1.09

Minor bug fix in DB_File::HASHINFO, DB_File::RECNOINFO and
    DB_File::BTREEINFO.

Changed default mode to 0666.

1.08

Documented operation of bval.

1.07

Fixed bug with RECNO, where bval wasn't defaulting to "\n".

1.06

Minor namespace cleanup: Localized PrintBtree.

1.05

Made all scripts in the documentation strict and -w clean.

Added logic to DB_File.xs to allow the module to be built after
    Perl is installed.

1.04

Minor documentation changes.

Fixed a bug in hash_cb. Patches supplied by Dave Hammen,
    <hammen@gothamcity.jsc.nasa.govt>.

Fixed a bug with the constructors for DB_File::HASHINFO,
    DB_File::BTREEINFO and DB_File::RECNOINFO. Also tidied up the
    constructors to make them -w clean.

Reworked part of the test harness to be more locale friendly.

1.03

Documentation update.

DB_File now imports the constants (O_RDWR, O_CREAT etc.) from Fcntl
    automatically.

The standard hash function exists is now supported.

Modified the behavior of get_dup. When it returns an associative
    array, the value is the count of the number of matching BTREE
    values.

1.02

Merged OS/2 specific code into DB_File.xs

Removed some redundant code in DB_File.xs.

Documentation update.

Allow negative subscripts with RECNO interface.

Changed the default flags from O_RDWR to O_CREAT|O_RDWR.

The example code which showed how to lock a database needed a call
    to sync added. Without it the resultant database file was empty.

Added get_dup method.

1.01

Fixed a core dump problem with SunOS.

The return value from TIEHASH wasn't set to NULL when dbopen
    returned an error.

1.0

DB_File has been in use for over a year. To reflect that, the
    version number has been incremented to 1.0.

Added complete support for multiple concurrent callbacks.

Using the push method on an empty list didn't work properly. This
    has been fixed.

0.3

Added prototype support for multiple btree compare callbacks.

0.2

When DB_File is opening a database file it no longer terminates the
    process if dbopen returned an error. This allows file protection
    errors to be caught at run time. Thanks to Judith Grass
    <grass@cybercash.com> for spotting the bug.

0.1

First Release.

PK�8�\NʤkkREADMEnu�[���                                  DB_File

Version 1.842

14 July 2018

Copyright (c) 1995-2018 Paul Marquess. All rights reserved. This
      program is free software; you can redistribute it and/or modify
                  it under the same terms as Perl itself.

IMPORTANT NOTICE
================

If are using the locking technique described in older versions of
DB_File, please read the section called "Locking: The Trouble with fd"
in DB_File.pm immediately. The locking method has been found to be
unsafe. You risk corrupting your data if you continue to use it.

DESCRIPTION
-----------

DB_File is a module which allows Perl programs to make use of the
facilities provided by Berkeley DB version 1. (DB_File can be built
version 2, or greater, of Berkeley DB, but it will only support the 1.x
features).

If you want to make use of the new features available in Berkeley DB
2.x, or greater, use the Perl module BerkeleyDB instead.

Berkeley DB is a C library which provides a consistent interface to a
number of database formats. DB_File provides an interface to all three
of the database types (hash, btree and recno) currently supported by
Berkeley DB.

For further details see the documentation included at the end of the
file DB_File.pm.

PREREQUISITES
-------------

Before you can build DB_File you must have the following installed on
your system:

* Perl 5.8.3 or greater.

* Berkeley DB.

The official web site for Berkeley DB is

http://www.oracle.com/technology/products/berkeley-db/db/index.html

The latest version of Berkeley DB is always available there. It
      is recommended that you use the most recent version available.

The one exception to this advice is where you want to use DB_File
      to access database files created by a third-party application, like
      Sendmail or Netscape. In these cases you must build DB_File with a
      compatible version of Berkeley DB.

If you want to use Berkeley DB 2.x, you must have version 2.3.4
      or greater.  If you want to use Berkeley DB 3.x or 4.x, any version
      will do. For Berkeley DB 1.x, use either version 1.85 or 1.86.

BUILDING THE MODULE
-------------------

Assuming you have met all the prerequisites, building the module should
be relatively straightforward.

Step 1 : If you are running either Solaris 2.5 or HP-UX 10 and want
         to use Berkeley DB version 2, 3 or 4, read either the Solaris Notes
         or HP-UX Notes sections below.  If you are running Linux please
         read the Linux Notes section before proceeding.

Step 2 : Edit the file config.in to suit you local installation.
         Instructions are given in the file.

Step 3 : Build and test the module using this sequence of commands:

perl Makefile.PL
             make
             make test

NOTE:
      If you have a very old version of Berkeley DB (i.e. pre 1.85),
      three of the tests in the recno test harness may fail (tests 51,
      53 and 55). You can safely ignore the errors if you're never
      going to use the broken functionality (recno databases with a
      modified bval).  Otherwise you'll have to upgrade your DB
      library.

INSTALLATION
------------

make install

UPDATES
=======

The most recent version of DB_File is always available at

http://www.cpan.org/modules/by-module/DB_File/

TROUBLESHOOTING
===============

Here are some of the common problems people encounter when building
DB_File.

Missing db.h or libdb.a
-----------------------

If you get an error like this:

cc -c -I/usr/local/include -Dbool=char -DHAS_BOOL
  -O2    -DVERSION=\"1.64\" -DXS_VERSION=\"1.64\" -fpic
  -I/usr/local/lib/perl5/i586-linux/5.00404/CORE -DmDB_Prefix_t=size_t
  -DmDB_Hash_t=u_int32_t DB_File.c
  DB_File.xs:101: db.h: No such file or directory

or this:

LD_RUN_PATH="/lib" cc -o blib/arch/auto/DB_File/DB_File.so  -shared
  -L/usr/local/lib DB_File.o    -L/usr/local/lib -ldb
  ld: cannot open -ldb: No such file or directory

This symptom can imply:

1. You don't have Berkeley DB installed on your system at all.
    Solution: get & install Berkeley DB.

2. You do have Berkeley DB installed, but it isn't in a standard place.
    Solution: Edit config.in and set the LIB and INCLUDE variables to point
              to the directories where libdb.a and db.h are installed.

Undefined symbol db_version
---------------------------

DB_File seems to have built correctly, but you get an error like this
when you run the test harness:

$ make test
  PERL_DL_NONLAZY=1 /usr/bin/perl5.00404 -I./blib/arch -I./blib/lib
  -I/usr/local/lib/perl5/i586-linux/5.00404 -I/usr/local/lib/perl5 -e 'use
  Test::Harness qw(&runtests $verbose); $verbose=0; runtests @ARGV;' t/*.t
  t/db-btree..........Can't load './blib/arch/auto/DB_File/DB_File.so' for
  module DB_File: ./blib/arch/auto/DB_File/DB_File.so: undefined symbol:
  db_version at /usr/local/lib/perl5/i586-linux/5.00404/DynaLoader.pm
  line 166.

at t/db-btree.t line 21
  BEGIN failed--compilation aborted at t/db-btree.t line 21.
  dubious Test returned status 2 (wstat 512, 0x200)

This error usually happens when you have two version of Berkeley DB
installed on your system -- specifically, if you have both version 1 and
a newer version (i.e. version 2 or better) of Berkeley DB installed. If
DB_File is built using the db.h for the newer Berkeley DB and the version
1 Berkeley DB library you will trigger this error. Unfortunately the two
versions aren't compatible with each other. The undefined symbol error is
caused because Berkeley DB version 1 doesn't have the symbol db_version.

Solution: Setting the LIB & INCLUDE variables in config.in to point to the
          correct directories can sometimes be enough to fix this
          problem. If that doesn't work the easiest way to fix the
          problem is to either delete or temporarily rename the copies
          of db.h and libdb.a that you don't want DB_File to use.

Undefined symbol dbopen
-----------------------

DB_File seems to have built correctly, but you get an error like this
when you run the test harness:

...
  t/db-btree..........Can't load 'blib/arch/auto/DB_File/DB_File.so' for
  module DB_File: blib/arch/auto/DB_File/DB_File.so: undefined symbol:
  dbopen at /usr/local/lib/perl5/5.6.1/i586-linux/DynaLoader.pm line 206.
   at t/db-btree.t line 23
  Compilation failed in require at t/db-btree.t line 23.
  ...

This error usually happens when you have both version 1 and a more recent
version of Berkeley DB installed on your system and DB_File attempts
to build using the db.h for Berkeley DB version 1 and the newer version
library. Unfortunately the two versions aren't compatible with each
other. The undefined symbol error is actually caused because versions
of Berkeley DB newer than version 1 doesn't have the symbol dbopen.

Incompatible versions of db.h and libdb
---------------------------------------

DB_File seems to have built correctly, but you get an error like this
when you run the test harness:

$ make test
  PERL_DL_NONLAZY=1 /home/paul/perl/install/bin/perl5.00560 -Iblib/arch
  -Iblib/lib -I/home/paul/perl/install/5.005_60/lib/5.00560/i586-linux
  -I/home/paul/perl/install/5.005_60/lib/5.00560 -e 'use Test::Harness
  qw(&runtests $verbose); $verbose=0; runtests @ARGV;' t/*.t
  t/db-btree..........
  DB_File was build with libdb version 2.3.7
  but you are attempting to run it with libdb version 2.7.5
  BEGIN failed--compilation aborted at t/db-btree.t line 21.
  ...

Another variation on the theme of having two versions of Berkeley DB on
your system.

Keep getting "At least one secondary cursor must be specified to DB->join"
--------------------------------------------------------------------------

When you either run the DB_File test harness, or attempt to run a script
that uses DB_File you get the error message below.

BDB0588 At least one secondary cursor must be specified to DB->join.

To date thus issue has only been reported on Windows. If you encounter this
issue on another platform, please report the issue. See the FEEDBACK
section for details.

This issue boils down to the size of the C type time_t.

The typical reason for getting this error is when running a 32-bit Perl
(which will use a 32-bit time_t) along with a 32-bit Berkeley DB library.
The key point is how Berkeley DB has been built. If it has been built with
a newish version of Visual C++, time_t will default to 64-bit, even when
the rest of the library has been built 32-bit. This means that Perl thinks
time_t is 32-bit, but Berkeley DB thinks it is 64-bit.

More details of how the size of time_t in Windows is shown below (taken
from http://msdn.microsoft.com/en-us/library/w4ddyt9h.aspx)

In versions of Visual C++ and Microsoft C/C++ before Visual C++ 2005,
    time_t was a long int (32 bits) and hence could not be used for dates
    past 3:14:07 January 19, 2038, UTC. time_t is now equivalent to
    __time64_t by default, but defining _USE_32BIT_TIME_T changes time_t
    to __time32_t and forces many time functions to call versions that take
    the 32-bit time_t.

When DB_File is built, it uses a Berkeley DB header file, called db.h. This
file contains the definition of a number of key data structures used by
Berkeley DB. Unfortunately one of those data structures includes a time_t.
This is the root case for this issue. When you build DB_File, it assumes
time_t is 32-bit, but the Berkeley DB library is expecting it to be 64-bit.

Solution:

There are a few options available.

1. Use a 64-bit Perl along with a 64-bit Berkleley DB.

2. Use a 32-bit Perl along with a 32-bit Berkeley DB where _USE_32BIT_TIME_T
   has been defined.

3. If you do need to interoperate with a Berkeley DB library that uses a
   time_t that is different from Perl you need to edit the file DB_File.xs
   and find these lines

/* #define time_t __time64_t */
        /* #define time_t __time32_t */

If your Berkeley DB library uses a 64-bit time_t, uncomment the first line.
    If your Berkeley DB library uses a 32-bit time_t, uncomment the second line.

MacOS Notes
-------------

You are running MacOS 10.13 (or possibly later), and the test DB_File test harness file
db-hash.t fails like this

t/db-btree.t .. ok       
    t/db-hash.t ... Use of uninitialized value $value in string eq at t/db-hash.t line 224.
    Use of uninitialized value $values[0] in string eq at t/db-hash.t line 224.
    Use of uninitialized value $value in lc at t/db-hash.t line 224.
    Use of uninitialized value $h{""} in string eq at t/db-hash.t line 243.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value in numeric eq (==) at t/db-hash.t line 252.
    Use of uninitialized value $foo[18] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[36] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[48] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[58] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[59] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[60] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[62] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[63] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[92] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[114] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[140] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[187] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[188] in join or string at t/db-hash.t line 261.
    Use of uninitialized value $foo[189] in join or string at t/db-hash.t line 261.
    t/db-hash.t ... 1/166 Use of uninitialized value $h{"Fred"} in string eq at t/db-hash.t line 572.
    Use of uninitialized value $v in concatenation (.) or string at t/db-hash.t line 748.
    t/db-hash.t ... Dubious, test returned 25 (wstat 6400, 0x1900)
    Failed 76/166 subtests 
    t/db-recno.t .. ok       
    t/pod.t ....... ok

It appears that MacOS 10.13 has a copy of BerkeleyDB version 1 included in
/usr/lib/system/libsystem_c.dylib. It is not clear why this isn't working
with this module. The following ticket has been reported to Apple
https://discussions.apple.com/thread/8125401

Solution

It has been reported that this issue can be resolved by installing a
separate version of the Berkeley DB library and configuring DB_File to use
it.

One option is to use a prebuild version of Berkeley DB. One is available at
MacPorts (https://www.macports.org/). Once you have MacPorts installed, run
this

sudo port install db48

To get DB_File to use this library edit config.in and change the values for
the LIB and include variables as follows

LIB        = /opt/local/lib/db48
    INCLUDE    = /opt/local/include/db48

Alternatively, set the two envornment variables DB_FILE_LIB and DB_FILE_INCLUDE
as follows

export DB_FILE_LIB=/opt/local/lib/db48
    export DB_FILE_INCLUDE=/opt/local/include/db48

Now rebuild DB_File from scratch.

Solaris build fails with "language optional software package not installed"
---------------------------------------------------------------------------

If you are trying to build this module under Solaris and you get an
error message like this

/usr/ucb/cc: language optional software package not installed

it means that Perl cannot find the C compiler on your system. The cryptic
message is just Sun's way of telling you that you haven't bought their
C compiler.

When you build a Perl module that needs a C compiler, the Perl build
system tries to use the same C compiler that was used to build perl
itself. In this case your Perl binary was built with a C compiler that
lived in /usr/ucb.

To continue with building this module, you need to get a C compiler,
or tell Perl where your C compiler is, if you already have one.

Assuming you have now got a C compiler, what you do next will be dependant
on what C compiler you have installed. If you have just installed Sun's
C compiler, you shouldn't have to do anything. Just try rebuilding
this module.

If you have installed another C compiler, say gcc, you have to tell perl
how to use it instead of /usr/ucb/cc.

This set of options seems to work if you want to use gcc. Your mileage
may vary.

perl Makefile.PL CC=gcc CCCDLFLAGS=-fPIC OPTIMIZE=" "
    make test

If that doesn't work for you, it's time to make changes to the Makefile
by hand. Good luck!

Solaris build fails with "gcc: unrecognized option `-KPIC'"
-----------------------------------------------------------

You are running Solaris and you get an error like this when you try to
build this Perl module

gcc: unrecognized option `-KPIC'

This symptom usually means that you are using a Perl binary that has been
built with the Sun C compiler, but you are using gcc to build this module.

When Perl builds modules that need a C compiler, it will attempt to use
the same C compiler and command line options that was used to build perl
itself. In this case "-KPIC" is a valid option for the Sun C compiler,
but not for gcc. The equivalent option for gcc is "-fPIC".

The solution is either:

1. Build both Perl and this module with the same C compiler, either
       by using the Sun C compiler for both or gcc for both.

2. Try generating the Makefile for this module like this perl

perl Makefile.PL CC=gcc CCCDLFLAGS=-fPIC OPTIMIZE=" " LD=gcc
           make test

This second option seems to work when mixing a Perl binary built
       with the Sun C compiler and this module built with gcc. Your
       mileage may vary.

Linux Notes
-----------

Some older versions of Linux (e.g. RedHat 6, SuSe 6) ship with a C library
that has version 2.x of Berkeley DB linked into it. This makes it
difficult to build this module with anything other than the version of
Berkeley DB that shipped with your Linux release. If you do try to use
a different version of Berkeley DB you will most likely get the error
described in the "Incompatible versions of db.h and libdb" section of
this file.

To make matters worse, prior to Perl 5.6.1, the perl binary itself
*always* included the Berkeley DB library.

If you want to use a newer version of Berkeley DB with this module, the
easiest solution is to use Perl 5.6.1 (or better) and Berkeley DB 3.x
(or better).

There are two approaches you can use to get older versions of Perl to
work with specific versions of Berkeley DB. Both have their advantages
and disadvantages.

The first approach will only work when you want to build a version of
Perl older than 5.6.1 along with Berkeley DB 3.x. If you want to use
Berkeley DB 2.x, you must use the next approach. This approach involves
rebuilding your existing version of Perl after applying an unofficial
patch. The "patches" directory in the this module's source distribution
contains a number of patch files. There is one patch file for every
stable version of Perl since 5.004. Apply the appropriate patch to your
Perl source tree before re-building and installing Perl from scratch.
For example, assuming you are in the top-level source directory for
Perl 5.6.0, the command below will apply the necessary patch. Remember
to replace the path shown below with one that points to this module's
patches directory.

patch -p1 -N </path/to/DB_File/patches/5.6.0

Now rebuild & install perl. You should now have a perl binary that can
be used to build this module. Follow the instructions in "BUILDING THE
MODULE", remembering to set the INCLUDE and LIB variables in config.in.

The second approach will work with both Berkeley DB 2.x and 3.x.
Start by building Berkeley DB as a shared library. This is from
the Berkeley DB build instructions:

Building Shared Libraries for the GNU GCC compiler

If you're using gcc and there's no better shared library example for
    your architecture, the following shared library build procedure will
    probably work.

Add the -fpic option to the CFLAGS value in the Makefile.

Rebuild all of your .o files. This will create a Berkeley DB library
    that contains .o files with PIC code. To build the shared library,
    then take the following steps in the library build directory:

% mkdir tmp
    % cd tmp
    % ar xv ../libdb.a
    % gcc -shared -o libdb.so *.o
    % mv libdb.so ..
    % cd ..
    % rm -rf tmp

Note, you may have to change the gcc line depending on the
    requirements of your system.

The file libdb.so is your shared library

Once you have built libdb.so, you will need to store it somewhere safe.

cp libdb.so /usr/local/BerkeleyDB/lib

If you now set the LD_PRELOAD environment variable to point to this
shared library, Perl will use it instead of the version of Berkeley DB
that shipped with your Linux distribution.

export LD_PRELOAD=/usr/local/BerkeleyDB/lib/libdb.so

Finally follow the instructions in "BUILDING THE MODULE" to build,
test and install this module. Don't forget to set the INCLUDE and LIB
variables in config.in.

Remember, you will need to have the LD_PRELOAD variable set anytime you
want to use Perl with Berkeley DB. Also note that if you have LD_PRELOAD
permanently set it will affect ALL commands you execute. This may be a
problem if you run any commands that access a database created by the
version of Berkeley DB that shipped with your Linux distribution.

Solaris Notes
-------------

If you are running Solaris 2.5, and you get this error when you run the
DB_File test harness:

libc internal error: _rmutex_unlock: rmutex not held.

you probably need to install a Sun patch. It has been reported that
Sun patch 103187-25 (or later revisions) fixes this problem.

To find out if you have the patch installed, the command "showrev -p"
will display the patches that are currently installed on your system.

HP-UX 10 Notes
--------------

Some people running HP-UX 10 have reported getting an error like this
when building DB_File with the native HP-UX compiler.

ld: (Warning) At least one PA 2.0 object file (DB_File.o) was detected.
    The linked output may not run on a PA 1.x system.
    ld: Invalid loader fixup for symbol "$000000A5".

If this is the case for you, Berkeley DB needs to be recompiled with
the +z or +Z option and the resulting library placed in a .sl file. The
following steps should do the trick:

1: Configure the Berkeley DB distribution with the +z or +Z C compiler
     flag:

env "CFLAGS=+z" ../dist/configure ...

2: Edit the Berkeley DB Makefile and change:

"libdb= libdb.a" to "libdb= libdb.sl".

3: Build and install the Berkeley DB distribution as usual.

HP-UX 11 Notes
--------------

Some people running the combination of HP-UX 11 and Berkeley DB 2.7.7 have
reported getting this error when the run the test harness for DB_File

...
    lib/db-btree.........Can't call method "DELETE" on an undefined value at lib/db-btree.t line 216.
    FAILED at test 26
    lib/db-hash..........Can't call method "DELETE" on an undefined value at lib/db-hash.t line 183.
    FAILED at test 22
    ...

The fix for this is to rebuild and install Berkeley DB with the bigfile
option disabled.

AIX NOTES
---------

I've had reports of a build failure like this on AIX 5.2 using the
xlC compiler.

rm -f blib/arch/auto/DB_File/DB_File.so
        LD_RUN_PATH="" ld  -bhalt:4 -bM:SRE -bI:/usr/local/5.8.1/lib/perl5/5.8.1/aix/CORE/perl.exp -bE:DB_File.exp -bnoentry -lc
    -L/usr/local/lib version.o DB_File.o  -o blib/arch/auto/DB_File/DB_File.so
    -L/usr/local/BerkeleyDB/lib -ldb -lpthread
    ld: 0711-317 ERROR: Undefined symbol: .mutex_lock
    ld: 0711-317 ERROR: Undefined symbol: .cond_signal
    ld: 0711-317 ERROR: Undefined symbol: .mutex_unlock
    ld: 0711-317 ERROR: Undefined symbol: .mutex_trylock
    ld: 0711-317 ERROR: Undefined symbol: .cond_wait
    ld: 0711-317 ERROR: Undefined symbol: .mutex_init
    ld: 0711-317 ERROR: Undefined symbol: .cond_init
    ld: 0711-317 ERROR: Undefined symbol: .mutex_destroy
    ld: 0711-345 Use the -bloadmap or -bnoquiet option to obtain more information.
    make: 1254-004 The error code from the last command is 8.

Editing Makefile.PL, and changing the line

$LIBS .= " -lpthread" if $^O eq 'aix' ;

to this

$LIBS .= " -lthread" if $^O eq 'aix' ;

fixed the problem.

FEEDBACK
========

General feedback/questions/bug reports can be sent to me at pmqs@cpan.org.

Alternatively, if you have Usenet access, you can try the
comp.databases.berkeley-db or comp.lang.perl.modules groups.

How to report a problem with DB_File.
-------------------------------------

When reporting any problem, I need the information requested below.

1. The *complete* output from running this

perl -V

Do not edit the output in any way. 
    Note, I want you to run "perl -V" and NOT "perl -v".

If your perl does not understand the "-V" option it is too
    old. DB_File needs Perl version 5.00405 or better.

2. The version of DB_File you have.
    If you have successfully installed DB_File, this one-liner will
    tell you:

perl -e 'use DB_File; print qq{DB_File ver $DB_File::VERSION\n}'

If you are running windows use this
    
       perl -e "use DB_File; print qq{DB_File ver $DB_File::VERSION\n}"

If you haven't installed DB_File then search DB_File.pm for a line
    like this:

$VERSION = "1.20" ;

3. The version of Berkeley DB used to build DB_File and the version
    that is used at runtime. (These are usually the same)

If you are using a version older than 1.85, think about upgrading. One
    point to note if you are considering upgrading Berkeley DB - the
    file formats for 1.85, 1.86, 2.0, 3.0 & 3.1 are all different.

If you have successfully installed DB_File, these commands will display
    the versions I need

perl -MDB_File -e 'print qq{Built with Berkeley DB ver $DB_File::db_ver\n}'
       perl -MDB_File -e 'print qq{Running with Berkeley DB ver $DB_File::db_version\n}'

If you are running windows use this

perl -e "use DB_File; print qq{Built with Berkeley DB ver $DB_File::db_ver\n}"
       perl -e "use DB_File; print qq{Running Berkeley DB ver $DB_File::db_version\n}"
    
 4. A copy the file config.in from the DB_File main source directory.

5. A listing of directories where Berkeley DB is installed.
    For example, if Berkeley DB is installed in /usr/BerkeleDB/lib and
    /usr/BerkeleyDB/include, I need the output from running this

ls -l /usr/BerkeleyDB/lib
        ls -l /usr/BerkeleyDB/include

6. If you are having problems building DB_File, send me a complete log
    of what happened. Start by unpacking the DB_File module into a fresh
    directory and keep a log of all the steps

[edit config.in, if necessary]
        perl Makefile.PL
        make 
        make test TEST_VERBOSE=1

7. Now the difficult one. If you think you have found a bug in DB_File
    and you want me to fix it, you will *greatly* enhance the chances
    of me being able to track it down by sending me a small
    self-contained Perl script that illustrates the problem you are
    encountering. Include a summary of what you think the problem is
    and a log of what happens when you run the script, in case I can't
    reproduce your problem on my system. If possible, don't have the
    script dependent on an existing 20Meg database. If the script you
    send me can create the database itself then that is preferred.

I realise that in some cases this is easier said than done, so if
    you can only reproduce the problem in your existing script, then
    you can post me that if you want. Just don't expect me to find your
    problem in a hurry, or at all. :-)

CHANGES
-------

See the Changes file.

Paul Marquess <pmqs@cpan.org>
PK�8�\�	Y��dbinfonu�[���#!/usr/bin/perl

# Name:		dbinfo -- identify berkeley DB version used to create 
#			  a database file
#
# Author:	Paul Marquess  <Paul.Marquess@btinternet.com>
# Version: 	1.06 
# Date		27th March 2008
#
#     Copyright (c) 1998-2012 Paul Marquess. All rights reserved.
#     This program is free software; you can redistribute it and/or
#     modify it under the same terms as Perl itself.

# Todo: Print more stats on a db file, e.g. no of records
#       add log/txn/lock files

use strict ;

my %Data =
	(
	0x053162 =>	# DB_BTREEMAGIC
            {
			  Type 	   => "Btree",
			  Versions => # DB_BTREEVERSION
				{
				  1	=> [0, "Unknown (older than 1.71)"],
				  2	=> [0, "Unknown (older than 1.71)"],
				  3	=> [0, "1.71 -> 1.85, 1.86"],
				  4	=> [0, "Unknown"],
				  5	=> [0, "2.0.0 -> 2.3.0"],
				  6	=> [0, "2.3.1 -> 2.7.7"],
				  7	=> [0, "3.0.x"],
				  8	=> [0, "3.1.x -> 4.0.x"],
				  9	=> [1, "4.1.x or greater"],
				}
			},
	0x061561 => 	# DB_HASHMAGIC
            {
			  Type     => "Hash",
			  Versions => # DB_HASHVERSION
				{
				  1	=> [0, "Unknown (older than 1.71)"],
        			  2     => [0, "1.71 -> 1.85"],
        			  3     => [0, "1.86"],
        			  4     => [0, "2.0.0 -> 2.1.0"],
        			  5     => [0, "2.2.6 -> 2.7.7"],
        			  6     => [0, "3.0.x"],
				  7	=> [0, "3.1.x -> 4.0.x"],
				  8	=> [1, "4.1.x or greater"],
				  9	=> [1, "4.6.x or greater"],
				}
			},
	0x042253 => 	# DB_QAMMAGIC
            {
			  Type     => "Queue",
			  Versions => # DB_QAMVERSION
				{
				  1	=> [0, "3.0.x"],
				  2	=> [0, "3.1.x"],
				  3	=> [0, "3.2.x -> 4.0.x"],
				  4	=> [1, "4.1.x or greater"],
				}
			},
	) ;

die "Usage: dbinfo file\n" unless @ARGV == 1 ;

print "testing file $ARGV[0]...\n\n" ;
open (F, "<$ARGV[0]") or die "Cannot open file $ARGV[0]: $!\n" ;

my $buff ;
read F, $buff, 30 ;

my (@info) = unpack("NNNNNNC", $buff) ;
my (@info1) = unpack("VVVVVVC", $buff) ;
my ($magic, $version, $endian, $encrypt) ;

if ($Data{$info[0]}) # first try DB 1.x format, big endian
{
    $magic = $info[0] ;
    $version = $info[1] ;
    $endian  = "Big Endian" ;
    $encrypt = "Not Supported";
}
elsif ($Data{$info1[0]}) # first try DB 1.x format, little endian
{
    $magic = $info1[0] ;
    $version = $info1[1] ;
    $endian  = "Little Endian" ;
    $encrypt = "Not Supported";
}
elsif ($Data{$info[3]}) # next DB 2.x big endian
{
    $magic = $info[3] ;
    $version = $info[4] ;
    $endian  = "Big Endian" ;
}
elsif ($Data{$info1[3]}) # next DB 2.x little endian
{
    $magic = $info1[3] ;
    $version = $info1[4] ;
    $endian  = "Little Endian" ;
}
else
  { die "not a Berkeley DB database file.\n" }

my $type = $Data{$magic} ;
$magic = sprintf "%06X", $magic ;

my $ver_string = "Unknown" ;

if ( defined $type->{Versions}{$version} )
{
     $ver_string = $type->{Versions}{$version}[1];
     if ($type->{Versions}{$version}[0] )
       { $encrypt = $info[6] ? "Enabled" : "Disabled" }
     else
       { $encrypt = "Not Supported" }
}

print <<EOM ;
File Type:		Berkeley DB $type->{Type} file.
File Version ID:	$version
Built with Berkeley DB:	$ver_string
Byte Order:		$endian
Magic:			$magic
Encryption:             $encrypt
EOM

close F ;

exit ;
PK�8�\��^��A�AChangesnu�[���PK�8�\Nʤkk!BREADMEnu�[���PK�8�\�	Y��q�dbinfonu�[���PK�=�

/home/emeraadmin/www/node_modules/jquery/src/queue/../../../xmlbuilder/../../4d695/perl-DB_File.zip