{"thread":{"id":"54818","subject":"[PATCH] index-format.txt: document v2 format of file system monitor extension","startedAt":"2020-12-14T13:35:05Z","lastAt":"2020-12-14T13:35:05Z","messageCount":1,"participants":["Jeff Hostetler via GitGitGadget"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"412165","messageId":"pull.813.git.1607952822848.gitgitgadget@gmail.com","threadId":"54818","inReplyTo":null,"subject":"[PATCH] index-format.txt: document v2 format of file system monitor extension","fromName":"Jeff Hostetler via GitGitGadget","fromEmail":"gitgitgadget@gmail.com","sentAt":"2020-12-14T13:33:42Z","receivedAt":"2020-12-14T13:35:05Z","isPatch":true,"sender":{"key":"git@jeffhostetler.com","avatar":null},"body":"From: Jeff Hostetler <jeffhost@microsoft.com>\n\nUpdate the documentation of the file system monitor extension to\ndescribe version 2.\n\nThe format was extended to support opaque tokens in:\n56c6910028 fsmonitor: change last update timestamp on the index_state to opaque token\n\nSigned-off-by: Jeff Hostetler <jeffhost@microsoft.com>\n---\n    index-format.txt: document v2 format of file system monitor extension\n    \n    While studying the FSMonitor code I noticed that the documentation for\n    the FSMN index extension did not get updated for V2 format.\n\nPublished-As: https://github.com/gitgitgadget/git/releases/tag/pr-813%2Fjeffhostetler%2Ffix-fsmonitor-v2-documentation-v1\nFetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-813/jeffhostetler/fix-fsmonitor-v2-documentation-v1\nPull-Request: https://github.com/gitgitgadget/git/pull/813\n\n Documentation/technical/index-format.txt | 10 ++++++++--\n 1 file changed, 8 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/technical/index-format.txt b/Documentation/technical/index-format.txt\nindex f9a3644711b..69edf46c031 100644\n--- a/Documentation/technical/index-format.txt\n+++ b/Documentation/technical/index-format.txt\n@@ -306,12 +306,18 @@ The remaining data of each directory block is grouped by type:\n \n   The extension starts with\n \n-  - 32-bit version number: the current supported version is 1.\n+  - 32-bit version number: the current supported versions are 1 and 2.\n \n-  - 64-bit time: the extension data reflects all changes through the given\n+  - (Version 1)\n+    64-bit time: the extension data reflects all changes through the given\n \ttime which is stored as the nanoseconds elapsed since midnight,\n \tJanuary 1, 1970.\n \n+  - (Version 2)\n+    A null terminated string: an opaque token defined by the file system\n+    monitor application.  The extension data reflects all changes relative\n+    to that token.\n+\n   - 32-bit bitmap size: the size of the CE_FSMONITOR_VALID bitmap.\n \n   - An ewah bitmap, the n-th bit indicates whether the n-th index entry\n\nbase-commit: 3cf59784d42c4152a0b3de7bb7a75d0071e5f878\n-- \ngitgitgadget\n"}]}