Index Readme Library Examples Utilities Changes License Support Register

 Contents
Overview
Features
License
Supported Platforms
Supported Compilers
Package Map
Example Programs
Documentation
Unzipping
Building Static Libraries
Building Shared Libraries
Building WIN32 DLLs


 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
 B-tree 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 open-source archive is distributed under the OSI approved GNU Lesser General Public License (LGPL) with provisions for use in commercial and non-commercial applications under the terms of the LGPL. glNET Software as the original author and copyright holder of the DataReel open-source library offers an amendable run-time license for commercial users that cannot apply the terms of the LGPL to their application. Please submit any licensing questions to DataReel support. Please report any suspected licensing violations to glNET Software.

DataReel Copyright © 2001 glNET Software

Amenable Run-Time License
What is the RTL? The glNET Software run-time license (RTL) agreement is designed to meet the needs of developers when using open-source code and run-time libraries in commercial applications. It is intended to protect trade secret and company confidential information by allowing you to distribute binaries without any source code or references to the open-source copyright.

Who needs the RTL? No agreement supercedes the law so any valid licensing agreement must conform to local, state, federal, and/or international law. The RTL is a custom made agreement adapted to your specific needs accounting for applicable local, state, federal, and/or international laws relative to the terms of the agreement. If the terms of the open-source distribution agreement are too restrictive for your application or usage would constitute a violation of an existing law the RTL is a mechanism used to account for these obstacles that would otherwise prevent you from using the code. The RTL can also be adapted to customer supplied agreements.

Are there any RTL licensing fees? The source code and all subsequent versions are free to use with no royalties or reoccurring licensing fees. There is a one time processing fee of $29.00 US per license agreement. Additional costs may include legal fees only if required preparing the agreement. For information on obtaining the glNET Software RTL please contact:

glnet@glnetsoftware.com

glNET Software
P.O. Box 820314
South Florida, FL. 33082-0314
FAX: 413-622-7705

GNU Lesser General Public License
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


 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


 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


 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


 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