home *** CD-ROM | disk | FTP | other *** search
-
- IPC System Sources
- ==================
-
- This directory contains the source files for creating the IPC Shared
- Library.
-
- Include header files:
-
-
- IPCStruct.h -- Header defining only the IPC structures (extracted
- from IPC.h and IPCPorts.h); avoids function prototype
- conflicts within the library sources.
-
- IPCAsmCalls.h -- prototypes for direct calling of library routines
- by other routines within the library.
-
- + + +
-
-
-
- Source Files for the Shared Library:
-
- IPClib.c -- Contains all the IPC library procedures that a user
- program will call for managing IPCPorts and
- IPCMessages. Calls to the library invoke these
- routines directly (no assembly level interface
- required -- they use the "__asm" feature of
- Lattice 5.0).
-
- LoadIPCPort.c -- An alternative to GetIPCPort (which it uses
- internally) that sends a message to a "Port Broker"
- if the requested port does not currently have a server;
- if the broker cannot find a server to satisfy the
- request (or the broker itself isn't loaded!), this call
- will return NULL. This module is now a standard part
- of the library.
-
- UtilIPC.c -- Contains two (new) utility functions that have been
- added to the IPC Library (MakeIPCId and FindIPCItem).
-
- LibFuncs.c -- Standard library functions (Init, Open, Close, Expunge)
- with minor additions to handle particular IPC needs.
-
- LibTables.c -- Tables for library initialization. (The library node
- structure initialization is not easy to specify in C;
- the table for that is in LibTag.a.)
-
- LibTag.a -- The library RomTag structure needed for autoloading
- by OpenLibrary(). Also contains basic initialization
- data for the library node.
-
- + + +
-
- Make File:
-
- lmkfile -- Lattice 5.0 Makefile for the library. It assumes that
- all assignments and paths have been set up before it
- is invoked.
-
- Link File:
-
- IPCLibrary.lnk -- BLINK "WITH" file to create "ppipc.library" from
- the component object files (also used by lmkfile).
-
-
- +++++++++++++++++
-
-
- Compiling under Lattice:
-
- The library modules MUST all be compiled with -b0 and -v options.
- (It probably would be fairly easy to make it compatible with the -y
- option instead of -b0, by saving a suitable base pointer on
- initialization, but I haven't experimented with that yet.)
-
- Application programs may of course be compiled in any mode you like.
- If you are using Lattice 4.0 or later, it will be more convenient to
- include IPC_proto.h (as well as IPC.h) so you can avoid any need to
- link with IPC.lib (itself available in Libraries directory).
-
- +++++++++++++++++
- -----------------
-
- 1989 April 18
-