Initial commit

Author: drahosp

CMakeLists.txt

@@ -0,0 +1,13 @@
+# Copyright (C) 2011 LuaDist.
+# Created by Peter Drahos
+# Redistribution and use of this file is allowed according to the terms of the MIT license.
+# For details see the COPYRIGHT file distributed with LuaDist.
+# Please note that the package source code is licensed under its own license.
+
+PROJECT(oil C)
+CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
+INCLUDE(dist.cmake)
+
+INSTALL(DIRECTORY lua/oil DESTINATION ${INSTALL_LMOD})
+INSTALL(DIRECTORY doc/ DESTINATION ${INSTALL_DOC})
+INSTALL(DIRECTORY demo/ DESTINATION ${INSTALL_TEST})

HISTORY

@@ -0,0 +1,197 @@
+OiL 0.4 work1 [Tue, 27 Mar 2007]
+
+(a) Better architectural organization;
+(b) Deferred calls;
+(c) ORB shutdown operation;
+(d) Interception support;
+(e) More functional API;
+    	oil.main(function)
+    	oil.sleep(number)
+    	oil.newthread(function, ...)
+    	oil.newencoder()
+    	oil.newdecoder(string)
+(f) Better integrated CORBA IR:
+    	Ability to change IR definitions;
+    	Ability to load module parts using different 'oil.loadidl*' calls;
+    	Consistent storage of all IDL definitions, not only interfaces;
+    	Ability to import any definition from the remote delegated IR (oil.setIR);
+(g) Support for IDL large numbers: long long, unsigned long long, long double.
+    Lua must be changed so lua_Number is 'long double'.
+(h) Unix shell scripts for execution of demos.
+
+OiL 0.4 work2 [Fri, 06 Apr 2007]
+
+(a) Bugfix in single request processing (oil.step);
+(b) Bugfix in 'oil.narrow' without interface specification;
+(c) Bugfixes in 'union' marshal;
+(d) Better verbose message for calls with string arguments that contains
+    non-printable characters;
+(e) Better verbose level distribution:
+    	1: operation invocation and dispatching;
+    	2: GIOP request and reply processing;
+    	3: mutual exclusion channel access (concurrent mode);
+    	4: GIOP message creation and handling (i.e. send and receive);
+    	5: socket channels creation and handling (i.e. connection and reuse);
+    	6: value (un)marshaling;
+    	7: hexadecimal view of marshaled streams;
+    	8: creation of IDL table descriptors;
+(f) Automatically generated object keys always start with '\0';
+(g) A single Lua object can be used as implementation of different CORBA objects
+    created with automatic keys as long as they implement different interfaces
+    because object keys now contains the interface table hash-code. As a result
+    each time a Lua object is used as an object with a different interface
+    a new CORBA object is created for each interface, which will be the actual
+    (i.e. most specific) interface of the new CORBA object. To avoid implicit
+    creation of different CORBA objects with different interfaces for a simgle
+    Lua object, set the '__type' field of the objet meta-table (i.e. its
+    class) to the interface (repID, absolute name, IDL descriptor, or remote IR
+    object) that should be used;
+
+OiL 0.4 work2 (emergency update for OpenBus) [Thu, 19 Apr 2007]
+
+(a) Bugfix in 'loop.thread.Timer' that prevents the timer thread to end after
+    first execution;
+(b) Bugfix in channel mutual exclusion control for receiving replies;
+(c) Addition of field 'oil.tasker' to get the coroutine scheduler component
+    used by OiL;
+(d) Better verbose message in request invocation;
+
+OiL 0.4 work3 [Wed, 25 Apr 2007]
+
+(a) New version of LUAIDL (0.7.4b);
+(b) Bugfix: possible name collision of a host name 'retrieve' with an internal
+    method of a data structure that holds information about hosts;
+(c) Bugfix: missing upvalue in 'reset' method of non-wrapped sockets
+    (non-concurrent mode);
+(d) Bugfix: allow creation to proxies to 'CORBA::Object' references;
+(e) Bugfix in channel mutual exclusion control for sending replies of erroneous
+    requests (e.g. invalid object key, wrong interface, location forward, etc);
+(f) Bugfix: correction of verbose messages for invocation and dispatch of
+    methods that take string parameters;
+(g) 'oil.narrow' and 'proxy:_narrow' now accepts any valid interface
+    specification, i.e. repID, absoulute name, IDL descriptor, or remote IR
+    object;
+(h) Support for marshaling of typecode 'null' and therefore anys containing
+    values of type 'null';
+(i) 'nil' values used as 'any' are automatically coded as 'null';
+(j) The interface of an implicitly created CORBA object can also be defined by
+    field '__type' of the object implementation itself (in older versions,
+    only the '__type' field of the metatable could be used);
+(k) Restore object implementation when an IOR is found that references the ORB
+    itself. If the object was created implicitly or with an automatic object key
+    then the object implementation is returned otherwise the CORBA object table
+    is returned (i.e. not a proxy but the object originally returned by
+    'oil.newservant');
+(l) The function used to handle exceptions can be defined for all proxies of a
+    given interface by function 'oil.setexcepthandler(handler [, interface])'.
+    If no interface is provided then the handler is set for all proxies.
+    Previously, this handler could only be set for individual proxies by field
+    '__exceptions';
+(m) Now, if the exception handler function returns (i.e. not raise a Lua error)
+    then the exception is ignored and the values returned are used as the
+    results of the invocation that raised in the original exception;
+(n) Addition of 'oil.deactivate(<corbaobj | implobj | objkey> [, interface])'
+    that removes an object from the ORB;
+
+OiL 0.4 work4 [Fri, 08 Jun 2007]
+
+(a) Bugfix: addition of missing required libraries;
+(b) Bugfix: exceptions members were not loaded into the repository;
+(c) Bugfix: verbose message generation;
+(d) Bugfix: correction of the object returned by interception;
+(e) Bugfix: local CORBA exceptions are generated with proper repID;
+(f) Bugfix: handling of object forwarding in concurrent mode;
+(g) Support for proper handling of location request messages;
+(h) Automatic reconnections when connection is closed. WARNING: Operation
+    invocation may be issued many times if no reply is sent (no at-most-once
+    guarantees);
+
+OiL 0.4 work5 [Fri, 18 Jul 2007]
+
+(a) Bugfix in invocation error handling.
+(b) Bugfix in oneway invocations.
+(c) Bugfix in verbose message generation.
+(d) Bugfix in generation of local exceptions' repID.
+(e) Bugfix in verification of values being marshaled.
+(f) Bugfix in marshal of 'any'.
+(g) Bugfix in interface definition import from a remote Interface Repository
+(h) Bugfix in union field access.
+(i) Bugfix in absolute name resolution ('lookup' operation).
+(j) Bugfix in stream read when operation yields due to a full buffer.
+(k) Bugfix to allow servants to implement implicit operations (e.g. CORBA's
+    operations that start with '_')
+(l) Any's now provide the field _anytype to identify the IDL type of the value.
+(m) Utility script to create Lua scripts that feed the internal IR from IDL files.
+(n) OiL internal components are available through the 'oil' module itself
+    instead of field 'oil.Components'.
+(o) API operation 'oil.newobject' becomes 'oil.newservant'. However, the alias
+    'oil.newobject' is provided for compatibility.
+(p) OiL internal coroutine scheduler is accessible through field  'oil.tasks'
+    instead of 'oil.scheduler'.
+(q) OiL internal interface repository is accessible through field  'oil.types'.
+(r) CORBA interception is disabled by default. See demo 'interceptors' for
+    information about how to enable it.
+(s) Rules to strip and reinsert verbose support from OiL's code.
+
+OiL 0.4 work6 [Wed, 1 Aug 2007]
+
+(a) Bugfix in array description registration in the internal Interface
+    Repository.
+(b) Bugfix in 'oil.pcall' in CORBA interception mode.
+(c) Bugfix in script 'idl2lua.lua' by an improvement to avoid that global
+    functions be serialized as module members.
+(d) Bugfix in select function wrapper. The error was not detected before due to
+    strange behavior of LuaSocket that returned ordinary tables inserted in
+    function arguments just like ready sockets.
+(e) Bugfix in importation of remote exception's members.
+(f) Bugfix in builder error handling.
+(g) Bugfix in verbose message generation and removal of redundant verbose
+    messages.
+(h) Bugfix: select calls that executed without yielding returned socket objects
+    instead of socket wrappers that implement scheduler integration.
+(i) Bugfix in TypeCode marshaling with indirections. Indirections cannot span
+    across the top-most TypeCode boundaries. Improvement in verbose messages to
+    avoid printing non-printable characters.
+(j) Exceptions created with oil.newexcept now can contain exceptions's abosule
+    name instead of repID.
+(k) oil.setexcatch(func, iface) receives any interface identification (repID,
+    absolute name, remote IR object, etc.)
+(l) Performance improvement by use of 'tcp-nodelay' option.
+
+OiL 0.4 work7 [Tue, 21 Aug 2007 - r66613]
+
+(a) Bugfix in handling of system exceptions raised by servants.
+(b) Bugfix in verbose message generation
+(c) Bugfix in serialization of long long type descriptor in 'idl2lua' script.
+(d) Bugfix to avoid that attributes be indexed through proxies.
+(e) Bugfix: channel is stored in the reference object to avoid retrieve the
+    channel at each new invocation.
+(f) Bugfix: Verbose class use a specific Viewer instance to avoid changing the
+    Viewer class' behavior.
+(g) Standard system exceptions are loaded into the internal IR.
+(h) Improvement to allow creation of GIOP Exceptions without body.
+(i) Sequences containing 'nil' can have the 'n' field to indicate the number of
+    elements.
+(j) Implementation of _is_equivalent operation of CORBA references.
+(k) Object references with unknown types are created with field 'type_id' set to
+    ''.
+(l) Improvement by addition of 'cosocket' verbose tag as a new level of verbose
+    in Scheduler verbose.
+(m) New demo about exception handling.
+
+OiL 0.4 work8 [Tue, 4 Sep 2007 - r67052]
+
+(a) Bugfix in Ludo protocol to work with object keys that contains null
+    characters.
+(b) Bugfix to allow use with typeless protocols like Ludo.
+(c) New operation 'oil.tasks:halt()' to stop the coroutine scheduling.
+(d) Operation 'oil.deactivate' fails quietly allowing the application to
+    deactivate an servant many times without getting an error.
+(e) Sequences returned by OiL now have the 'n' field set properly to handle
+    sequences with nil values like sequence of objects or anys.
+(f) Support for commands 'step', 'step"in"', 'step"out"' and break points
+    ('mkbp(<file>,<line>)', 'rmbp(<file>,<line>)', 'lsbp') in debug console of
+    'oil.verbose:debug()'.
+(g) Use of package 'socket.core' instead of 'socket' package due to unused
+    functions provided by the former package.
+(h) Update of the demo 'hello_simple' to use the Ludo protocol.

INSTALL

@@ -0,0 +1,11 @@
+This is OiL 0.5 release.
+
+* Installation
+  ------------
+  Building OiL on Unix systems should be very easy:
+
+        1. Read "config" and edit it to suit your platform and needs.
+        2. Pick one of the platforms that better suits you and do "make <plat>".
+        3. If you want to install OiL in an "official" place in your system,
+           then do "make install". The official place and the way to install
+           files are defined in "config". You may have to be root to do this.

LICENSE

@@ -0,0 +1,31 @@
+OiL License
+-----------
+
+OiL is licensed under the terms of the MIT license reproduced below.
+This means that OiL is free software and can be used for both academic
+and commercial purposes at absolutely no cost.
+
+===============================================================================
+
+Copyright (C) 2004-2009 Tecgraf, PUC-Rio.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+===============================================================================
+
+(end of LICENSE)

Makefile

@@ -0,0 +1,114 @@
+# makefile for installing OiL
+# see INSTALL for installation instructions
+# see config and src/Makefile for further customization
+
+include config
+
+# Installation directories
+INSTALL_DIR= $(INSTALL_INC) $(INSTALL_LIB) \
+             $(INSTALL_LMOD) $(INSTALL_CMOD) \
+             $(INSTALL_CMOD)/socket $(INSTALL_CMOD)/oil
+
+all: $(PLAT)
+
+$(PLATS) all o a so clibs precomp preload clean:
+	cd src; $(MAKE) $@
+
+install: clibs $(INSTALL_DIR)
+	cd lua; $(INSTALL_DATA) $(TOLUA) $(INSTALL_LMOD)
+	cd src; $(INSTALL_DATA) $(TOINC) $(INSTALL_INC)
+	cd src; $(INSTALL_DATA) $(TOLIB) $(INSTALL_LIB)
+	cd src; $(INSTALL_EXEC) $(TOSOL) $(INSTALL_LIB)
+	cd $(INSTALL_LIB); for n in $(TOSOL); do $(INSTALL_COPY) $$n $${n%%.*}.so; done
+	cd $(INSTALL_CMOD)/socket; $(INSTALL_COPY) $(INSTALL_LIB)/libluasocket.$(vSOCK).so core.so;
+	cd $(INSTALL_CMOD)/oil   ; $(INSTALL_COPY) $(INSTALL_LIB)/liboilbit.$(vOIL).so     bit.so;
+
+install-precomp: precomp $(INSTALL_INC) $(INSTALL_LIB) $(INSTALL_CMOD)
+	cd src; $(INSTALL_DATA) $(PCINC) $(TOINC) $(INSTALL_INC)
+	cd src; $(INSTALL_DATA) $(PCLIB) $(INSTALL_LIB)
+	cd src; $(INSTALL_EXEC) $(PCSOL) $(INSTALL_LIB)
+	cd $(INSTALL_LIB); for n in $(PCSOL); do $(INSTALL_COPY) $$n $${n%%.*}.so; done
+	cd $(INSTALL_CMOD); for n in $(LLIBS); do $(INSTALL_COPY) $(INSTALL_LIB)/lib$(LIBPFX)$$n.so $${n%%.*}.so; done
+
+install-preload: preload $(INSTALL_INC) $(INSTALL_LIB)
+	cd src; $(INSTALL_DATA) $(PLINC) $(INSTALL_INC)
+	cd src; $(INSTALL_DATA) $(PLLIB) $(INSTALL_LIB)
+	cd src; $(INSTALL_EXEC) $(PLSOL) $(INSTALL_LIB)
+	cd $(INSTALL_LIB); $(INSTALL_COPY) $(PLSOL) $(call modname,$(PLSOL)).so
+
+local:
+	$(MAKE) install INSTALL_TOP=.. INSTALL_EXEC="cp -p" INSTALL_DATA="cp -p"
+
+no-verbose:
+	for f in `find lua/ -iname "*.lua"`; do sed -i -e "s/\-\-\[\[VERBOSE\]\]/-- [[VERBOSE]]/g" $$f; done
+	for f in `find lua/ -iname "*.lua"`; do sed -i -e "s/\-\-\[\[DEBUG\]\]/-- [[DEBUG]]/g" $$f; done
+
+verbose:
+	for f in `find lua/ -iname "*.lua"`; do sed -i -e "s/\-\- \[\[VERBOSE\]\]/--[[VERBOSE]]/g" $$f; done
+	for f in `find lua/ -iname "*.lua"`; do sed -i -e "s/\-\- \[\[DEBUG\]\]/--[[DEBUG]]/g" $$f; done
+
+none:
+	@echo "Please do"
+	@echo "   make PLATFORM"
+	@echo "where PLATFORM is one of these:"
+	@echo "   $(PLATS)"
+	@echo "See INSTALL for complete instructions."
+
+# create installation dirs
+$(INSTALL_DIR):
+	mkdir -p $@
+
+env:
+	@echo ""
+	@echo "Add the following paths to the proper enviroment variables to set up OiL $(vOIL):"
+	@echo ""
+	@echo "LUA_PATH  += ';$(INSTALL_LMOD)/?.lua'"
+	@echo "LUA_CPATH += ';$(INSTALL_CMOD)/?.so'"
+	@echo ""
+
+# echo config parameters
+echo:
+	@echo ""
+	@echo "These are the parameters currently set in src/Makefile to build OiL $(vOIL):"
+	@echo ""
+	@cd src; $(MAKE) -s echo
+	@echo ""
+	@echo "These are the parameters currently set in Makefile to install OiL $(vOIL):"
+	@echo ""
+	@echo "INSTALL_TOP = $(INSTALL_TOP)"
+	@echo "INSTALL_BIN = $(INSTALL_BIN)"
+	@echo "INSTALL_INC = $(INSTALL_INC)"
+	@echo "INSTALL_LIB = $(INSTALL_LIB)"
+	@echo "INSTALL_LMOD = $(INSTALL_LMOD)"
+	@echo "INSTALL_CMOD = $(INSTALL_CMOD)"
+	@echo "INSTALL_EXEC = $(INSTALL_EXEC)"
+	@echo "INSTALL_DATA = $(INSTALL_DATA)"
+	@echo "INSTALL_COPY = $(INSTALL_COPY)"
+	@echo ""
+
+# echo private config parameters
+pecho:
+	@echo "TOLUA = $(TOLUA)"
+	@echo "TOINC = $(TOINC)"
+	@echo "TOLIB = $(TOLIB)"
+	@echo "TOSOL = $(TOSOL)"
+	@echo "PCINC = $(PCINC)"
+	@echo "PCLIB = $(PCLIB)"
+	@echo "PCSOL = $(PCSOL)"
+	@echo "PLINC = $(PCINC)"
+	@echo "PLLIB = $(PCLIB)"
+	@echo "PLSOL = $(PCSOL)"
+
+# echo config parameters as OiL code
+# uncomment the last sed expression if you want nil instead of empty strings
+lecho:
+	@echo "-- installation parameters for OiL $(vOIL)"
+	@echo "VERSION = '$(vOIL)'"
+	@$(MAKE) echo | grep = | sed -e 's/= /= "/' -e 's/$$/"/' #-e 's/""/nil/'
+	@echo "-- EOF"
+
+# show what has changed since we unpacked
+newer:
+	@find . -newer MANIFEST -type f
+
+# (end of Makefile)