The Marinetti/SLiRP HOWTO - Revision 1.0The Marinetti/SLiRP HOWTO
© 1998 Daniel Krass
Revision 1.01 - September 20, 1998 



DISCLAIMER:This document is privately-maintained by Dan Krass and is not 
endorsed or written by the author of Marinetti. Please refer all questions 
referring to this document to it's author and not to the author of Marinetti.
The current BETA release of Marinetti (1.0b1), a TCP/IP stack for the Apple 
IIGS, currently only supports SLIP as it's connection protocol. Unfortunately, 
many ISPs (Internet Service Providers) have removed support for SLIP access, 
because of the general availability, on most platforms, of PPP; a technically 
superior protocol. Potential Marinetti users with access to a UNIX shell but 
only PPP access have an alternative, fortunately. There is a 
freely-distributable, but still copyright restricted, UNIX utility available on 
the internet called SLiRP. SLiRP is an application that emulates a SLIP or PPP 
connection, and can be executed from a UNIX shell. What does this mean to the 
potential Marinetti user? Well, SLiRP will allow the user to bypass the need for 
standard SLIP access from their ISP, thus, allowing them to use Marinetti from 
virtually any ISP with a shell. This document attempts to give the user general 
information about setting up SLiRP with their ISP and Marinetti. 
The first step in setting up Marinetti and SLiRP is getting SLiRP installed in 
your home directory of your ISP. The first step is to obtain the actual 
pre-compile binary for your system (Information on obtaining the compilable 
source code and compiling it is well-documented on a website, and that URL will 
be given later.) The binary releases can be found at:
     ftp://www.ibc.wustl.edu/pub/slirp_bin/USE_AT_OWN_RISK/.
This FTP site has a wide variety of pre-compiled binary releases of SLiRP for 
various UNIX operating systems. After transferring the file to your home 
directory, there are a few things you MAY have to do. If the file you downloaded 
has the extensions '.tar.gz', then you will follow steps 1 and 2. If the file 
had the extension '.gz', you will follow only step 1. If the file had the 
extension '.tar', you will follow only step 2. If neither of these extensions 
were appended to the filename, then ignore these two steps. 
  1) The file will be compressed using gunzip. To decompress this 
     file issue the following command from the shell: gunzip 
      is the specific filename of the binary which you  
     downloaded.  

  2) Next you will need to decode the TAR encoding on the file. 
     To do this, issue the command from the shell: tar vxf (filename).
     This filename will most likely be the same as the filename from
     above, except, it will not have the '.gz' extension appended
     to it, because gunzip decompressed that aspect of the file.  

Now, you should have an executable file in your directory that is almost ready 
to use. It will most likely use a fairly long filename that is clumsy to have to 
type when you want to execute SLiRP. Use the following command to change the 
filename: mv slirp This will rename the old filename to 'slirp'. Now issue the 
command: chmod +x slirp This command gives SLiRP file permissions so that it can 
be executed from the shell. At this point, you should be able to execute SLiRP 
by issuing the command 'slirp' from the shell.
Now you are ready to script Marinetti to interact with SLiRP and establish a 
SLIP connection. The following is a generalized copy of my Marinetti connect 
script, and it is commented to help give the user a better understanding of what 
the script is doing. Comments are enclosed inside a /* and a */. 
-BEGIN FILE-
baud 38400 /* Sets the BAUD rate */
send cr
delay 10
send ATZ cr
wait 600 OK
send ATZATE0V1Q0S7=45&K3&D0\N3%C0&C1&W1 cr /* Use the Init string for your modem */                                                                                   
wait 600 OK
delay 60
send ATDT####### cr /* Replace the #s with your ISP's phone number */
wait 2400 CONNECT
wait 600 "ogin: " /* Waits for your login prompt */
send ********** cr /* sends your username */
wait 600 assword:  /* Waits for your password */
send ********** cr /* Sends your password */
 wait 600 "$ "  /* Waits for your shell to be loaded and present it's prompt */

NOTE: If you have a different style prompt, be sure to either change the script 
or your shell prompt.
send "slirp" cr /* Executes SLiRP */
wait 600 'Your address is' /* Waits for SLiRP to spit out the 'Your address is' 
                                                   line. */
getip 300    /* Extracts the IP address given by SLiRP */
end cr

-END OF FILE-

If you have this script entered correctly to fit your needs in the Marinetti 
connect script entry field and you have SLiRP running on your ISP, you should be 
ready to use Marinetti. 
From this point on, you can follow the directions given in the Marinetti 
documentation to connect with Marinetti and use it's available applications. 
Please send all e-mail regarding this HOWTO to (gser@jadetech.com).


This site is maintained by Dan "GSer" Krass
Last Updated: 9/20/98 
© 1997-98 Daniel Krass