Description
-----------

This component is an easy FTP client. This means that it supports the FTP Internet 
Protocol ( File Transfer Protocol ), and lets you FTP any site. It uses non-blocking
sockets, so your application won't be blocked during the operation. It is very easy
to use: just connect to a server and use the system functions that you need. 
That's all.

(c) Xavier Cirac. All rights reserved
mail: <xevi@100mbps.es>

Register
--------
	
Why should I register this component?

First of all, this component is shareware, so if after you have tried it, you like it 
or you are going to use it, you have to register it. Otherwise you will be violating 
the copyright laws. Once you have registered it, you will be (legally) able to use it 
(even in commercial programs). Besides, you should think that this component has been 
developed by a Delphi programmer like you, and nobody likes to work without any result 
(in this case, your little fee), so if you register it you will make me a happier person 
(and you will be as well, because you will do the correct thing). 

The fee for this component is only 35 US $.

There are two ways to register TFTPClient VCL component:

1.- Via online registration : You can register this component from Qwerks Shareware 
Registration Services. Transactions are via Credit Card with the option of making the 
purchase over a secure server, via an U.S. tool free phone or fax.   To do it this way 
please visit TFTPClient web page : http://www.waveflow.com/vcl.htm

2.-Filling the Registration Form and sending me the money (35 $US) to the next postal 
address:

Xavier Cirac Vidal
Batlles , 4
Premia de Mar , 08330
Barcelona
SPAIN

Once I get your registration mail I will e-mail you with the source code and a sample 
demo (also with source code).
 
Registration Form
-----------------

Please Print the next form and fill in the information (if applicable) when you send me 
the registration letter:


Company: 	_________________________________________ 
Name:		_________________________________________ 
E-Mail: 	_________________________________________ 
Address:	_________________________________________ 
City:		_________________________________________ 
State/Province:     ______________________________________ 
Country:	_________________________________________ 

Optional

Where did you find TFTPClient?
_____________________________________________________

What are you using TFTPClient for?
_____________________________________________________


Properties
----------

Information: This is the last information line (for exemple: server responses)
WorkingDirectory: Current server working directory
LastList: The contents of the last call to the LIST function (like MSDOS dir or UNIX ls).
Waiting: Indicates if the client is waiting for the server response.
SoundFile: File to use as sound for an error/connection notification.
User: Login of the user.
Password: Password of the user
Host: Address of the host (FTP server) to connect.
Port: FTP Port (standard:21)
DataType: Type of the data to be transferred (ASCII, Binary or Auto)
Name: Name of the component  


Methods
-------

Create: Creates the component  (Constructor)
MKD: Make Directory (creates a directory in the server).
PWD: Print Working Directory
RMD: Remove Directory (deletes a server directory).
CWD: Change working directory (like MSDOS/Unix cd)
CDUP: Change the working directory to the parent of the current one.
FTPConnect: Connects to the host specified in the Host property with the user and 
password specified in the User and Password properties.
Open: Like FTPConnect but using parameters.
LIST: Lists the contents of the current directory. It is like the MSDOS 'dir' or the 
Unix 'ls'.
DeleteFile: Deletes a server file
Quit: Closes the current session
RenameFile: Changes the name of a server file
Abort: Aborts the current transaction
Cancel: Cancels the current operation even if the client is waiting for a server response.
Put: Uploads a file to the server
Get: Downloads a file from the server
System: Retrieves server system properties
NOOP: No Operation
CustomCommand: Lets you define extra FTP functions.

A simple Example:

procedure TForm1. ButtonFTPConnectClick(Sender: TObject);
begin
	tftpclient1.host:='127.0.0.1';
	tftpclient1.user:='UserName';
	tftpclient1.password:='UserPass';
	tftpclient1.FTPConnect;
	//That's all !!
end;

procedure TForm1. ButtonLISTClick(Sender: TObject);
begin
	showmessage(ftpclient1.list(''));
end;


Events
------

OnError  :Happens if an error occurs
OnInformation: Happens every time that the client needs to show an information (for 
example: server responses, errors...)
OnConnected: Happens when a session is established successfully
OnConnectionClosed : Happens if the connection is closed
OnFileGet: Happens when a file download is completed
OnFilePut: Happens when a file upload is completted                                                

Installation
------------

To Install TFTPClient you have to do the next steps: 

If you have Delphi 7.0 you only have to install the TFTPClient package doing EXACTLY:

-Component
     Install Packages
	Add 
	...and Browse for the TFTPClientpkg7.bpl file
	Check the option "Build with runtime packages" (Must be enabled)
	...and Browse for the TFTPClientpkg7.dcp file
	Check the option "default" (Must be enabled)
	OK
-Copy the file TFTPClientpkg7.bpl to your Windows\System

If you have Delphi 6.0 you only have to install the TFTPClient package doing EXACTLY:

-Component
     Install Packages
	Add 
	...and Browse for the TFTPClientpkg6.bpl file
	Check the option "Build with runtime packages" (Must be enabled)
	...and Browse for the TFTPClientpkg6.dcp file
	Check the option "default" (Must be enabled)
	OK
-Copy the file TFTPClientpkg6.bpl to your Windows\System

If you have Delphi 5.0 you only have to install the TFTPClient package doing EXACTLY:

-Component
     Install Packages
	Add 
	...and Browse for the TFTPClientpkg5.bpl file
	Check the option "Build with runtime packages" (Must be enabled)
	...and Browse for the TFTPClientpkg5.dcp file
	Check the option "default" (Must be enabled)
	OK
-Copy the file TFTPClientpkg5.bpl to your Windows\System

If you have Delphi 4.0 you only have to install the TFTPClient package doing EXACTLY:

-Component
     Install Packages
	Add 
	...and Browse for the TFTPClientpkg4.bpl file
	Check the option "Build with runtime packages" (Must be enabled)
	...and Browse for the TFTPClientpkg4.dcp file
	Check the option "default" (Must be enabled)
	OK
-Copy the file TFTPClientpkg4.bpl to your Windows\System

If you have Delphi 3.0 you only have to install the TFTPClient package doing EXACTLY:

-Component
     Install Packages
	Add 
	...and Browse for the TFTPClientpkg3.dpl file
	Check the option "Build with runtime packages" (Must be enabled)
	...and Browse for the TFTPClientpkg3.dcp file
	Check the option "default" (Must be enabled)
	OK
-Copy the file TFTPClientpkg3.dpl to your Windows\System

If you have Delphi 2.0 you will have to do:

-Component
-Install
-Add (and Browse for the TFTPClient.dcu file)

Note: Remember that you have to install TFTPClient to a directory accessible by Delphi 
(check the Delphi menu option Tools/Environment Options/Library/Library Path). If the 
directory where you have installed TFTPClient is not listed there try to add it or to 
copy TFTPClient files to any of the listed directories.

...and that's all. If setup succeed you will see a new palette called UsefulTools 
(if you are looking for more useful tools please visit http://www.waveflow.com/vcl.htm).