IOLib-Filters version 4.0

Official homepage: http://iolib.sourceforge.net
eMail: robert.kausch@gmx.net

This software is released under the terms of the GNU Library General Public License (LGPL). See the file 'Copying.lib' for details.

Contents

- What's new in IOLib-Filters 4.0
- About the author
- What is IOLib-Filters?
- How do I use it?
- Reporting bugs

What's new in IOLib-Filters 4.0

The following things have been added or changed since IOLib-Filters release 4.0-pre1:

- some adjustments for IOLib 4.0
- the library has been ported to FreeBSD, Tru64 Unix and Solaris

About the author

IOLib was written by Robert Kausch. You can contact me at robert.kausch@gmx.net.

I am an 18 year old student from Lueneburg/Germany. I started writing computer programs in 1994. My first programming language was QBasic (it was part of MS-DOS). In 1996 I started to write Windows applications with GFA-Basic (a mixture of Basic, Pascal and C). After a hard disk failure in mid 1998 nearly all my source code was lost and so I bought a book about C++ and started learning.
Currently I'm maintaining two OpenSource projects. SMOOTH and IOLib.

What is IOLib-Filters?

IOLib-Filters is a set of data filters for IOLib. IOLib-Filters includes filters for encryption/decryption, compression/decompression and image file IO. It's also a good example of writing filters for IOLib.

How do I use it?

First you have to compile IOLib-Filters for your system. Since this release, IOLib-Filters is compatible with the following operating systems and compilers:
- Linux GCC
- Windows GCC-MinGW32 (no shared Objective C library)
- Windows GCC-Cygwin (no shared Objective C library)
- Windows MS Visual C++ (C and C++ libraries only)
- Windows Borland C++ (static C and C++ libraries only)
- Windows LCC-Win32 (C libraries only)
- BeOS GCC
- QNX GCC
- DOS GCC-DJGPP (static libraries only, no socket support)
- FreeBSD GCC
- Tru64 Unix Compaq C (static C library only)
- Solaris GCC
- possibly some others, porting should be easy
If you want to have your compiler/OS supported send me a download URL or send a copy to my home address (ask for it via eMail).

Just type 'make' ('nmake' for MSVC, 'make -s' for LCC) in the distribution directory to get a list of the available targets. Then type 'make [target]' to compile IOLib-Filters for your system and programming language.
IOLib-Filters depends on the IOLib headers and libraries. You should create a directory structure which looks like the following before you build IOLib-Filters:

/$(your_src_directory)/iolib
/$(your_src_directory)/iolib-filters

Please compile IOLib first. If you have installed the IOLib headers and libraries somewhere where your compiler and linker can find them, it might work without all this (at least on GCC targets).
After you have compiled IOLib-Filters you can type 'make [target]-install' to install the library in the default prefix (usually /usr/local or /usr) and optionally 'make [target]-clean' to clean the build directory.
You can change the install prefix by editing the toplevel makefile.

If you do not know how to use external filters with IOLib, then have a look at the IOLib documentation please.

Reporting bugs

If you think you've found a bug in IOLib-Filters please submit a full bug report including a detailed description of how to reproduce the bug (it would be very nice if you included the source code that produces the bug in your report). If possible, please write a patch that fixes the bug and send it along with the report.

If you have found any bugs in IOLib please contact me at robert.kausch@gmx.net.

Please visit the official IOLib homepage at
iolib.sourceforge.net and try the newest release of IOLib-Filters first!