S A N K H Y A

Copyright (c) 2002 Sankhya Technologies Private Limited.
All rights reserved.

SANKHYA Varadhi: Development Notes for using SANKHYA Varadhi for OSE
====================================================================

   SANKHYA Varadhi has been ported to OSE Delta SoftKernel and PowerPC 
   environments. Applications can be developed using SANKHYA Varadhi for OSE
   SoftKernel using VC++ 6.0 and for OSE PPC using g++ 2.95.2.

   Refer to OSE 4.4.1 documents for Setting up OSE 4.4.1 environment.

   Refer to the main samples README for OSE in $VARADHI/samples/ose directory
   ( %VARADHI%\samples\ose on Windows host ) to setup Varadhi Target Platform,
   to build and execute the demo.


Pre-requisites

     a. OSE SoftKernel (sfk-win32)

        Host    : x86 PC
        Host OS : Windows NT 4.0 / Windows 2000
        Tools   : VC++ 6.0.

     b. OSE PPC (Windows Host)

        Host    : x86 PC
        Host OS : Windows NT 4.0 / Windows 2000
        Tools   : g++ 2.95.2 adapted for OSE, Cygwin 1.1.2, Binutils 2.9.1,
                  Newlib 1.8.2 adapted for OSE and VC++ 6.0.

     c. OSE PPC (Unix Host)

        Host OS : Solaris 2.6 and above on Sun Sparc Workstation,
                  Linux 2.0.x and above on x86 Linux PC
        Tools   : g++ 2.95.2 adapted for OSE and Newlib adapted for OSE


Using Varadhi for OSE.

   Varadhi is ported to work on OSE environment using INET as the transport
   layer. Varadhi for OSE is single threaded, i.e. no two Varadhi applications
   can be loaded as separately linked load modules. While Varadhi is single
   threaded, it can co-exist with other threads in the system.

   Varadhi OSE demos work as OSE Autostarted Monolith application. The server
   'main' and client 'main' run as a OSE prioritized process. 

   Varadhi for OSE is tested on SoftKernel and Motorola MBX860.

   Varadhi Platform is intergrated with OSE dmake makefile concepts. OSE
   examples makefile is modified to intergrate Varadhi platform. A dmake
   makefile varadhi_ose.mk is provided for Varadhi specific build rules.
   Varadhi OSE demos are built just like any other OSE example program
   using dmake.

   Refer to the main samples README for OSE in $VARADHI/samples/ose directory
   ( %VARADHI%\samples\ose on Windows host ) to setup Varadhi Target Platform,
   to build and execute the demo.


Limitations:

     * Varadhi for OSE PPC will work only if C++ Exceptions are disabled using
       -fno-exception option in g++ 2.95.2.

     * Cygwin based developement required OSE_ROOT variable to be changed to
       Unix path format. 

       To workaroud this, a new environment variable, say OSE_ROOT_ALT_PATH,
       with Unix format path can be used. Then, the make include file 
       ppc-gcc-ose.inc in $VARADHI/etc (%VARADHI%\etc in Windows) directory 
       should be changed to use OSE_ROOT_ALT_PATH instead of OSE_ROOT.

     * Including stdlib.h results in compiler error while building the
       application in Windows SoftKernel. This is because malloc.h, which is
       included by stdlib.h, defines a macro "free' which clashes with the 
       method 'free()' in t_var.h.

       To workaround this problem, in the application code, before including
       the stub/skeleton include files, undefine the macro 'free'.