.________ _/\_ _/\_  _________
                   ____¦____   7_)__ Y __(_(   _____/__
                 _/     ___/ _/ \ (_\_/_) / \_  T     ¬\_
                 \     ¦/    7   (\_`-'_/)   7  l       /
                  \____.-----¦    ¥¥¥¥¥¥¥    ¦----.____/
                   ¯¯¯¯¯          `^---^'         ¯¯¯¯¯

                   d -÷- i -÷- G -÷- i -÷- T -÷- A -÷- L
         c -÷- O -÷- R -÷- R -÷- U -÷- P -÷- T -÷- i -÷- O -÷- N

                          XPR-FTP Written By Zed/DC


What is it?
~~~~~~~~~~~
	It's a no-mess way to use a ftp-alike protocol when telneting!
	No need to mess around with doors and ftp-clients, just stick
	this library in your protocol prefs in Term/Terminus/NComm
	and select the xpr-ftp protocol from the BBS (Ask your SysOp
	to install it now!).


Requirements:
~~~~~~~~~~~~~
	- Workbench 2.0+
	- AmiTCP / Miami or compatable TCP stack
	- Terminal Program or BBS that supports XPR

	Note: If you run a board, your users must have this protocol
	      install aswell. If you call boards, ask your SysOp
	      too install it. Almost every BBS supports XPR libraries.


Note for TERM users:
~~~~~~~~~~~~~~~~~~~~
	In the "Transfer protocols..." settings, choose
	"Default Protocol" and set:

	Send Signature:		*tftp*get
	Receive Signature:	*tftp*send

	(Notice they are backwards!)

	This will enable auto download / upload.


Note for TERMINUS users (Options/Init String)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	
	P<path>		Download directory.

	eg:	"PSys:Downloads/"

	or type in shell "SetEnv xprftp PSys:Downloads/"

	If are you using Terminus, you should set the init string
	and the path to the same as in Terminus's normal prefs. For
	other software, just leave the Init String blank.


How does it work?
~~~~~~~~~~~~~~~~~
	It's really quiet simple, I don't know why someone hasn't written
	it already. The receiving end will send its hostname (IP) to the
	sending end, and then they connect using a STREAM socket. Once
	connected, they can transfer files perfectly and cleanly using
	an FTP alike custom standard while reporting the progress to the
	normal Transfer window.

	XPR-FTP does no error checking (that includes CRC/CheckSum etc)
	because your PPP program will already do this. This is the main
	reason why it's faster than ZModem. Also with Telnet, ASCII 255
	($FF) is a problem because it is a Telnet control code. With
	ZModem it would have to be doubled up and filtered out. This
	will not effect XPR-FTP because it opens its own Socket.



XPR-FTP compared to Z-MODEM:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Test conditions:	Telnet from Australia to
				USA using 14k4 modem with
				Terminus and telser.device


	Z-Modem Results:

			Errors     :	6
			Average CPS:	267
			Successfull:	NO! had to abort


	XPR-FTP Results:

			Errors     :	n/a
			Average CPS:	1250
			Successfull:	hell YES!


	As you can see, XPR-FTP will not only give you fast transfers
	at high speed links, it will never timeout or get errors if
	you have a slow link.



Acknowledgments:
~~~~~~~~~~~~~~~~

	The_Kid				- testing
	Master / DC			- testing


       --××·· -÷- ··××---÷---××·· -÷- ··××---÷---××·· -÷- ··××-- -÷-