home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / tinymush.zip / TinyMush / _os2_readme next >
Text File  |  1999-08-28  |  4KB  |  93 lines
  1.                     TinyMUSH 2.2.4 under OS/2 Warp
  2.                          (unofficial version)
  3.  
  4. Requirements for running TinyMUSH:
  5.  
  6.    o  emx runtime (version 0.9c or better)
  7.    o  TCP/IP (at least SLIP or PPP dial-up networking)
  8.    o  HPFS (for long file name support)
  9.  
  10.    It is also helpful to have REXX installed, so that the Startmush.cmd
  11.    file can be used to keep the database files current and automatically
  12.    rebuild the help indices.  If Startmush.cmd is used, ensure that
  13.    pstat.exe is somewhere in the path (it should be in \OS2).
  14.  
  15.  
  16. To run TinyMUSH:
  17.  
  18.    1. Execute Startmush.cmd from within the TinyMUSH directory.
  19.  
  20.    -or-
  21.  
  22.    1. Create a desktop icon pointing to Startmush.cmd, using the
  23.       TinyMUSH directory as the working directory.
  24.  
  25.  
  26.  
  27. To connect to TinyMUSH:
  28.  
  29.    1. Using telnet, telnetpm or a MUSH client, connect to the IP address
  30.       of the machine running TinyMUSH (which may be the same machine).
  31.       The default port for TinyMUSH is 6250.
  32.  
  33.       When running both client and server on the same machine, you may
  34.       also use the default loopback address (127.0.0.1).  If this doesn't
  35.       work, you need to enable the loopback interface.  This may be done
  36.       via the TCP/IP Configuration icon in System Setup (Network tab,
  37.       loopback interface, check "Enable interface"), or by typing the
  38.       following command at an OS/2 command prompt:
  39.  
  40.            ifconfig lo 127.0.0.1
  41.  
  42.  
  43. To shut down TinyMUSH cleanly:
  44.  
  45.    1. Connect to the TinyMUSH server.
  46.    2. Log on as the Wizard character (default password: p0trzebie).
  47.       (The second character is a zero, not a capital letter O.)
  48.    3. Execute the @shutdown command.
  49.  
  50.  
  51. To compile and install TinyMUSH (using GCC with emx libraries):
  52.  
  53.    1. Download the official source distribution from
  54.       http://www.godlike.com/ftp/2.2/tinymush-2.2.4.tar.gz
  55.    2. Unpack the official distribution files.  Due to long file names,
  56.       this must be done on an HPFS drive.  A TGZ extractor may be found
  57.       at ftp://hobbes.nmsu.edu/pub/os2/util/archiver/untgz095.zip
  58.    3. Change to the SRC subdirectory of the official distribution.
  59.    4. Copy the files from the OS2SRC subdirectory of this unofficial
  60.       OS/2 distribution into the SRC directory of the official
  61.       distribution.
  62.    5. Execute makemush.cmd
  63.    6. Copy netmush.exe, mkindx.exe, dbconvert.exe and unsplit.exe to
  64.       the directory where the actual game files will reside.
  65.    7. Copy Startmush.cmd from the scripts subdirectory to the game
  66.       directory.
  67.    8. Copy the files from the text subdirectory to the game directory.
  68.    9. Copy the files from the conf subdirectory to the game directory.
  69.   10. Switch to the game directory and add "access @restart disabled"
  70.       to the bottom of netmush.conf.
  71.   11. Execute Startmush.cmd (from within the game directory) to build
  72.       the help indices and test the installation.  Telnet to port 6250
  73.       on your machine, connect as Wizard (password p0trzebie) to
  74.       interact with TinyMUSH.  Use the @shutdown command when finished
  75.       testing.
  76.   12. Modify the configuration files as necessary.  See README and
  77.       README-2.0 for more information.
  78.  
  79. KNOWN BUGS:
  80.  
  81.    Because the emx libraries do not currently allow sockets to be
  82.    propagated to child processes through exec*(), the @restart command
  83.    does not work correctly.  Make sure that command is disabled in the
  84.    configuration file!
  85.  
  86.  
  87. Comments, questions, and bug reports concerning the OS/2 version may be
  88. sent to Jeff Lee <shipbrk@gate.net>.  Many thanks to the maintainers of
  89. TinyMUSH, who graciously offered to include my extremely minor changes
  90. into the official distribution so that OS/2 Warp could join the ranks
  91. of operating systems which can run this fantastic game.
  92.  
  93.