NAME

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

SYNOPSIS

 use Net::UploadMirror;
 my $um = Net::UploadMirror->new(
	ftpserver		=> "my_ftp.hostname.com",
	usr		=> "my_ftp_usr_name",
	pass		=> "my_ftp_password",
	);
$um->Update();

or more detailed
my $md = Net::UploadMirror->new(
	ftpserver		=> "my_ftp.hostname.com",
	usr		=> "my_ftp_usr_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]
	file_name	=> "modified_times"
	);
$um->Update();

DESCRIPTION

This module is for mirroring a local directory to a remote location via FTP. For example websites, documentations or developmentstuff which ones were worked on locally. It is not developt for mirroring large archivs. But there are not in principle any limits.

Constructor and Initialization =item (object) new (options) Net::UploadMirror is a derived class from Net::MirrorDir. For detailed information about constructor or options read the documentation of Net::MirrorDir.

methods

(1) _Init(%arg) This function is called by the constructor. You do not need to call this function by yourself.

(1) Update (void) Call this function for mirroring automatically, recommended!!!

(ref_hash_modified_files) CheckIfModified (ref_list_local_files) Takes a hashreference of local files to compare the last modification stored in a file "lastmodified_local" while uploading. Returns a reference of a list.

(1) StoreFiles (ref_list_paths) Takes a listreference of local-paths to upload the files via FTP.

(1) MakeDirs (ref_list_paths) Takes a listreference of directorys to make in the remote location.

(1) DeleteFiles (ref_list_paths) Takes a listreference of files to delete in the remote location.

(1) RemoveDirs (ref_list_paths) Takes a listreference of directories to remove in the remote location.

optional optiones

file_name The name of the file in which the last modified times will be stored. default = "lastmodified_local"

EXPORT

None by default.

SEE ALSO

Net::MirrorDir Net::DownloadMirror Tk::Mirror http://www.planet-interkom.de/t.knorr/index.html

FILES

Net::MirrorDir Storable File::Basename

BUGS

Maybe you'll find some. Let me know.

REPORTING BUGS

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

AUTHOR

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

COPYRIGHT AND LICENSE

Copyright (C) 2005 - 2008 by Torsten Knorr

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.9.2 or, at your option, any later version of Perl 5 you may have available.