---- This is translated document for your convinience. ---

Guidance of ftpmirror-1.96

* Introduction

One year or more has passed for the first time the 
development of ftpmirror-2.0 branch. 
It is reworking of ftpmirror-1.2 branch from scrach.

Im busy, and doesn't make progress. However, I want 
to fix the bug, new version of 1.96 is release now.

Some bugs still remains, I will fix them.

* About Changes

Changelog from 1.2k is below (But it is not included always,
because new version have a lot of changes).

o Mirroring function supports PUT mode.
  (When it is allowed, execute chmod at remote side)

o Most parts were coding as module. 

o MD5 support is currently wrote by XS, and direct 
 execution is support now.

o Mirroring function supports http proxy.
(restriction: this func need dirinfo or ls-lR, and so on..)

o Using AutoSplit. It can efficiency loading.

o New feature (work in progress) : "INDEX mode".
  It will could usefull mirroring including diff management.

o Directory name conversion support for easy configuration.
  For example,  ~ftp/pub  and  ~ftp/pub/%s and so on.

o resource checking with getrusage command.

o In FTP mode, login retry  and  reconnect when timed out 
  is supports now. 

Restriction:
1.2k's functions of "unlink-limit" and "follow-symlink-regexp" 
and some functions are not implemented yet. 
These will come back at future release.

* Bug fix information

Newly version(1.96)'s fixlist is below. I will have corrected them.

o Fix: problem of STAT commands, it with wu-ftpd and so on.

o Fix: mirroring fail when include '_' in owner and group strings.

* About version strings

Currently version is 1.96. I will release incremetal versions
(1.97, 1.98, 1.99...) in beta-phase, product release is using 2.0.
But, if heavy bug remains, and/or in features enhancement,
they have a possibility of branch 1.99 --> 1.991 ;)

* How to install

There is configurable from this version.

Please type:

% ./configure

% make

% su

# make install

so installing /usr/local/bin/ftpmirror and perl library.

perl library is installed for site-addon, for example 
"/usr/local/lib/perl5/site_perl".

appendix modules are:

Fan.pm

Fan/Attrib.pm

Fan/Cool.pm

Fan/DIR.pm

Fan/FTP.pm

Fan/Farm.pm

Fan/HTTP.pm

Fan/Loader.pm

Fan/MD5.pm

Fan/Param.pm

Fan/Scan.pm

Fan/TCP.pm

Fan/Usage.pm

and their derivation objects.


In default, samples configuration file

/usr/local/etc/ftpmirror.cf-sample

is dropped at installation. Please copy this file, 
and edit for your configuration.

# cd /usr/local/etc

# cp ftpmirror.cf-sample ftpmirror.cf

# vi ftpmirror.cf

This sample is include basic settings, please wrote your 
archive places and so on. Configuration syntax is wrote
at README files.

* Copyrights

Omitted in translation, please see "COPYRIGHT" files.

* Special thanks

Thanks for RingProject members, and ftpmirror mailing 
list members. You are provide very important informations 
and helpful adivices. Thank you sincerely. 

# Notice: Development will start the most severe part :-p
# please cooperate further.  > ALL

* epilogue

If you have comments, ideas, bug reports,
 please send message to ikuo@jp.freebsd.org . 

Dec 27, 1999, Ikuo Nakagawa

---- This is translated document for your convinience. ---

--------------------------------------------------------------------------------

 Translated into English on 2007-07-07 by Fumihito YOSHIDA <hito@kugutsu.org>.

--------------------------------------------------------------------------------

