SYNOPSIS

getls-lR [--help] [--version] SITE RPATH LPATH

DESCRIPTION

getls-lR, getls-lR.exp and getls-lR.pl are three example scripts each of which perform the same function but using different libraries or languages. They are examples of how to use the ls-lR files generated on remote FTP servers by mkls-lR to keep a local copy of the remote directory listing up to date with minimal download volume. Your FTP mirror program or script must be able to use such a local copy or be modified to use it before getls-lR is useful.

These scripts log into FTP server SITE anonymously or from a ~/.netrc file, request the file RPATH.times and then from this and file LPATH decide whether to: do nothing as LPATH is up to date; get RPATH.patch.gz and patch LPATH; or FTP RPATH.gz and replace LPATH.

Please see README.ls-lR for details of patches to allow version 2.9 of Lee McLoughlin's perl script mirror to use these ls-lR files. getls-lR and workalikes are for systems which do not have Lee's mirror 2.9 or cannot use it and as an example of how to modify a mirror program to use mkls-lR's output like mirror 2.9 can.

getls-lR is a perl script which uses Lee McLoughlin's ftp.pl and lchat.pl from directory /usr/lib/mirror Linux hostname and GNU gunzip and patch.

getls-lR.exp is an expect script which uses an ftp client program and GNU gunzip and patch. It is the fastest and uses the least memory of the three scripts.

getls-lR.pl is a perl script which uses Net::FTP and Net::Netrc from the standard perl library and GNU gunzip and patch.

EXAMPLE

getls-lR would normally be started by cron several times a day to ensure the local copy of the remote ls-lR is up to date when the local mirror program wishes to use it.

getls-lR ctan.unsw.edu.au /pub/ls-lR /home/ftp/pub/remote_ls-lR

Download ls-lR.times from ctan.unsw.edu.au directory /pub and then do nothing or download either ls-lR.patch.gz and patch or ls-lR.gz and replace local file remote_ls-lR in local directory /home/ftp/pub.

OPTIONS

--help

Display help message then exit.

--version

Display version and copyright message then exit.

AUTHOR

Ian Maclaine-cross 14th September 1999