File	Date	Author	Commit
CORBA	2025-05-24	Oliver Kellogg	[573fd9] CORBA/IDLtree.pm : Synchronize with version 2.06.
orbit-ada-include	2024-04-26	Oliver Kellogg	[25f765] Harmonize FATFIFI text representation of arrays...
tests	2020-09-14	Oliver Kellogg	[ad2574] tests/cosnaming/Makefile
.gitignore	2020-04-04	Oliver Kellogg	[855660] orbit-ada-include/corba-object.ads
COPYING	2004-10-17	Oliver Kellogg	[c77265] Initial revision
NEWS	2011-07-17	Oliver Kellogg	[49f922] add news for 1.3
README	2011-07-16	Oliver Kellogg	[8ce9c9] Mention setting ORBIIOPUSock=0 in $HOME/.orbitrc
fatfixml.pl	2017-03-12	Oliver Kellogg	[ce3297] fatfixml.pl
idl2ada.pl	2025-04-20	Oliver Kellogg	[10cfde] CORBA/IDLtree/Comment_Directives.pm
orbit-idl2ada	2011-07-16	Oliver Kellogg	[84e944] use GNACK_ROOT in lieu of GNACK_HOME

Read Me

Welcome to GNACK, the GNU Ada CORBA Kit.

This version was tested with:
  - perl >= 5.003
  - ORBit2-2.14.4 (in turn requires >= glib-2.8.0),
  - various gnat versions, e.g. GNATGPL2005, gcc-4.1.0
    (GNACK is intended to be insensitive to the GNAT version.)

General preparations
--------------------

If you are trying to communicate non-locally or with another ORB
then put the following lines in the file $HOME/.orbitrc:
ORBIIOPUSock=0
ORBIIOPIPv4=1
ORBIIOPIPv6=1

This is required because by default, ORBit uses Unix domain sockets
for its communication. For further info, see question b.) at
http://orbit-resource.sourceforge.net/faq.html#orbit

How to build and run the Hello test
-----------------------------------

1)  Set the environment symbol GNACK_ROOT to point to 
    the location where you unpacked the GNACK distribution.
    E.g., in my case (using BASH syntax) this would be:

        export GNACK_ROOT=$HOME/gnack-2.0

2)  export ADA_INCLUDE_PATH=$GNACK_ROOT/orbit-ada-include:$ADA_INCLUDE_PATH
    (or equivalent setenv if using C shell)

3)  cd $GNACK_ROOT/tests/hello
    make

4)  In one window, type

        ./ada_server

    In another window, type

        ./ada_client orbit-local-orb

    The server creates a file named `iorfile' to which it writes its IOR
    string, and the client reads the iorfile.
    The other tests instead output the IOR to stdout when the ada_server
    is invoked. Supply this IOR as the parameter when invoking the
    ada_client.

Debugging
---------

ORBit2 has an environment variable, ORBIT2_DEBUG, that lets you see what's
going on in the ORB during program execution. For example,

$ export ORBIT2_DEBUG=traces

will give debug traces.  For the list of supported values, see function
ORBit_setup_debug_flags() in ORBit2 src/orb/orb-core/corba-orb.c .

--
okellogg@users.sourceforge.net