| 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> |