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.

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 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).