Changeset 1737


Ignore:
Timestamp:
Nov 14, 1999, 2:14:16 PM (26 years ago)
Author:
achimha
Message:

readme draft for public release

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/Readme.txt

    r1620 r1737  
    1 /* $Id: Readme.txt,v 1.8 1999-11-05 14:27:09 sandervl Exp $ */
    2 
    3 1999/11/05: Project Odin Source Code Notes
    4 ==========================================
     1/* $Id: Readme.txt,v 1.9 1999-11-14 13:14:16 achimha Exp $ */
     2
     3Project Odin Information
     4========================
     5
     61.0 Introduction
     7----------------
     8
     9This readme is intended for end users that have downloaded the
     10latest public alpha release and want to give it a try. For more
     11information, be sure to regularly check http://www.netlabs.org/odin.
     12
     131.1 Purpose
     14-----------
     15
     16Odin is a free Open Source project with the goal to eventually
     17provide a fully working Win32 (Win 95/98/NT/2000) runtime environment,
     18making it possible to run your favorite Windows programs under OS/2,
     19as if they were native OS/2 programs. The second goal of Odin is to
     20provide the full Win32 application programming interface (API) so
     21that it is possible to build OS/2 programs using Windows source
     22codes. This is also refered to as Odin32 whereas Odin is the name
     23of the Win32 binary emulator.
     24
     251.2 Current Status
     26------------------
     27
     28Odin is still in the early alpha state so that it is very far from
     29being widely usable. Most programs will not work or show many
     30problems. Even though it is not usable for most programs, we have
     31decided to do a public release in order to show how much progress
     32the project has been made. A second goal is to attract more developers
     33in order to speedup development. Our job includes rewriting most
     34parts of Windows 95/NT without having the original source codes so
     35the more developers we have the more progess will be seen. The
     36last public release (Alpha 0.004) has been in 1997 and the project
     37has changed much since then. Everything is free and Open Source now
     38and the base architecture has been improved quite a lot. We are now
     39in a position where we can expect the first bigger applications to
     40run well and to make much more visible progress.
     41
     42
     432.0 Using Odin to run your Windows applications
     44-----------------------------------------------
     45
     46Odin still has several ways to execute Win32 programs.
     47
     48
     492.1 The Ring3 Win32 Loader (PE.EXE)
     50----------------------------------
     51
     52This is the new and also recommended method for loading programs.
     53Unlike with the previous alphas, it is not required to convert or
     54anyhow change the original files. Installing a device driver is
     55also not necessary. Be sure to put the Odin binary directory into
     56both the PATH and LIBPATH (alternatively you can use a batch file
     57with SET PATH=C:\Odin\bin;%PATH% and SET BEGINLIBPATH=C:\Odin\bin;)
     58and then call pe.exe winprog.exe param1 param2 ... If you wanted
     59to start the Windows calculator, you would type
     60
     61pe calc
     62
     63The PE (Portable Executable, the Win32 executable format) loader
     64will now try to load the application into memory and execute it.
     65This will either work or fail with a loader message. If you get
     66such a loader message, it is very likely that a required DLL is
     67missing. To correct that problem, take a look at pe_0.log (or
     68pe_1.log for the second program running at this time and so on).
     69At the bottom of the file you will see the DLLs and the functions
     70that the loader imports. It will tell you if it couldn't find a
     71DLL and you can correct the problem and try it again.
     72
     73
     742.1.1 PE loader issues
     75----------------------
     76
     77As the PE loader will create the process and load the program,
     78a process utility such as pstat will always show PE.EXE as the
     79executable file.
     80It is also possible that a certain Win32 applications becomes
     81a zombie (that is when it does certain things the OS/2 kernel
     82cannot recover such as die when waiting on a semaphore). Then
     83it will not be possible to kill the application - only a system
     84restart will help.
     85Certain programs do use fixed memory addresses where they need
     86to be loaded (i.e. they won't use fixups). You can notice this
     87at the top of the loader log file (pe_0.log). If the fixed address
     88is above the 512MB barrier present in Warp 4 and Warp 3, the
     89program can not be run under these system. On Aurora (Warp Server
     90for e-business) this limitation has been removed. Programs known
     91to fall under this category are Microsoft Office (also the
     92Office viewers) and other mainly Microsoft programs.
     93
     94
     952.2 The Ring0 conversion utility driver (WIN32K.SYS)
     96----------------------------------------------------
     97
     98
     992.3 The Ring3 conversion utility (PE2LX.EXE)
     100--------------------------------------------
     101
     102PE2LX.EXE was the first method of running Win32 programs under
     103OS/2. It is still provided and also functional but it has been
     104deprecated. Using it is only sensible for debugging certain
     105problems as it requires all DLLs and EXEs to be converted into
     106another file format thus changing the original Win32 files.
     107
     108
     1093.0 Applications known to be working
     110------------------------------------
     111
     112- Windows 95/NT Help Viewer (winhlp32.exe)
     113- Windows 95/NT Registry Editor
     114- Windows NT Solitaire (not the one from Windows 95)
     115- Windows NT Freecell (not the one from Windows 95)
     116- Windows 95/NT Calculator
     117- Windows NT Pinball
     118- Quake II
     119- Red Alert
     120- Professional Minesweeper
     121- Windiff (part of Win32 SDK)
     122
     123
     124Project Odin Source Code Notes
     125==============================
    5126
    61271.0 Introduction
    … …  
    13134promising project.
    14135
    15 99/11/05: Sander van Leeuwen (sandervl@xs4all.nl)
    16 99/11/05: Patrick Haller     (phaller@gmx.net)
     13699/11/05: Sander van Leeuwen <sandervl@xs4all.nl>
     13799/11/05: Patrick Haller <phaller@gmx.net>
     13899/11/14: Achim Hasenmueller <achimha@innotek.de>
    17139
    18140
    … …  
    31153          (you need to register, but it's free)
    32154        - Unix-like rm.exe (nmake clean)
    33         - Watcom C/C++ can also be used for pe2lx
    34155
    35156Changes from last source code release:
    … …  
    147268examined problems.
    148269
    149 We suggest you subscribe to win32os2-WAI and the corresponsing mailing lists
     270We suggest you subscribe to win32os2-wai and the corresponsing mailing lists
    150271on http://www.egroups.com.
    151272In case you are interested in participating, every member of the project will
Note: See TracChangeset for help on using the changeset viewer.