qftp is a simple program which demonstrates the use of ftplib.qftp performs directories or file transfers using the ftp protocol basedon the command it was invoked with and command line arguments.  qftpshould be invoked through a softlink which indicates which operation itshould perform.To install, copy qftp to a directory in your path.  Execute the followingcommands in that directory:	ln -s qftp ftpdir	ln -s qftp ftpget	ln -s qftp ftpsend	ln -s qftp ftprm	ln -s qftp ftplistThen, invoke qftp by using the commands ftpdir, ftpget, ftpsend, ftprm orftplist.qftp processes the command line in order.  The first argument should bethe name of the system you wish to converse with.  If you need to specifylogin information, that should be specified next with '-l' and '-p'.  OnUNIX systems, if you specify a username with '-l' and don't specify apassword with '-p', qftp will prompt for a password.  It is a good ideato do it this way as it keeps the password off the command line and outof 'ps' and other displays.When working through a proxy firewall, specify the firewall machine'sname as the host.  Specify the real host's name with the -l and -pparameters.  For example:	ftpget firewall -l anonymous@real.host.com -p user@myhost.orgThe exit status from qftp can be used to determine whether the transferworked or not.  Exit status 2 means a command line syntax error.  3indicates a failure while attempting to translate the system name into anIP address.  4 indicates a failure attempting to connect to the remotemachine.  5 indicates a login failure.  6 indicates a remote commanderror.  7 indicates a system call error.The command format is as follows:	<xxx> host [ -l user [ -p pass ] ]		   [ [ -v level ]		     [ -m umask ]		     [ -r path ]		     [ -a | -i ]		     [ file ]		   ] ...<xxx> should be replaced with 'ftpget', 'ftpdir', 'ftpsend', 'ftprm' or'ftplist'.  'host' is the name of the remote server machine and shouldimmediately follow the command.'-l user' specifies the username to login with.  '-p pass' specifies thepassword to use with that username.  These should be specifiedimmediately after the hostname.  On UNIX systems, if a username isspecified but a password is not, qftp will prompt for a password.  Ifneither is specified, an anonymous login is attempted.'-v level' can be used to set the logging level of the routines.  Thiscan appear anywhere on the command line and will affect the logging ofany actions performed on later command line arguments.  Non-zerovalues cause qftp to log the actions it performs and display progress.Values greater than 1 cause ftplib to display responses received fromthe server.  Values greater than 2 cause ftplib to display commandssent to the server.'-r path' can be used to change to a different directory on the server.'-m umask' attempts to change the default permissions mask on the serverby issuing a 'SITE umask' command.  This will not work with all serversbut should work with almost any unix based server.'-a' and '-i' set ASCII and Image mode, respectively.  This will apply toall files transfered until another '-a' or '-i' is encountered on thecommand line.'file' specifies the name of a file to transfer.  The specified file namewill be used on both the local machine and the server.  If no files arespecified for 'ftpget' or 'ftpsend', a list of file names will be readfrom stdin.ExamplesI use ftpsend to upload my web pages to my ISP.  I maintain them all onmy home PC under linux and send either the entire directory tree or justmodified files with ftpsend.To send the entire directory tree, I execute the following command frommy login directory:	find public_html -print | ftpsend cnj -l pfau -m 022(connect to system cnj, login as user pfau and prompt for a password, setthe umask to 022, send files whose names will be read from standard inputwhich is generated by the 'find' command which lists all files under mypublic_html directory)If I modify a file or two, I'll send them from my html directory with thefollowing command:	ftpsend cnj -l pfau -m 022 -r public_html index.html hot.html(connect to system cnj, login as user pfau and prompt for a password, setthe umask to 022, change directory to public_html, send files index.htmland hot.html)To grab the latest directory listing of the linux area off of sunsite:	ftpget sunsite.unc.edu -r /pub/Linux ls-lR.gz(connect to system sunsite.unc.edu, use an anonymous login, switch todirectory /pub/Linux, get file ls-lR.gz)