home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff290.lzh / IPC / Sources / READ_ME < prev    next >
Text File  |  1989-12-11  |  4KB  |  99 lines
  1.  
  2.                             IPC Demo Sources
  3.                             ================
  4.  
  5. This directory contains source files for a Simple Server/Client pair
  6. -- the client simply sends text to the server for output -- and a more
  7. complex Print Formatting Server ("FormatServer"), with a very dumb Client
  8. program to test it ("FormatClient").  There are also a simple Port Broker
  9. and a "Cleaner" for checking and fixing errant IPCPorts, plus very short
  10. program that will send a standard QUIT message (which should be recognized
  11. by ALL servers) to specified IPCPorts. These sources are mostly heavily
  12. commented, and are intended as demonstrations of how to use the IPC
  13. protocols.  The icons at the parent level of this package will actually run
  14. these demo programs if you want to try them out.
  15.  
  16. Include header files:
  17.  
  18.     IPC.h   -- a copy of the file from IPC_Sources, for convenience.
  19.     IPC_proto.h -- direct library call definitions for Lattice 4.0/5.0
  20.  
  21.  
  22. Source Files:
  23.  
  24.     SimpleServer.c
  25.     SimpleClient.c
  26.  
  27.     Quit.c
  28.  
  29.     FormatServer.c
  30.     FormatClient.c
  31.  
  32.         Both of the "Format.." modules must be linked with the
  33.         floating-point math library.
  34.  
  35.     Broker_skel.c   -- an incomplete core structure for a Port Broker
  36.     Broker.c        -- a simple working Broker
  37.     Cleaner.c
  38.  
  39.  
  40. Documentation:
  41.  
  42.     FormatServer.doc --  A detailed description of the message format
  43.                     accepted by FormatServer, and the requirements for
  44.                     using it.
  45.  
  46.     FormatClient.doc   --  A short description of the test program and its
  47.                         commands.
  48.  
  49.  
  50.     For more on the Broker and Cleaner programs, please refer to the Broker
  51.     directory.
  52.  
  53.                             ++++++++++++++
  54.  
  55. Compatibility:
  56.  
  57.     These programs have been tested under Lattice 5.02/5.04.  They will
  58.     need some conversion (ensuring LONGS are used where necessary, and so
  59.     on) for compilation under Manx (and will also need assembly library
  60.     linkage routines).
  61.  
  62.  
  63. Notes:
  64.  
  65.     The two "Simple..." programs are trivial examples of accessing an
  66.     IPCPort and passing simple messages.  They should be straightforward
  67.     to follow.  The "Format.." examples are much more extensive; the server
  68.     in particular has to do a lot of work to handle all the items that
  69.     might be thrown at it; it is probably mure complex than a good example
  70.     program should be...  The FormatClient, too, plays a few games with
  71.     messages, just to test out the system.  If they are intimidatingly
  72.     complex, my apologies.
  73.  
  74.     The Format handling programs have been written to reduce space as much
  75.     as possible: they use '_main()' rather than main(), for instance, and
  76.     don't use C level I/O -- just AmigaDOS calls.  They should be compiled
  77.     using the Lattice -v switch, to reduce space a little more, and there
  78.     may be other measures that could be taken.
  79.  
  80.     This means that they CANNOT be invoked directly from an icon in their
  81.     present form -- only from a CLI.  AS they need to run simultaneously
  82.     they must either be started from their own CLI, or with the RUN command
  83.     (remembering that they both can generate console output).
  84.  
  85.     You can use an Xicon script to set them both going in a suitable
  86.     environment (as in the demo icon in this package), but there are TRAPS!
  87.     These seem to be due to a bug in (1.2 -- may be fixed in 1.3) RUN,
  88.     which has problems when it is invoked from an AmigaDOS Execute() call:
  89.     you MUST redirect the output of RUN ITSELF to NIL: to avoid Guruing.
  90.     For example:
  91.  
  92.         RUN >NIL: FormatServer >"CON:100/50/450/100/Format Server Output"
  93.  
  94.     [This is nothing to do with IPC -- it is a general problem Xicon has
  95.     with AmigaDOS -- as far as I can tell, it's the systems fault (:-))]
  96.     See the script for the demo (in directory IPC_demo) for more details.
  97.  
  98.  
  99.