README

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

   Copyright (c) 2010-2015  Popa Adrian Marius <mapopa@gmail.com>
   Copyright (c) 2011-2013  Stefan Suciu <stefbv70@gmail.com>
   Copyright (c) 2011-2015, 2017, 2024, 2025  Damyan Ivanov <dmn@debian.org>
   Copyright (c) 2011  Alexandr Ciornii <alexchorny@gmail.com>
   Copyright (c) 2010-2011  Mike Pomraning <mjp@pilcrow.madison.wi.us>
   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