path: root/notes-cache.h
diff options
authorJeff King <>2010-04-02 00:07:40 (GMT)
committerJunio C Hamano <>2010-04-02 06:58:30 (GMT)
commita941d5e3958ece565570a2dc3a5476ff5242f340 (patch)
treea7d558a3602c0ccebe33ba346995f470e0636250 /notes-cache.h
parent40d52ff77b093fa48f58a168f4b0c4e65b862e56 (diff)
introduce notes-cache interface
Notes provide a fast lookup mechanism for data keyed by sha1. This is ideal for caching certain operations, like textconv filters. This patch builds some infrastructure to make it simpler to use notes trees as caches. In particular, caches: 1. don't have arbitrary commit messages. They store a cache validity string in the commit, and clear the tree when the cache validity string changes. 2. don't keep any commit history. The accumulated history of a a cache is just useless cruft. 3. use a looser form of locking for ref updates. If two processes try to write to the cache simultaneously, it is OK if one overwrites the other, losing some changes. It's just a cache, so we will just end up with an extra miss. Signed-off-by: Jeff King <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'notes-cache.h')
1 files changed, 20 insertions, 0 deletions
diff --git a/notes-cache.h b/notes-cache.h
new file mode 100644
index 0000000..356f88f
--- /dev/null
+++ b/notes-cache.h
@@ -0,0 +1,20 @@
+#ifndef NOTES_CACHE_H
+#define NOTES_CACHE_H
+#include "notes.h"
+struct notes_cache {
+ struct notes_tree tree;
+ char *validity;
+void notes_cache_init(struct notes_cache *c, const char *name,
+ const char *validity);
+int notes_cache_write(struct notes_cache *c);
+char *notes_cache_get(struct notes_cache *c, unsigned char sha1[20], size_t
+ *outsize);
+int notes_cache_put(struct notes_cache *c, unsigned char sha1[20],
+ const char *data, size_t size);
+#endif /* NOTES_CACHE_H */