home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / resources / libraries / runner.1.1.README < prev    next >
Encoding:
Text File  |  1995-12-12  |  2.8 KB  |  72 lines
  1. This is the README for RUNNER 1.1.
  2.  
  3. $Id: README,v 1.2 1995/11/29 17:40:51 tiggr Exp $
  4.  
  5. The latest version of RUNNER can be obtained at the URL
  6. `ftp://ftp.es.ele.tue.nl/pub/tiggr/runner.tar.gz'.
  7.  
  8. RUNNER is a (small) NeXTSTEP library, enabling you to tell NXConnection to
  9. `runFromAppkit' without actually needing to link with the Application Kit,
  10. i.e. with libNeXT.  This implies you can write sensible daemons employing
  11. Distributed Objects, with the following advantages:
  12.  
  13. FEATURES
  14.  
  15.  - You can run multiple connections in a single thread.
  16.  
  17.  - There is a top-level autorelease pool, maintained free of charge.
  18.  
  19.  - Proper handling of port invalidation, without needing to revert to the
  20.    horrible `+[NXPort worryAboutPortInvalidation]'.
  21.  
  22.  - TMProxyDeath protocol, where local objects can register themselves for
  23.    the death of remote proxies they care about.  Upon such an occasion, the
  24.    local objects receives a `-proxyDied: the_proxy'.  This is a rather more
  25.    simple and elegant than the bare bones invalidation notification as
  26.    provided by NXConnection.
  27.  
  28.  - possibility of one-shot per-port message receive timeouts, which fire if
  29.    a message is not received within the indicated number of milliseconds.
  30.  
  31.  - Provide DPSAddPort, DPSRemovePort, DPSAddTimedEntry and
  32.    DPSRemoveTimedEntry.
  33.  
  34.  - your programs can employ asynchronous peer-to-peer communication instead
  35.    of being restricted to strictly synchronous communication in a strict
  36.    client-server setup.  The programming style enabled by RUNNER implies a
  37.    huge latency decrease for server daemons with multiple clients or who
  38.    themselves can be the client of other programs, without needing to
  39.    revert to multiple threads.
  40.  
  41.  - RUNNER comes with a complete example showing off most of the features
  42.    and how to use them.
  43.  
  44. CAVEATS
  45.  
  46.  - Does not work when linking with libNeXT_s (i.e. AppKit).  Obviously.
  47.  
  48.  - You still need to allocate an autorelease pool as the first statement in
  49.    main() and release it before you tell the `+[TMConnectionRunner
  50.    sharedRunner]' to `-run', unless you don't care about cleaning up the
  51.    garbage created during your daemon's initialization.
  52.  
  53.  - NOT provided is the availability of a non-blocking deadlock avoiding
  54.    Distributed Object message send and port lookup.
  55.  
  56.  - RUNNER has been tested on black NS 3.0, 3.2 and 3.3.  It is expected to
  57.    work on other architectures too.
  58.  
  59. CONTACT
  60.  
  61.    For information, bug reports, suggestions, questions, or whatever else
  62.    you'd like to share with us, mail <runner@es.ele.tue.nl>.
  63.  
  64. RUNNER is Copyright (C) 1994, 1995 Pieter J. Schoenmakers <tiggr@es.ele.tue.nl>
  65.                    and Michael L.H. Brouwer <michael@thi.nl>.
  66.  
  67. RUNNER is distributed under the terms and conditions of the GNU Library
  68. General Public License (LGPL).  See the file COPYING.LIB in the RUNNER
  69. distribution for details.
  70.  
  71. <runner@es.ele.tue.nl>
  72.