*************************************
TURBOTRANS TRIAL VERSION MANUAL
( C ) 1998 FORCEWAY SOFTWARE

(TT is used as an abbreviation for TurboTrans)
(see LEGAL.TXT for disclaimer/info)
(see ORDER.TXT for ordering information)

********
What is it:

TurboTrans is a simple file transfer utility, designed to squeeze every 
last bit of speed out of your dial-up internet connection.  It is intended 
for internet power users who frequently need to send files to friends or 
associates quickly, and who know what IP address are, etc.  
TurboTrans uses an asynchronous span-buffer protocol that tries to take 
advantage of the way packets are delivered across the internet in order 
to send files more quickly.  In many cases it is significantly faster then 
existing protocols (depending on internet conditions, and the quality of 
your ISP).  It is especially effective over `laggy', cranky, low speed 
modem links, though it can also send files in a more traditional 
streaming mode.  In addition, TT features the ability to resume 
canceled downloads, and interface with external apps.

Requirements:

-Windows 95
-Installed TCP/IP stack
-MFC runtime .DLL's

********
Notes about the trial version:

This is a trial version of TurboTrans.  You may try it for 30 days.  After 
that time if you don't like it, delete it!  Or not..  However if you do find 
it useful, please order the full version.  You will of course receive free 
bug fixes and updates, and be eligible for other special offers.  See 
ORDER.TXT for details.

Multiple sessions and file batching are not available in this trial version 
(you can only send or receive one file at a time to one person at a time).

********
Sending a file:

Type the IP address or domain name of the site you wish to send to in 
the "Send to" listbox.  Optionally, if the site is not running on the 
default TT port, you can type a port number after the address with a 
colon separating the two (no spaces).  ex: 234.133.12.81:3333 would 
connect to port 3333. Click the send file button.  A file dialog will 
open.  Select the file you wish to send and press ok.  TT will now 
attempt to connect to the remote site.  If the file is accepted the transfer 
will begin.  Once the file has been transferred the connection will close.

********
Receiving a file:

To receive a file, TT must be waiting in the ready state so it can 
"listen" for incoming connections.  When one arrives you will be asked 
if you want to receive the file.  If you press yes a file dialog will open.  
Enter the location where you would like to save the file, and the 
transfer will begin.  TT saves the file information in its own internal 
format, and will automatically resume partial transfers if it finds an 
incomplete scratch file (.tt) from a previous transfer (if you don't want 
to resume partial transfers, delete all .tt files in the scratch dir). Once 
the file has been transferred the connection will close, and the 
temporary scratch file will be knitted into an actual file.

********
Resetting:

The transfer can be canceled at anytime by pressing the `reset' button.  
TT will first try to close the connection gracefully by telling the remote 
site.  If you don't want to wait, press reset again for an immediate reset.

********
Exiting:

If you try to exit during a transfer, TT will first try to close the 
connection gracefully by telling the remote site.  If you don't want to 
wait, press reset for immediate exit.

********
Options:

Options can be changed at any time by pressing the "options" button.  
This will open the options dialog.  Transfer options (packet size, rev 
limit, tcp fallback) can be changed on the fly, by the sender, and will go 
into effect when ok is pressed, and the options dialog closes.  The 
receiver can change his options also, but they will have no effect on 
incoming transfers (i.e. the sender controls the transfer).

packet size: This edit box allows you to change the size of data packets 
in bytes.  The default size of 1024 is usually best, though you may want 
to go down to 512 if the transfer is taking several passes (this is a sign 
that heavy packet loss is occuring.).

`rev limiter': Roughly controls the speed of the transfer, more 
specifically how much of the available bandwidth is used by TT.  The 
auto setting is usually best.  This will try to limit the sending speed to 
the best speed the receiver is capable of.  Full throttle is for sending at 
maximum possible speed.  This can result in the fastest possible 
transfers, but if you have a much higher speed connection then the 
receiver, TT will easily flood him.  Use the limit setting to enter a 
manual speed limit in k/s.  (NOTE: this is a maximum speed limit. if 
the hardware/software isn't capable of sending at the speed you enter, it 
won't. It will only send as fast as it can).

TCP fallback: Puts TT in a more traditional transfer mode using TCP 
sockets.  Use this fallback mode when you think you have a good 
connection, or you want to keep greedy TT from flooding and taking 
over your dial-up internet connection (many times the TT protocol has 
no significant benefit over guaranteed TCP/stream messaging).  The 
TCP mode works similarly to FTP and other data protocols.

Want exit: If this is checked, TT will exit once the file transfer is 
complete.

********
Tips:

When you double click the main window, the local TurboTrans IP:port 
will be copied to the clipboard as text.  The local IP:port is displayed in 
the bottom of the window.  If TT is running on a port other then the 
default, you will need to communicate it to those who wish to send files 
to you.

The scratch directory can safely be deleted (when TT is not running).

********
Command line parameters, running TT from other applications:

There are no spaces in any of the parameters, but there should always 
be space between them.

/port:n - Used to specify the control port you want TT to run on.  
Replace n with the port # you would like to use ( "/port:333" for port 
333 (no spaces)).  When starting up TT will always look for this 
parameter first.  If it doesn't find it, or the specified port is unavailable, 
it will try to run on the default port (25999).  If the default port is 
unavailable, it will let winsock choose a port.

/sendip:ip - Passes an IP address or domain name string (with an 
optional port) to be placed in the sendto listbox.  (It takes NO other 
action, and is usually used with other parameters.)  Replace ip with a 
dotted ip address or domain name (ex. "/sendip:thesite.com:2411" ).

/select - Causes TT to open a file dialog to select a file to send (acts as 
though the Send file button has been pressed on startup).  MUST be 
used in combination with the /sendip: parameter.

/file:name - Causes TT to immediately send a file (acts as though the 
Send file button has been pressed and a file has been selected).  
Replace name with the name of the file you wish to send. MUST be 
used in combination with the /sendip: parameter.

/accept:ip - Causes TT to automatically accept any send requests from 
the passed IP address or domain name.  Replace ip with an IP address 
or domain name.  Works only once.

/exit - Causes TT to exit when a file transfer is complete (same as the 
want exit option).

Use of these command line parameters can allow you to run 
TurboTrans from within other popular internet applications.  This 
removes the need to enter IP addresses, making TT much easier to use.

Using TT with ICQ:

In our testing TurboTrans is typically from 10% to 50% faster then ICQ 
file-direct (depending on conditions and the quality of your ISP).  To 
manually add TT to your external application list, open ICQ.  Go to the 
main menu and choose Preferences.  Click the Voice/Video/Games tab.  
Click the New External button.  Type "TurboTrans Trial" in the 
External Application Name field.  Click the Browse button next to the 
External Application Executable field.  Find TurboTrans Trial.exe and 
click open.  In the Command Line field type "/accept:%i /exit".  Click 
the Client-Sever Application button.  Click Browse for the Server 
Executable.  Find TurboTrans Trial.exe once again, and click open.  In 
the Server Command Line field type "/sendip:%i /select /exit".  Press 
Ok.  Press Ok again.  Done!

Can't find any of this trash?!  What am I talking about!?  Maybe you 
have a newer version of ICQ.  Here are the standard command line 
parameters you will need (where ip is the variable for IP address):

Receive/Client: /accept:ip /exit
Send/Server: /sendip:ip /select /exit

To send files with TT now, go to the Voice/Video/Games listing of the 
user you want to send to, and select TurboTrans Trial.

********
Issues:

-`rev limiter' has poor accuracy/timing
-incorrect local address resolution when running on TCP LANs that 
have a separate dial-up setup(?)
-firewalls are not supported
-NT is not supported
-TCP mode: Some users have experienced problems switching to and 
from TCP mode in the middle of a transfer. If you have trouble, don't 
change this setting during transfers, do it beforehand.
-sometimes knitting complex .tt files requires heavy CPU use, making 
the app appear to hang for a moment


all trademarks are the property of their owners
