--restore-as-of date range specification not explained in man page
Wed, 21 Aug 2002 00:41:47 +0200
* Ben Escoto <email@example.com> [20. Aug. 2002]:
>>>>> "GZ" == Gregor Zattler <firstname.lastname@example.org>
>>>>> wrote the following on Tue, 20 Aug 2002 17:01:09 +0200
GZ>> When i read the man page i did not find information on how
GZ>> rdiff-backup decides which backup to use if the "-r
GZ>> a) is not specific enough (multiple backups belonging to the
GZ>> specified date range, e.g. ... -r 3D ... with two backups three
GZ>> days ago)
GZ>> b) does not match any backup (no backups belonging to the
GZ>> specified date range; e.g. ...-r 3D ... with backups two days
GZ>> ago and seven days ago)
GZ>> I think this should be explained in the man pages "RESTORING"
GZ>> section and perhaps explained with examples in the "EXAMPLES"
> I can see how it could be a bit confusing. Would it clear things up
> if I added this paragraph to the RESTORING section?
> Note that the option to --restore-as-of always specifies
> an exact time. (So "3D" refers to the instant 36 hours
> before the present.) If there was no backup made at that
> time, rdiff-backup restores the state recorded for the
> previous backup. For instance, in the above case, if "3D"
> is used, and there are only backups from 2 days and 4 days
> ago, /usr/local as it was 4 days ago will be restored.
Yes, your Text is very clear: There is no "date range". But put
the following lines also in:
> If you are not sure exactly which version of a file you need, it is
> probably easiest to either restore from the increments files, or to
> see which increments are available with -l/--list-increments, and then
> specify exact times into -r/--restore-as-of.
It's good advise.
"The future is here. It's just not widely distributed yet."
-- William Gibson