git @ Cat's Eye Technologies ellsync / 0.1
Fix error in README and describe removable media situation better. Chris Pressey 2 years ago
1 changed file(s) with 7 addition(s) and 8 deletion(s). Raw diff Collapse all Expand all
2020 }
2121 }
2222
23 In this, `art` is the name of a "backup stream", in which files in
23 In this, `art` is the name of a _backup stream_, in which files in
2424 `/media/user/External1/art/` (called the *canonical*) are periodically
2525 synced to `/home/user/art/` (called the *cache*).
2626
2727 The idea is that all changes to the contents of the canonical directory
2828 are bona fide changes, but any change to the contents of the cache can be
2929 discarded.
30
31 Either depository may be offline, therefore neither directory is assumed
32 to exist (it might not exist if the volume is not mounted.)
3330
3431 With this router saved as `router.json` we can then say
3532
5148 ellsync router.json /media/user/External1/art/ /home/user/art/
5249
5350 we will be prevented, because it is an error, because the direction of
54 the backup stream is always from cache to canonical.
51 the backup stream is always from canonical to cache.
5552
5653 Various other configurations are prevented. You may have noticed that rsync
5754 is sensitive about whether a directory name ends in a slash or not. ellsync
7269
7370 ellsync router.json art:
7471
75 If either of the directories does not exist, this will be prevented.
76 Based on this, there is a subcommand to list which streams are, at the moment,
77 backupable:
72 Either the canonical or the cache (or both) may be offline storage (removable
73 media), therefore neither directory is assumed to exist (it might not exist
74 if the volume is not mounted.) If either of the directories does not exist,
75 ellsync will refuse to use this backup stream. Based on this, there is a
76 subcommand to list which streams are, at the moment, backupable:
7877
7978 ellsync router.json list
8079