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