ILU 2.0alpha14 Reference Manual

Bill Janssen <janssen@parc.xerox.com>

Mike Spreitzer <spreitzer.parc@xerox.com>

Dan Larner <larner.parc@xerox.com>

Chris Jacobi <jacobi.parc@xerox.com>

ILU Concepts
- What ILU Does
- How ILU Works
- Core ILU Concepts
- ILU and OMG CORBA
Defining Interfaces
- General Syntax of ISL
  - Identifiers
  - Reserved Words
- Statement Syntax
- ilu.isl
- Using OMG IDL with ILU
  - Translation
  - Manual Invocation of idl2isl
- ISL Grammar
Using ILU with Standard C
- Introduction
- The ISL Mapping to C
- Access to Standard ILU Features
- Building C/ILU Applications
- ILU C API
Using ILU with Python
- Introduction
- The ISL Mapping to Python
- Access to standard ILU features
- Building Python/ILU Applications
- Python/ILU API Reference
Using ILU with CORBA 2.0 C++
- Warning
- Introduction
- Mapping ILU ISL to C++
- Concepts
- Building an Application
- Relevant examples
- Runtime Classes
- CORBA 2.0 C++ Considerations
  - ORB_init
Using ILU with C++
- Introduction
- Mapping ILU ISL to C++
- Using an ILU module from C++
- Implementing an ILU Module in C++
- ILU API for C++
- Generating ILU stubs for C++
  - Tailoring C++ Names
- Threading
- Other ILU Considerations For C++
Using ILU with Java
- Introduction
  - ILU and CORBA
- The ISL Mapping to Java
- Access to standard ILU features
- Building ILU-for-Java Applications
- Notes for ILU for Java in applets
- Notes for Java on particular architectures
- CosNaming
  - CosNaming Naming Server
  - Bootstrapping with CosNaming
- ILU for Java Reference
  - javadoc documentation
    - Build of the javadoc documentation
  - Description of Java classes
- Full Custom Mapping
  - Java objects by value, Java marshalled objects
    - Interoperability of Java objects by value, Java marshalled objects
Using ILU with Common Lisp
- Introduction
- The ISL Mapping to Common Lisp
- Access to standard ILU features
- Building Common Lisp/ILU Applications
- Common Lisp/ILU API Reference
Using ILU with Scheme (Guile)
- Introduction
- The ISL Mapping to Scheme
- Access to standard ILU features
- Building Scheme/ILU Applications
- Scheme/ILU API Reference
Using ILU with Microsoft Windows
- Prerequisites for using ILU with Microsoft Windows
  - Using ILU applications on Windows NT and Windows 95
  - Prerequisite software to use AND develop ILU applications on Windows NT and 95.
- Installation
- Building ILU
- Building the examples
- Running the examples
- Developing Windows Applications with ILU
- Windows and the ILU_DEBUG settings
  - WINIO
- Misc.
- Files in the distribution
Binding Names in ILU
- Introduction
- ILU Simple Binding
- CORBA CosNaming
Threads and Event Loops
- Multi-Threaded Programs
- Single-Threaded Programs
- Threadedness in Distributed Systems
Protocols and Transports
- Protocols
- Transports
Security
- Identities
- Communications Security
- Using the GSS Transport Filter
  - GSS Namespace Schemes
  - GSS Security Schemes
ILU Customization
- Introduction
- Event Loops and Threads
- RPC Protocols and Data Transport Mechanisms
  - RPC Protocols
  - Transport Filters
- Object Incarnation Procedures
- Object URLs
- Identity Types
- Malloc Failure Recovery
- Error Reporting
- Debugging Interfaces
Debugging ILU Programs
- C++ static instance initialization
- ILU trace debugging
- Debugging ISL
  - Use of islscan
  - The ISLDEBUG environment variable
- Bug Reporting and Comments
- Use of gdb
- Error handling
  - Decoding reportable consistency check failures
- Common Problems - Questions
Installation of ILU
- Installing on a Windows NT or 95 System
- Installing on a UNIX System
- Examples
- Name Servers
- Documentation
- Mailing Lists
- Changes
- Bug Reporting and Comments
  - Known Bugs and Gotchas
  - Reporting Bugs
Multiple Languages In One Address Space
- Dueling Runtimes
- Module Initialization
- Finding Objects
Using Imake with ILU
- Creating `Makefile's from `Imakefile's
- ANSI C Usage
  - ANSI C ILU imake Macros
- C++ Usage
  - C++ ILU imake Macros
How to Create ILU Support for a Programming Language
- Defining the Mapping
- Designing Runtime Operation
- Writing the Stub Generator
- Writing the LSR
The TIM Documentation Language
- Introduction
- Extensions to GNU Texinfo
  - TIM Domain-Independent Format
  - Defining Domain-Specific Markup Commands With @timmacro
- TIM Tools
- Markup Commands used with ILU
The ILU Common Lisp Portable DEFSYSTEM Module
- Pathname Support
The ILU Common Lisp Lightweight Process System
- Introduction
- Overview Of The ILU CL Process Model
- Functional Overview
- Implementation Architecture
- General Limitations
- How To Use The ILU CL Process Interface
- How To Program The ILU CL Process Interface
- The ILU CL Process Interface
- Handling Errors
- Notes
- References
Porting ILU to Common Lisp Implementations
- Introduction
- Providing the ILU notion of foreign-function calls.
- Network Garbage Collection
- Thread and/or Event Loops
- Converting between character sets.
- Support for Dynamic Object Creation
Algorithm for Generation of Structural-Hash Type IDs
- Resolving Type Ambiguities
- Constructing the "salient information string"
- References to Types, Interfaces, and Exceptions
- Definitions of Types, Interfaces, and Exceptions
- Calculation of the NIST SHS of the "salient information" String.
- Conversion of the SHS to a Base-64 Number.
Possible ISL Name Mappings for Target Languages
- C mapping
- C++ mapping
- Modula-3 mapping
- Mapping ILU ISL to Modula-3
Index of Concepts
Index of Functions, Variables, Methods, and Types