X-Git-Url: https://ruderich.org/simon/gitweb/?p=nsscash%2Fnsscash.git;a=blobdiff_plain;f=nss%2Ffile.h;h=fb94a8f2017d29c242d484dee4c87a7bce945f81;hp=9560bc3379182edbcabd94ce14e7756b622de4d6;hb=c42f577140459f548b1d7b085cd4dc2717e060c6;hpb=67fb8cb9a157931c94bb420f25c36d55c2876d02

diff --git a/nss/file.h b/nss/file.h
index 9560bc3..fb94a8f 100644
--- a/nss/file.h
+++ b/nss/file.h
@@ -25,6 +25,8 @@
 #include <stdlib.h>
 
 
+// Magic value at the beginning of each nsscash file (8 byte, without the
+// trailing NUL)
 #define MAGIC "NSS-CASH"
 
 // Defined in Makefile
@@ -36,11 +38,13 @@
 #endif
 
 
+// header describes the on-disk (and, after loading via mmap, in-memory)
+// structure of nsscash files.
 struct header {
     char magic[8]; // magic string
     uint64_t version; // also doubles as byte-order check
 
-    uint64_t count;
+    uint64_t count; // number of entries in this file
 
     // All offsets are relative to data
     uint64_t off_orig_index;
@@ -51,6 +55,7 @@ struct header {
     char data[];
 } __attribute__((packed));
 
+// file represents an open nsscash file.
 struct file {
     int fd;
     size_t size;