Topics:

Overview
Copyright
Supported Platforms
Unzipping

Overview:

The vbThread library is an additional component of the Variable Block Database (VBD) and Socket (VBS) libraries. This distribution is comprised of a collection of C++ classes used to build cross-platform multi-threaded applications as part of the VBD or VBS library or independently of either library.

VB Thread Library Features:

• WIN32/POSIX Interoperability
• Object-Oriented Design
• Thread Creation/Construction
• Thread Destruction
• Cancellation
• Exit
• Join
• Suspend
• Resume
• Sleep
• Priority Functions
• Thread Specific Storage
• Thread Pooling

Synchronization Classes:

• Mutex Locks
• Conditional Variables
• Semaphore Synchronization

Several example programs with makefiles for BCC32, MSVC, HPUX C++, and the GNU C++ compiler are provided to demonstrate each of the concepts presented. Release 1033 has been built and tested under Windows 95/98, HPUX 10.20, HPUX11, and RedHat Linux 5.2. All the documentation for the distribution is provided in an HTML format. The documentation covers the vbThread C++ class library and the example programs provided with this distribution. Parts of the documentation may be made available in other formats upon request.

Copyright and Warranty Information:

The VBD and VBS C++ classes are copyright (c) 1997 and 2000 by Douglas M. Gaer. All those who put this code or its derivatives in a commercial product MUST mention this copyright in their documentation for users of the products in which this code or its derivative classes are used. Otherwise, you have the freedom to redistribute verbatim copies of this source code, adapt it to your specific needs, or improve the code and release your improvements to the public provided that the modified files carry prominent notices stating that you changed the files and the date of any change.

VBD/VBS License Agreement

Supported Platforms:

The vbThread C++ class library and the example programs have been compiled and tested using the following platforms:

Windows 95/98 - using MSVC version 4.2
Windows 98 - using Borland C++ 5.5 for Win32
HPUX 10.20 - using HP CPP version 10.24
HPUX 11.0 - Using HP aC++ B3910B A.03.10
RedHat Linux 5.2 - using GNU g++ version egcs-2.90.29

Five different makefiles are provided in the source code directories to build the library examples and example programs:

msvc40.mak - for Microsoft Visual C/C++
bcc32 - for the Borland compiler
pux10.mak - for the HPUX C++ compiler
hpux11.mak - for the HPUX C++ compiler
gnu_gcc.mak - for the GNU C/C++ compiler

Unzipping The Distribution:

The entire distribution requires approximately 5 MB of free disk space to unzip. Two distributions are available, one for

Windows 95/98 and one for UNIX.

Windows 95:

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

C:\>mkdir vbsocket
C:\>copy vbt1033.zip c:\vbthread
C:\>cd vbthread
C:\vbthread>pkunzip -d vbt1033.zip

UNIX:

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

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

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

% gunzip vbt1033.tgz
% tar xvf vbt1033.tar

NOTE: You can use UNZIP for UNIX version 5.12 to unzip the Windows 95/98 distribution:

% mkdir vbthread
% cp vbt1033.zip vbthread\vbt1033.zip
% cd vbthread

% unzip -a -L vbt1033.zip

The unzip "-a" option will auto-convert any text files and the

"-L" option will make the directory and file names all lower case.