home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / gnu / xms-0.06 / README < prev    next >
Encoding:
Text File  |  1991-11-23  |  4.3 KB  |  103 lines
  1.  
  2.  
  3.             MandelSpawn, a distributed Mandelbrot program
  4.  
  5.                              Version 0.06
  6.  
  7.  
  8. This is MandelSpawn, a distributed Mandelbrot program.  It allows you
  9. to calculate pictures of the Mandelbrot and Julia sets in parallel on
  10. several machines connected by a network.
  11.  
  12. MandelSpawn is GNU-style free software and is available under the GNU
  13. General Public License, version 1.  See the file COPYING for details.
  14.  
  15. To run MandelSpawn, you need a machine running some flavour of Unix
  16. with a BSD-style socket library.  To use MandelSpawn interactively you
  17. also need X11R4.  There is support for X11R2 and X11R3, but some
  18. features (most notably the popup menu) will be absent under those
  19. versions.  MandelSpawn has not yet been tested under X11R5.
  20. MandelSpawn uses the Xlib and Xt libraries and under X11R4/X11R5 it
  21. also uses Xaw.
  22.  
  23. To benefit from the parallel processing features of MandelSpawn, you
  24. will also want to run computation servers on one or more additional
  25. machines (or additional CPUs on the same machine).  Typically these
  26. additional machines are workstations that are mostly idle or doing
  27. bursty, interactive work.  Because the servers are very compact and
  28. run at nice 10 by default, they don't cause any noticeable performance
  29. degradation.  MandelSpawn is fault-tolerant in the sense that it is
  30. not affected much by servers getting heavily loaded or crashing in the
  31. middle of the computation.  The server machines don't need to run X,
  32. but they must be connected to the host through a reasonably fast IP
  33. network supporting UDP.
  34.  
  35. If you are using a Vax, i386 or 680x0, you are likely to get better
  36. performance by using fixed-point arithmetic instead of floating point.
  37. To take advantage of the inline assembly language fixed-point support,
  38. you need to compile the computation server with GCC version 1.36 or
  39. newer.
  40.  
  41. New features in version 0.06 include some portability fixes for System
  42. V, NeXT, and HP-UX, support for fixed-point arithmetic on MIPS
  43. processors, a slightly more informative "Usage:" message, a workaround
  44. for a bug in some Sony X servers, and faster operation with
  45. little-endian monochrome displays.
  46.  
  47. Also new is "bms" (Batch MandelSpawn), a batch-mode client program
  48. which may be useful for those who don't have X, and for those who want
  49. to print pictures larger than their X displays.  Because this is the
  50. first release of bms, it still has limited functionality and is
  51. probably still buggy.  Please report any bugs you find.
  52.  
  53. MandelSpawn has been successfully run on at least Sun 3, Sun 4, Sony
  54. NEWS, MicroVAX II, i386/Mach, and DECstation systems.  Some System V
  55. support has been included starting with version 0.05, but is still
  56. not thoroughly tested.
  57.  
  58. Please report any bugs to gson@niksula.hut.fi.  Please remember to
  59. state your computer model, operating system and version, X toolkit
  60. version, and MandelSpawn version (from running "xms -version" or 
  61. "bms -version").  Also remember to include the exact error message
  62. you are getting.
  63.  
  64. MandelSpawn was developed as a student project at the Helsinki
  65. University of Technology Computer Science Laboratory.
  66.  
  67. MandelSpawn is in no way related to the distributed Mandelbrot program
  68. by Rob Swiston and Chuck Simmons that was posted to alt.sources in
  69. April, 1990, despite a surprising number of similarities.  To my
  70. knowledge, both programs have been developed completely independently.
  71.  
  72. This distribution is available by anonymous FTP from funic.funet.fi,
  73. in /pub/X11/contrib/mandelspawn-0.06.tar.Z.
  74.  
  75. The distribution is divided into three directories:
  76.  
  77.     xms-0.06/        The X11-based interactive client program
  78.     bms-0.06/        The batch-mode client program
  79.     mslaved-0.06/    The computation server
  80.  
  81. Some files, including this one, are linked to more than one directory
  82. to make the directories completely independent of each other.  In
  83. client-only, server-only, and/or X-less installations, any of the
  84. directories may be removed without affecting the functionality of the
  85. others.  Each directory has its own, separate INSTALL file containing
  86. installation instructions, and its own Makefile and/or Imakefile.
  87.  
  88. The file TO_DO contains some random notes about work to be done.
  89. Contributions are welcome.
  90.  
  91. Please read the INSTALL file in each source directory before installing.
  92.  
  93. -- 
  94.                     Andreas Gustafsson
  95.  
  96.                     Internet: gson@niksula.hut.fi
  97.  
  98.                     Snail-mail:
  99.                     Andreas Gustafsson
  100.                     Arentikuja 1 D 305
  101.                     SF-00410 Helsinki
  102.                     FINLAND.
  103.