LMDB_File version 0.07
======================

LMDB_File is a Perl wrapper around the OpenLDAP's LMDB (Lightning
Memory-Mapped Database) C library.

LMDB is an ultra-fast, ultra-compact key-value data store developed
by Symas for the OpenLDAP Project. See http://symas.com/mdb/ for details.

LMDB_File provides full access to the complete C API, a thin Perl wrapper
with an Object-Oriented interface and a simple Perl's tie interface
compatible with others DBMs.

PREREQUISITES

Right now LMDB needs a 64bits platform.

Before you can build LMDB_File you need to have the following installed
on your system:

    * Perl 5.10.0 or greater linked with pthreads.
      See https://rt.perl.org/Public/Bug/Display.html?id=122906 

    * A working C compiler.

    * LMDB Version 0.9.10 or greater.

      NOTE: At this time there is not yet an official release of the lmdb
      library, so this package includes a recent copy of the source code
      from the git repository that Makefile.PL will _try_ to compile and use
      for linking if the library and its header file isn't found installed.
      The library isn't supported in some platforms and its Makefile may need
      some work.
      
    * To run the test harness for this module:
      - You must make sure that the directory where you have untarred this module
      is NOT a network drive, e.g. NFS or AFS.
      - You need the Test::Exception and Test::ZeroCopy modules installed.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

*** WARNING ***
This is an early release to allow the interested people the testing and
discussion of the module: there is some missing features and you should
be aware that the API isn't in stone yet. See TODO


COPYRIGHT AND LICENCE

Copyright (C) 2013-2014 by Salvador Ortiz Garcia

This module is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.10.1 or,
at your option, any later version of Perl 5 you may have available.


