DBD::Firebird -- DBI driver for Firebird RDBMS server.

  Copyright (c) 2010-2015  Popa Adrian Marius <[email protected]>
  Copyright (c) 2011-2013  Stefan Suciu <[email protected]>
  Copyright (c) 2011-2015  Damyan Ivanov <[email protected]>
  Copyright (c) 2011  Alexandr Ciornii <[email protected]>
  Copyright (c) 2010-2011  Mike Pomraning <[email protected]>
  Copyright (c) 1999-2005  Edwin Pratomo
  Portions Copyright (c) 2001-2005  Daniel Ritz

  You may distribute under the terms of either the GNU General Public
  License or the Artistic License, as specified in the Perl README file.
  (http://dev.perl.org/licenses/artistic.html)


REQUIREMENTS:
 - Perl (version 5.8.1 or higher)
 - Perl DBI (1.41 or higher)
 - Firebird (2.5.1 or higher)
 - A C compiler
   * UN*X
     GCC 4.x (tested, older may or may not work) or other capable
     clang

   * Windows
     - Strawberry perl (http://strawberryperl.com/) comes with it's own compiler (mingw)
     - Visual Studio C++ (http://visualstudio.com)
     - Cygwin
   * Freebsd
     - Threaded perl is required (You have to re-install perl from ports and you have to select the config
     option that says 'build a perl with threads')


*BEFORE* BUILDING, TESTING AND INSTALLING this you will need to:

 - Build, test and install Perl 5 (at least 5.8.1).

 - Build, test and install the DBI module (at least DBI 1.41).

   On Debian/Ubuntu you can do a simple:
     sudo apt-get install firebird2.5-dev libdbi-perl
   On OpenSUSE:
     sudo zypper in firebird firebird-devel perl-DBI
   On Fedora, Red Hat Enterprise Linux, CentOS and derivates:
     sudo yum install firebird firebird-devel perl-DBI

 - Remember to *read* the DBI README file if you installed it from source

 - Make sure that Firebird server is running (for testing telnet localhost 3050)
     sudo service firebird start


BUILDING:
 Win32/Win64 with Strawberry
   type 'dmake' from the console

 Win32/Win64 with MS compiler:
   type 'nmake', not just 'make'

 To Configure and build the DBD:
   perl Makefile.PL
   make

TESTING
 To run tests module Test::Exception is required on Debian/Ubuntu systems:
    sudo apt-get install libtest-exception-perl

 Please, set at least DBI_PASS (or ISC_PASSWORD), before 'make test'.
 The default for DBI_USER is 'SYSDBA'.(masterkey password is given here as example only)
   ISC_PASSWORD=masterkey make test

INSTALLING:
   make install