summaryrefslogtreecommitdiff
path: root/doc/location_tracking.mdwn
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2010-10-19 15:59:40 -0400
committerGravatar Joey Hess <joey@kitenet.net>2010-10-19 15:59:40 -0400
commit7bc4435ffdc1760a7ac8638cdc1cfac78aebaabb (patch)
treeaf591561fa5bf30c82e9fcbb3c83130edad5bcaf /doc/location_tracking.mdwn
parent6ef1c2d2daf37dc92b4c364ea34802b62688018b (diff)
update
Diffstat (limited to 'doc/location_tracking.mdwn')
-rw-r--r--doc/location_tracking.mdwn28
1 files changed, 28 insertions, 0 deletions
diff --git a/doc/location_tracking.mdwn b/doc/location_tracking.mdwn
new file mode 100644
index 000000000..a7d5c150b
--- /dev/null
+++ b/doc/location_tracking.mdwn
@@ -0,0 +1,28 @@
+git-annex keeps track of in which repositories it last saw a file's content.
+This location tracking information is stored in `.git-annex/$key.log`.
+Repositories record their UUID and the date when they get or drop
+a file's content. (Git is configured to use a union merge for this file,
+so the lines may be in arbitrary order, but it will never conflict.)
+
+This location tracking information is useful if you have multiple
+repositories, and not all are always accessible. For example, perhaps one
+is on a home file server, and you are away from home. Then git-annex can
+tell you what git remote it needs access to in order to get a file:
+
+ # git annex get myfile
+ get myfile(not available)
+ I was unable to access these remotes: home
+
+Another way the location tracking comes in handy is if you put repositories
+on removable USB drives, that might be archived away offline in a safe
+place. In this sort of case, you probably don't have a git remotes
+configured for every USB drive. So git-annex may have to resort to talking
+about repository UUIDs. If you have previously used "git annex init"
+to attach descriptions to those repositories, it will include their
+descriptions to help you with finding them:
+
+ # git annex get myfile
+ get myfile (not available)
+ Try making some of these repositories available:
+ c0a28e06-d7ef-11df-885c-775af44f8882 -- USB archive drive 1
+ e1938fee-d95b-11df-96cc-002170d25c55