
                            How to install ftpcopy
                                       
   This document describes how to download, compile, test and install
   ftpcopy.
     _________________________________________________________________
   
System requirements:

   The ftpcopy package is meant to run under UNIX and -lookalikes.
     _________________________________________________________________
   
Downloading ftpcopy:

   The latest published ftpcopy package is [1]ftpcopy-0.3.4.tar.gz. You
   can download it though [2]FTP, too.
     _________________________________________________________________
   
Unpack the package:

  gunzip ftpcopy-0.3.4.tar.gz
  tar -xf ftpcopy-0.3.4.tar
  cd ftpcopy-0.3.4
     _________________________________________________________________
   
Compile the programs:

   $ make
     _________________________________________________________________
   
How to test:

   1. $ ./ftpcopy ftp://SITE/dir/ local-dir
          This will copy the remote directory to the locale directory
          (which will be created, if necessary). Be careful: ftpcopy
          copies ``dir'' and all subdirectories. It will also remove the
          contents of ``local-dir''.
          
          If the ftp server does not support EPLF (e.g., it's not
          publicfile or anonftpd) then you might want to add the -s
          option (to cope with symbolic links).
          
   2. $ ./ftpcopy SITE /dir local-dir
   3. $ ./ftpcopy ftp://SITE/dir/file local-file
   3. $ ./ftpcopy SITE /dir/file local-file2
   4. $ ./ftpcopy SITE /dir/file local-file2
          This should print and do nothing.
          
   5. $ ./ftpcopy -l2 SITE /dir/file local-file2
          This should print something and do nothing.
          
   6. $ ./ftpls ftp://SITE/dir
   7. $ ./ftpls ftp://SITE/dir/file
   8. $ ./ftpls --html ftp://SITE/dir
     _________________________________________________________________
   
Actual installation of ftpcopy:

   As root, install the programs and manual pages under /usr/local:
   
   $ make install
   
   Alternatively you may install them into a different place:
   
   $ make nochown=true prefix=/home/me install

   or install the manual pages in a different place:
   $ make mandir=/somewhere/man install

   See [3]the uoinstall documentation for more information.
     _________________________________________________________________
   
How to report success: (not mandatory)

   $ make REALNAME=``My Name'' systype $ make REALNAME=``My Name''
   systype |mail uwe-generic-counter@ohse.de
   
   Please do not send any email unless the checks were successful.
   
Mailing list

   To subscribe to the ftpcopy mailing list send a mail to
   ftpcopy@lists.ohse.de. The content is ignored.
   
See also:

  [4]Software by Uwe Ohse
  
  [5]The ftpcopy package

References

   1. http://www.ohse.de/uwe/ftpcopy/ftpcopy-0.3.4.tar.gz
   2. ftp://ftp.ohse.de/uwe/ftpcopy/ftpcopy-0.3.4.tar.gz
   3. http://www.ohse.de/uwe/uoinstall.html
   4. file://localhost/home/uwe/work/software.html
   5. file://localhost/home/uwe/work/ftpcopy.html
