home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Programy / RC5 / dnetc-amigaos-wos-ppc.lha / docsreadme.amiga < prev   
Text File  |  2000-07-14  |  6KB  |  136 lines
  1.  
  2.  distributed.net client for AmigaOS (68k/PPC)
  3.  Released by Oliver Roberts <oliver@futaura.co.uk>
  4.  Document revision $Id: readme.amiga,v 1.7.2.3 2000/07/14 22:48:01 oliver Exp $
  5.                                                           
  6.  Welcome to the distributed.net client.
  7.  
  8.  This document covers information specific to the client for AmigaOS.
  9.  Refer to other enclosed documentation or browse the online FAQ at
  10.  http://www.distributed.net/FAQ for non-platform-specific documentation.
  11.  
  12.     1.0  System requirements
  13.     2.0  Getting started
  14.     3.0  AmigaOS client specific notes
  15.          3.1 Setting the time zone
  16.          3.2 Myzar - GUI front-end for the client
  17.          3.3 Packets and work units?
  18.     4.0  Credits & thank yous
  19.  
  20.  1.0  System requirements --------------------------------------------
  21.  
  22.      - AmigaOS 2.04 or greater (3.0 if you're running the PPC client)
  23.      - A TCP stack compatible with AmiTCP 3.0 or newer.
  24.        There are several, such as Miami, for example.
  25.        Also AS225R2 with a special emulation library, look on the Amiga 
  26.        effort homepage/misc section for the archive link (address below).
  27.  
  28.     There are three versions of the client: a 68k version (with cores
  29.     optimized for each CPU) and two PPC versions (WarpOS and PowerUp).
  30.     Choose the PPC version according to your preferred PPC kernel.
  31.  
  32.      The 68k version requires:
  33.      - An 68000 or higher. An 040 or preferably 060 is HIGHLY recommended.
  34.  
  35.      The WarpOS PPC version requires:
  36.      - A 603e or higher PPC processor. Tested on 603e and 604e.
  37.      - WarpUp Release 4.0 / powerpc.library 15.0 or higher.
  38.  
  39.      The PowerUp PPC version requires:
  40.      - A 603e or higher PPC processor. Tested on 603e and 604e.
  41.      - Phase5's ppc.library version 46.30 or higher.
  42.      - Also works under WarpUp with PPCLibEmu 0.7e (although you
  43.        should really use the native WarpOS version instead).
  44.        
  45.  2.0  Getting started ------------------------------------------------
  46.  
  47.     Just copy the client into a directory of your choice and fire it up.
  48.  
  49.     If you have never run the client before, it will initiate the
  50.     menu-driven configuration. Save and quit when done, the 
  51.     configuration file will be saved in the same directory as the 
  52.     client. Then, simply restart the client. From that point on it will 
  53.     use the saved configuration.
  54.     
  55.     The configuration options are fairly self-explanatory and can be run
  56.     at any time by starting the client with the '-config' option.
  57.     A list of command line options is available by starting the client 
  58.     with '-help'.
  59.  
  60.     A detailed guide to the various configuration options is available
  61.     online at http://www.distributed.net/FAQ/
  62.  
  63.  3.0  Notes ----------------------------------------------------------
  64.  
  65.     If you want to contribute to the Amiga RC5 Team Effort, visit the effort
  66.     homepage at http://distributed.amiga.org/, it contains all the necessary
  67.     info along with extensive information on usage, configuration, trouble
  68.     shooting etc. 
  69.     
  70.     IMPORTANT: the client's default distributed.net ID is rc5@distributed.net.
  71.     Unless you change this your work is wasted effort.
  72.     The usage section on the Amiga effort pages contains all you need to
  73.     know to change this.
  74.  
  75.   3.1  Setting the time zone -----------------------------------------
  76.  
  77.     The client always displays the current time in UTC - not your local
  78.     time!  For this to work correctly, you need to ensure your timezone
  79.     is set correctly. This can be done through the Workbench Locale
  80.     preferences program.  Of course, the drawback with using Locale is
  81.     that daylight savings are not accounted for. Ideally, I'd recommend
  82.     installing SetDST (util/time/SetDST.lha on Aminet) which will
  83.     handle it for you automatically - you need to use the SETLOCALE
  84.     feature. Alternatively, you can manually adjust the timezone in
  85.     Locale prefs whenever you start/end dst.  For example, if you are
  86.     in the UK, you would set the timezone to GMT when not in dst, and
  87.     to 1 hour from GMT (a zone to the right) when in dst.
  88.  
  89.   3.2  Myzar - GUI front-end for the client --------------------------
  90.  
  91.     Myzar is a GUI front-end for the Amiga port of client. It is not a
  92.     simple interface to start/stop the shell-based client, but a complex
  93.     and full-featured front-end. No more ugly-looking shells floating
  94.     around your WB, filled with unreadable data, and no more fiddling with
  95.     CLI parameters. And, more importantly, it makes using and running the
  96.     client so much easier.
  97.  
  98.     If you're going to use this client, then I really do recommend that
  99.     you install Myzar too: http://www.crosswinds.net/~myzar/ . Note that
  100.     the new clients aren't fully compatible with older versions of Myzar.
  101.     You'll need Myzar 2.1 or higher for full functionality with the
  102.     v2.80xx clients.
  103.  
  104.   3.3  Packets and work units?
  105.  
  106.     If you are upgrading from the old 2.710x clients, you may not be
  107.     familiar with the new terminology that has replaced "blocks".  The
  108.     new clients refer to "packets" and "work units".  Descriptions of
  109.     their meanings can be found at
  110.     http://www.distributed.net/faq/cache/138.html
  111.  
  112.  4.0  Credits & thank yous--------------------------------------------
  113.  
  114.     -- Thanks to everybody involved in the development of the Amiga client
  115.        and the beta testing process, who have helped make it what it is,
  116.        including (in no particular order):
  117.  
  118.        - Kriton Kyrimis (multi-core 68k OGR cores, support and ideas)
  119.        - Tony Preston (support, testing, views and overall managament)
  120.        - John Girvin (68k optimized RC5 cores)
  121.        - Roberto Ragusa (PPC 604e optimized RC5 core)
  122.        - Stefan Smietanowski (for porting previous clients to the Amiga -
  123.          some crucial parts of his code are used in this version)
  124.        - Roberto Patriarca (Myzar)
  125.        - Thomas Tavoly (coordinator of the Amiga RC5 Team)
  126.        - Jacek Rzeuski (keyrate chart class code for Myzar)
  127.  
  128.     -- The whole Amiga RC5 Team
  129.        Without you there wouldn't be much of a point in doing the client, 
  130.        so keep on cracking! Maybe YOU can find the key with the client.
  131.  
  132.     -- Finally, thanks to everybody involved with the gcc and libnix ports
  133.        for AmigaOS, especially for version for WarpUp.  Thanks also to
  134.        Sebastian Jedruszkiewicz for help with stripping the PowerUp
  135.        version of the client, and Sam Jordan for his knowledge and support.
  136.