Net::DownloadMirror - Perl extension for mirroring a remote location via FTP to the local directory


Net-DownloadMirror documentation  | view source Contained in the Net-DownloadMirror distribution.

Index


NAME

Top

Net::DownloadMirror - Perl extension for mirroring a remote location via FTP to the local directory

SYNOPSIS

Top

  use Net::DownloadMirror;
  my $um = Net::DownloadMirror->new(
 	ftpserver		=> 'my_ftp.hostname.com',
 	user		=> 'my_ftp_user_name',
 	pass		=> 'my_ftp_password',
 	);
 $um->Download();

 or more detailed
 my $md = Net::DownloadMirror->new(
 	ftpserver		=> 'my_ftp.hostname.com',
 	user		=> 'my_ftp_user_name',
 	pass		=> 'my_ftp_password',
 	localdir		=> 'home/nameA/homepageA',
 	remotedir	=> 'public',
 	debug		=> 1 # 1 for yes, 0 for no
 	timeout		=> 60 # default 30
 	delete		=> 'enable' # default 'disabled'
 	connection	=> $ftp_object, # default undef
# "exclusions" default empty arrayreferences []
 	exclusions	=> ["private.txt", "Thumbs.db", ".sys", ".log"],
# "subset" default empty arrayreferences [ ]
 	subset		=> [".txt, ".pl", ".html", "htm", ".gif", ".jpg", ".css", ".js", ".png"],
# or substrings in pathnames
#	exclusions	=> ["psw", "forbidden_code"]
#	subset		=> ["name", "my_files"]
# or you can use regular expressions
# 	exclusinos	=> [qr/SYSTEM/i, $regex]
# 	subset		=> {qr/(?i:HOME)(?i:PAGE)?/, $regex]
 	filename		=> "modified_times",
 	);
 $um->Download();

DESCRIPTION

Top

This module is for mirroring a remote location to a local directory via FTP. For example websites, documentations or developmentstuff which ones were uploaded or changed in the net. Local files will be overwritten, also in case they are newer. It is not developt for mirroring large archivs. But there are not in principle any limits.

Constructor and Initialization

Top

methods

optional options

 =item delete
 When directories or files are to be deleted = 'enable'
 default = 'disabled'

EXPORT

None by default.

SEE ALSO

Top

 Net::MirrorDir
 Net::UploadMirror
 Tk::Mirror
 http://freenet-homepage.de/torstenknorr/index.html

FILES

Top

 Net::MirrorDir 0.19
 Storable
 File::Path

BUGS

Top

Maybe you'll find some. Let me know.

REPORTING BUGS

Top

When reporting bugs/problems please include as much information as possible.

AUTHOR

Top

Torsten Knorr, <create-soft@tiscali.de>

COPYRIGHT AND LICENSE

Top


Net-DownloadMirror documentation  | view source Contained in the Net-DownloadMirror distribution.