home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 164.lha / IPC / Sources / READ_ME < prev    next >
Text File  |  1988-04-28  |  3KB  |  75 lines
  1.  
  2.                            IPC System Sources
  3.                            ==================
  4.  
  5. This directory contains the C source files for all the current system
  6. modules of IPC.
  7.  
  8. Include header files:
  9.  
  10.     IPC.h       --  contains definitions for all standard IPC functions.
  11.                     Should be included in any source that uses IPC.
  12.  
  13.     IPCPorts.h  --  Port structure and flags.  Should only be needed
  14.                     in special cases: normally all access to IPCPorts
  15.                     should be via the procedures in IPC.c (and perhaps
  16.                     LoadIPCPort.c) -- IPCPorts are then just defined for
  17.                     the user as standard MsgPorts.  If needed, IPCPorts.h
  18.                     should precede IPC.h.
  19.  
  20. Source Files:
  21.  
  22.     IPC.c       --  Contains all the basic IPC procedures that a user
  23.                     program will call for managing IPCPorts and
  24.                     IPCMessages.  The object file generated from this
  25.                     source by your compiler should be linked between your
  26.                     user program and the C libraries.
  27.  
  28.     LoadIPCPort.c   -- An alternative to GetIPCPort (which it uses
  29.                     internally) that sends a message to a "Port Broker"
  30.                     if the requested port does not currently have a server;
  31.                     if the broker cannot find a server to satisfy the
  32.                     request, this call will return NULL.  If used, link
  33.                     this module's object file before IPC itself.
  34.  
  35.     Broker.c    --  A skeletal Port Broker.  This is just a demonstration
  36.                     of how a broker will accept messages and reply to them;
  37.                     it does nothing about actually trying to locate a
  38.                     server -- just posts a courteous request to the user in
  39.                     its console window... It is written so that it should
  40.                     be easy to plug in a proper loading procedure. Comments
  41.                     are sparse [apologies!] but the code is probably
  42.                     compact enough to be followed fairly easily.
  43.  
  44. Link File:
  45.  
  46.     Broker.lnk  --  A BLink "WITH" file to create an exectuable version
  47.                     of the broker.
  48.  
  49.                             +++++++++++++++++
  50.  
  51. Compatibility:
  52.  
  53.     The header files and IPC.c should be totally compatible with both
  54.     Lattice and Manx/Aztec [with thanks to Brian Witt for the conversion!].
  55.     I think LoadIPCPort probably is, but will make no guarantees (it DOES
  56.     work with Lattice!); the Broker code will probably need some tweaking
  57.     to work with Manx.
  58.  
  59.     Of COURSE there should be no problems in sending IPCMessages between
  60.     modules compiled under different regimes!
  61.  
  62. Compiling under Lattice:
  63.  
  64.     Any compiler switches you use are optional, but I normally compile with
  65.     the -v switch to suppress stack checking, and use the default
  66.     addressing mode (Base Register Relative in 4.0+).  If you are going to
  67.     call this code from a child task of the main program, you MUST of
  68.     course use -v, and you will normally need -y as well (see the Lattice
  69.     manual).
  70.  
  71.                             +++++++++++++++++
  72.                             -----------------
  73.  
  74.  
  75.