document new chunk logfiles

1 files changed, 15 insertions, 0 deletions

diff --git a/doc/internals.mdwn b/doc/internals.mdwn
index bf0fa668c..5cb8ec5aa 100644
--- a/doc/internals.mdwn
+++ b/doc/internals.mdwn
@@ -219,6 +219,21 @@ reasonably short. If the value contains any whitespace
 (including \r or \r), it will be base64 encoded. Base64 encoded values
 are indicated by prefixing them with "!" 
 
+## `aaa/bbb/*.log.cnk`
+
+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:
+
+	1287290776.765152s e605dca6-446a-11e0-8b2a-002170d25c55 10240 9
+
+(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.