summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/design/assistant/chunks.mdwn15
-rw-r--r--doc/internals.mdwn10
2 files changed, 9 insertions, 16 deletions
diff --git a/doc/design/assistant/chunks.mdwn b/doc/design/assistant/chunks.mdwn
index c20bb9aab..d7517243c 100644
--- a/doc/design/assistant/chunks.mdwn
+++ b/doc/design/assistant/chunks.mdwn
@@ -160,17 +160,12 @@ the git-annex branch.
The location log does not record locations of individual chunk keys
(too space-inneficient).
Instead, look at git-annex:aaa/bbb/SHA256-s12345--xxxxxxx.log.cnk to get
-the chunk count and size for a key. File format would be:
+the chunk count and size for a key.
- ts uuid chunksize chunkcount
-
-Where a chunkcount of 0 means that the object is not longer present in the
-remote using the specified chunk size.
-
-Note that a given remote uuid might have multiple lines, if a key was
-stored on it twice using different chunk sizes. Also note that even when
-this file exists for a key, the object may be stored non-chunked on the
-remote too.
+Note that a given remote uuid might have multiple chunk sizes logged, if a
+key was stored on it twice using different chunk sizes. Also note that even
+when this file exists for a key, the object may be stored non-chunked on
+the remote too.
`hasKey` would check if any one (chunksize, chunkcount) is satisfied by
the files on the remote. It would also check if the non-chunked key is
diff --git a/doc/internals.mdwn b/doc/internals.mdwn
index 5cb8ec5aa..71d1b0380 100644
--- a/doc/internals.mdwn
+++ b/doc/internals.mdwn
@@ -224,16 +224,14 @@ are indicated by prefixing them with "!"
These log files are used when objects are stored in chunked form on
remotes. They record the size(s) of the chunks, and the number of chunks.
-For example, this logs that a remote has an object stored using 9 chunks
-of 1 mb size:
+For example, this logs that a remote has an object stored using both
+9 chunks of 1 mb size, and 1 chunk of 10 mb size.
- 1287290776.765152s e605dca6-446a-11e0-8b2a-002170d25c55 10240 9
+ 1287290776.765152s e605dca6-446a-11e0-8b2a-002170d25c55:10240 9
+ 1287290776.765153s e605dca6-446a-11e0-8b2a-002170d25c55:102400 1
(When those chunks are removed from the remote, the 9 is changed to 0.)
-For future expansion, additional fields may be present following the
-number of chunks.
-
## `schedule.log`
Used to record scheduled events, such as periodic fscks.