Package: OS2Linux Version: 0.2.0 Author: W. David Ashley IT Architect IBM Linux Technology Center dashley@us.ibm.com
Warning! Warning! Warning! Warning! Warning! Warning! Warning! Warning! Warning! Warning! Warning! Warning!
You should carefully read this documentation before installing or using the OS2Linux Package.
This software is subject to the terms of the GNU General Public License. You must accept the terms of this license to use this software. Refer to the file COPYING for more information.
This package provides a set of OS/2 header files to be used to recompile your OS/2 application and a Linux Shared Object library that supplies the application with the OS/2 Application Programming Interfaces (APIs).
The goals if this package are as follows:
Many people have contributed to this effort and I want to thank some of them here.
Kevin Bowkett - IBM Hursley Software Development LaboratoryOS2Linux is a runtime shared object library for Linux (think DLL) for console based applications. It provides the OS/2 base set of APIs in a dynamically linked runtime library. It also supplies a set of custom OS/2 header files to be used in place of the standard OS/2 header files during the compilation of your source code with the GCC compiler.
OS2Linux is a very powerful package that can allow your console-based OS/2 program to be ported to Linux with minimal modifications. The runtime shared library provides most of the APIs used in such applications and the compliation process will warn you when you attempt to compile a feature that is not available.
The following are some of the implementation goals for the OS2Linux Project.
To install the package on Linux, unzip/untar the contents to a temporary subdirectory. Copy/move the following files to these locations:
libos2.so -> /usr/lib or any location in the LD_LIBRARY_PATH *.h -> /usr/include or any location in the system include file search path
Be sure the libos2.so file is marked executable. Be sure the header files have the proper permissions.
To recompile your application you can use the OS2Linux test suite as an example. See the test suite makefile and C source files.
After recompiling your OS/2 application you are now ready to execute it.
The package was compiled under Fedora Core 1 using the standard GCC compiler installed from that distribution. You should compile your own module for your version of GCC and Linux.
The package was tested using
Date Author Description ---------- ----------- ----------------------------------------------------- 2004-09-06 WD Ashley v0.2.0 Alpha release
See the section Known Problems above.