| 1 |
joko |
1.1 |
<HTML> |
| 2 |
|
|
<HEAD> |
| 3 |
|
|
<TITLE>rsync-here.pl</TITLE> |
| 4 |
|
|
<LINK REV="made" HREF="mailto:"> |
| 5 |
|
|
</HEAD> |
| 6 |
|
|
|
| 7 |
|
|
<BODY> |
| 8 |
|
|
|
| 9 |
|
|
<A NAME="__index__"></A> |
| 10 |
|
|
<!-- INDEX BEGIN --> |
| 11 |
|
|
|
| 12 |
|
|
<UL> |
| 13 |
|
|
|
| 14 |
|
|
<LI><A HREF="#name">NAME</A></LI> |
| 15 |
|
|
<LI><A HREF="#synopsis">SYNOPSIS</A></LI> |
| 16 |
|
|
<LI><A HREF="#description">DESCRIPTION</A></LI> |
| 17 |
|
|
<LI><A HREF="#configuration">CONFIGURATION</A></LI> |
| 18 |
|
|
<LI><A HREF="#prerequisites">PREREQUISITES</A></LI> |
| 19 |
|
|
<LI><A HREF="#copyright">COPYRIGHT</A></LI> |
| 20 |
|
|
<LI><A HREF="#todo">TODO</A></LI> |
| 21 |
|
|
</UL> |
| 22 |
|
|
<!-- INDEX END --> |
| 23 |
|
|
|
| 24 |
|
|
<HR> |
| 25 |
|
|
<P> |
| 26 |
|
|
<H1><A NAME="name">NAME</A></H1> |
| 27 |
|
|
<P>rsync-here.pl</P> |
| 28 |
|
|
<P> |
| 29 |
|
|
<HR> |
| 30 |
|
|
<H1><A NAME="synopsis">SYNOPSIS</A></H1> |
| 31 |
|
|
<P>Wrapper around rsync program to provide an easy calling syntax for rsyncing against a predefined target.</P> |
| 32 |
|
|
<P> |
| 33 |
|
|
<HR> |
| 34 |
|
|
<H1><A NAME="description">DESCRIPTION</A></H1> |
| 35 |
|
|
<P>Before starting, your need to configure some specific variables in this file. Please see section CONFIGURATION. |
| 36 |
|
|
rsync-here.pl expects a single argument on the command line. Give it a full directory path and |
| 37 |
|
|
it will run the rsync program in the following style: (abstract)</P> |
| 38 |
|
|
<PRE> |
| 39 |
|
|
cd /$root; \ # go to one level on top of the specified source path |
| 40 |
|
|
$rsync -azuv -R -e ssh --progress $source $target</PRE> |
| 41 |
|
|
<P> |
| 42 |
|
|
<HR> |
| 43 |
|
|
<H1><A NAME="configuration">CONFIGURATION</A></H1> |
| 44 |
|
|
<P>Please edit ``rsync-here.pl'' to configure it, there is no ``.ini''-style configuration file yet.</P> |
| 45 |
|
|
<DL> |
| 46 |
|
|
<DT><STRONG><A NAME="item_%2D_%24sh%3A_%2Fpath%2Fto%2Fyour%2Fsh">- |
| 47 |
|
|
$sh: /path/to/your/sh</A></STRONG><BR> |
| 48 |
|
|
<DD> |
| 49 |
|
|
<DT><STRONG><A NAME="item_%2D_%24rsync%3A_%2Fpath%2Fto%2Fyour%2Frsync">- |
| 50 |
|
|
$rsync: /path/to/your/rsync</A></STRONG><BR> |
| 51 |
|
|
<DD> |
| 52 |
|
|
<DT><STRONG><A NAME="item_%2D_%24target_prefix%3A_username%40host%2Emydomain">- |
| 53 |
|
|
$target_prefix: <A HREF="mailto:username@host.mydomain.org">username@host.mydomain.org</A></A></STRONG><BR> |
| 54 |
|
|
<DD> |
| 55 |
|
|
<DT><STRONG><A NAME="item_%2D_%24target_base%3A_%2Fpath%2Fto%2Fyour%2Fbackup">- |
| 56 |
|
|
$target_base: /path/to/your/backup-repository-base</A></STRONG><BR> |
| 57 |
|
|
<DD> |
| 58 |
|
|
</DL> |
| 59 |
|
|
<P>The hostname of your machine will be appended to ``$target_base'', on windows also the volumename.</P> |
| 60 |
|
|
<P> |
| 61 |
|
|
<HR> |
| 62 |
|
|
<H1><A NAME="prerequisites">PREREQUISITES</A></H1> |
| 63 |
|
|
<UL> |
| 64 |
|
|
<LI><STRONG><A NAME="item_Perl">Perl</A></STRONG><BR> |
| 65 |
|
|
|
| 66 |
|
|
<LI><STRONG><A NAME="item_Rsync">Rsync</A></STRONG><BR> |
| 67 |
|
|
|
| 68 |
|
|
<LI><STRONG><A NAME="item_SSH">SSH</A></STRONG><BR> |
| 69 |
|
|
|
| 70 |
|
|
</UL> |
| 71 |
|
|
<P>You also may find it convenient to setup ssh working with keys. (use ssh-keygen [-d])</P> |
| 72 |
|
|
<P> |
| 73 |
|
|
<HR> |
| 74 |
|
|
<H1><A NAME="copyright">COPYRIGHT</A></H1> |
| 75 |
|
|
<P>This program is free software. You may copy or |
| 76 |
|
|
redistribute it under the same terms as Perl itself.</P> |
| 77 |
|
|
<P> |
| 78 |
|
|
<HR> |
| 79 |
|
|
<H1><A NAME="todo">TODO</A></H1> |
| 80 |
|
|
<DL> |
| 81 |
|
|
<DT><STRONG><A NAME="item_%2B_windows_compatibility">+ windows compatibility</A></STRONG><BR> |
| 82 |
|
|
<DD> |
| 83 |
|
|
<DT><STRONG><A NAME="item_%2B_waiting_for_keypress_on_exit%3A_better_handlin">+ waiting for keypress on exit: better handling</A></STRONG><BR> |
| 84 |
|
|
<DD> |
| 85 |
|
|
<DT><STRONG><A NAME="item_%2B_write_output_to_STDOUT_while_working%21">+ write output to STDOUT while working!</A></STRONG><BR> |
| 86 |
|
|
<DD> |
| 87 |
|
|
<DT><STRONG><A NAME="item_%2D_ease_ssh%2Dkey%2Dsetup_for_non%2Dinteractive_u">- ease ssh-key-setup for non-interactive use, include doc at min!</A></STRONG><BR> |
| 88 |
|
|
<DD> |
| 89 |
|
|
<DT><STRONG><A NAME="item_%2D_read_%22user_%2D_config%22_variables_from_%25E">- read ``user - config'' variables from %ENV</A></STRONG><BR> |
| 90 |
|
|
<DD> |
| 91 |
|
|
<DT><STRONG><A NAME="item_%2D_make_it_possible_to_sync_single_files">- make it possible to sync single files</A></STRONG><BR> |
| 92 |
|
|
<DD> |
| 93 |
|
|
</DL> |
| 94 |
|
|
|
| 95 |
|
|
</BODY> |
| 96 |
|
|
|
| 97 |
|
|
</HTML> |