Index | Readme | Library | Examples | Utilities | Changes | License | Support | Register

Contents

Overview Features License Supported Platforms Supported Compilers Package Map Example Programs Documentation Unzipping

Overview

What is DataReel?
DataReel is a free cross-platform database and communications toolkit used to rapidly develop and deploy multi-threaded database and communications applications. The DataReel toolkit is composed of a modular C++ library designed to build cross-platform infrastructures for end-user applications, embedded systems, and reusable libraries. It was produced by independent work and contract work released to the public through non-exclusive license agreements. The initial work began independently in 1997 and was augmented from 1999 to 2001 by code produced under contract to support various applications.

Why Use DataReel?
DataReel is simple. DataReel simplifies complex time consuming database, socket, and multi-threaded programming tasks. DataReel is flexible. Using DataReel gives your developers the flexibility to develop core application components independently of complex user interfaces. DataReel is portable. DataReel not only offers portability but also interoperability between multiple platforms. DataReel is modular. DataReel is a modular approach to network and database programming making code adaptation and cross-platform testing easy.

Who Can Use DataReel?
The DataReel toolkit is available to commercial, individual, and academic developers.

Who Can Contribute?
The DataReel project accepts bug-fixes, enhancements, and additions from all developers.

Features

Database | Sockets | Threads | General
WIN32/UNIX Interoperability nbsp;32-Bit DB Engine 64-Bit DB Engine Large file support CRC Checking Portable File Locking Portable Record Locking Btree Indexing Persistent Objects Supports OODM Design Supports RDBMS Design Supports Multi-threading Supports Client/Server Apps Built-in Network Database Real-time TCP Streaming Real-time UDP Streaming RS232 streaming | WIN32/UNIX Interoperability Winsock/BSD Wrappers Object-Oriented Design Stream Sockets Datagram Sockets RS232 Support Supports Multi-threading Embedded Ping Embedded FTP Embedded Telnet Embedded SMTP Embedded POP3 Embedded HTTP URL Parsing HTML Parsing HTML Generator Base 64 Encoding | WIN32/UNIX Interoperability Windows/POSIX Wrappers Object-Oriented Design Thread Creation/Construction Thread Destruction Cancellation Exit Join Suspend Resume Sleep Priority Functions Thread Specific Storage Thread Pooling Mutex Locks Conditional Variables Semaphore Synchronization | String Classes Memory Buffers Device Caching Linked List Classes Binary Search Tree Stack Classes Queue Classes Date/Time Classes Data Encryption Configuration Manager Log Generator Postscript Text Generator Portable TERM I/O Text Utilities String Utilities Portable Directory Funcitons Portable File Functions

License

The DataReel library is copyrighted by glNET Software, Copyright © 2001, all rights reserved. DataReel is an open source library available to commercial, individual, and academic developers. The source code is distributed under the GNU Lesser General Public License. Proprietary and non-restricted commercial licensing agreements are available from glNET Software. Please direct any licensing questions to DataReel support.

DataReel Copyright © 2001 glNET Software

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

GNU Lesser General Public License

Supported Platforms

The following is the current list of operating systems used for development and cross-platform testing. If the operating system you are using is not listed please contact DataReel support as this list may change without notice.

Supported and Original Test Platforms

- HPUX 10.20
- HPUX 11.0
- MSDOS 6.22 (Limited Support)
- Red Hat Linux 7
- SunOS 5.8
- Windows 95A
- Windows 95C
- Windows 98
- Windows 98 SE
- Windows NT 4.0 Server
- Windows NT 4.0 Workstation

Supported Compilers

The following is the current list of compilers used for development and cross-platform testing. If the compiler you are using is not listed please contact DataReel support as this list may change without notice.

C++ Compiler list

- HPUX Native C++ Compiler - HP C++ HPCPLUSPLUS A.10.27
- HPUX Native C++ Compiler - HP aC++ B3910B A.03.30
  HP aC++ B3910B A.03.27 Language Support Library
- 16-Bit MSDOS C++ Compiler - MSVC 1.52 (Limited Support)
- 32-Bit MSDOS C++ Compiler - DJGPP 2.7.2.1 (Limited Support)
- 32-Bit Windows C++ Compiler - MSVC 4.2, MSVC 5.0, MSVC 6.0 SP3, BCC32 5.5
- RedHat C++ Compiler - gcc version 2.96 20000731 (Red Hat Linux 7.0)
- Solaris Native C++ Compiler - Sun WorkShop C++ 5.0 (4.2 compatibility mode)

Package Map

The DataReel Windows and UNIX archives are identical and can be unpacked on either platform depending on the decompression tools available to you. In order to remain consistent with multiple archiving schemes all files and directories conform to the ISO 9660 8.3 naming convention. The directory structure for the distribution is as follows:

DataReel Directory

- bin - Empty directory used to store executables
- contrib - Empty directory used to install contribution packages
- docs - Directory for all DataReel documentation sets
- env - Makefile includes used to build modules and libraries
- examples.gen - General support example programs
- examples.db - Database example programs
- examples.mt - Thread examples programs
- examples.soc - Socket example programs
- include - DataReel include files
- lib - Empty directory used to install library files
- src - DataReel source code files
- utils - DataReel utility programs

Example Programs

The DataReel library includes over 100 console based example programs. The examples are fully functional programs used to test and demonstrate each component of the library individually. The example programs are located within subdirectories of the "examples.gen", "examples.db", "examples.mt", and "examples.soc" directories. A separate makefile is included for each supported C++ compilers. NOTE: If you build an example using your IDE please refer to the example's makefile for all required "-D" define macros.

WIN32 Makefiles
msvc.mak - Microsoft Visual C/C++ 4.2 and higher
bcc32.mak - Borland BCC32 5.5

UNIX Makefiles
hpux10.mak - HPUX front-end compiler
hpux11.mak - HPUX aCC compiler
linux.mak - gcc compiler
solaris.mak - Sun WorkShop C++ compiler

Documentation

The DataReel documentation set covers the class library, example programs, and the utility programs. The class library is documented by category with a detailed description and usage note for each function. The DataReel example programs have been converted to an HTML format with comments/remarks denoted by red lettering. Utility programs are documented with a brief description and usage information.

The complete DataReel documentation set is available in an HTML format. Parts of this documentation set may be produced in other formats and re-distributed with applicable source code modules. The DataReel HTML documentation set is distributed with each DataReel source code distribution. Updated versions and all changes are posted to the DataReel Web Site:

http://www.datareel.com/docs.htm

Unzipping

The entire DataReel distribution requires approximately 8 MB of free disk space to unpack. Two distributions are available, one for Windows and one for UNIX. The DataReel Windows and UNIX archives are identical and can be unpacked on either platform depending on the decompression tools available to you.

Windows Installation
To unpack this distribution on a Windows platform you will need a copy of PKZIP version 2.03 for DOS or WINZIP version 6.1 or higher for WIN32. To unzip using PKZIP 2.03 follow these instructions:

    C:\>mkdir datareel
    C:\>copy dreelXXX.zip c:\datareel
    C:\>cd datareel
    C:\datareel>pkunzip -d dreelXXX.zip

UNIX Installation
To unpack this distribution you need a copy GZIP/GUNZIP version 1.2.4 or higher. To unpack using GZIP and the UNIX tar utility follow these instructions:

    % gzip -d dreelXXX.tgz
    % tar xvf dreelXXX.tar

To unpack using GUNZIP and the UNIX tar utility follow these instructions:

    % gunzip dreelXXX.tgz
    % tar xvf dreelXXX.tar

NOTE: You can use also UNZIP for UNIX version 5.12 to unpack the zip archive:

    % mkdir vbdbase
    % cp dreelXXX.zip datareel/dreelXXX.zip
    % cd datareel

    % unzip -a -L dreelXXX.zip

The unzip "-a" option will auto-convert all text files to a UNIX format and the "-L" option will make the directory and file names all lower case.

DataReel Copyright © 2001 glNET Software, All Rights Reserved