{"header":{"message":"Add new pristine subcommand","description":"As a starting point in the task of trying to understand the pristine\ndatabase format, create a subcommand - pristine - that can be used to\ndump various bits of information from a repository .pijul/pristine/db\nfile.\n\nFor now, the subcommand parses out the globalheader in each root page,\nand prints the information there. We have learned that Pijul uses a\nfixed number of root pages (2), but Sanakirja supports a user-provided\nnumber of roots.\n","timestamp":"2024-01-03T19:53:53.851035279Z","authors":[{}]},"hash":"ZYBYX2TBKWAKNMPCWT3B7CJRDEO3LOENGOXZF27JGD4UH6YCN25AC","authors":[{"login":"laumann","key":"3hFDodmFeE2ctGSdVvGCMGGumCr5RyZx83fRqEiTgwJg"}],"deps":{"hashes":[["ZYBYX2TBKWAKNMPCWT3B7CJRDEO3LOENGOXZF27JGD4UH6YCN25AC","Add new pristine subcommand"],["AA",null],["SMB3M6ESOIR2LMFII2VFQJSPFIUYXHD7CXYARIGOKPB2QF2ORFLAC","change: rework to make more testable"],["B3XLVPNC4COLLC3FUE34Y7HIKTMF6CJZUASZOU3YM2YGPZKJZP7QC","Add ani.c and initial Makefile"],["ZPNA2D42RFGGC45PLDYDGQUDPC7D4NBEH2HD4Y2L5P2CK3R52FAQC","ani: add functions to locate .pijul"],["YM2LC6QP2D7TK3JUKOXWUWTQEGMCEGQDGPTOZPWC3BRDFNRKSZWQC","wrap vendored blake3 in own file, #2"],["L3HKOF4WYZZLJJY2Q6YJ65WGAB74GQ2A7ICD23M5NQGBP4BXF6DQC","wrap vendored zstd seekable in own file, #2"],["XTKRT6OQYN4LARQRDLI2KBSAJTOFZNT4AMBZ46CPUDZXD7IDYYWQC","format the codebase"],["XJ2PEH74CLJUELZBR47QHGUSKXB4Z5T7EKEF6Y4CYY2VBHZXUTDAC","add meson.build"],["Q7TKZCJP2Z75EICZYKCEZDHKGERSOKZGMTSU3UXETBHTF663T66AC","Add initial support for reading the offsets from a (fixed) change"],["67HZZ5HS7AA5KA6W4TV24YMO33V5FR6GJ34P3FPTRN547RFNL4DQC","meson: shuffle lib and exe sources"],["PEUS54XQ5KJQYAVUYBG5MWLEHIOVPMZ3ANVC7HPQP6JUWWPRDW5AC",""],["FB67XX5EGNF45JNAQISW7CBLSLS36F6JEUOBTTPUMVBMOVLGA3VQC","add argument parsing setup"],["ZTDGWUGPKDVIUA6V5BZ5ATDTGKZEE6ZZIXLGNTUJU2KIV7H7YSVQC","add repository structure"],["DRK7G22JO77N3RP5SS4ICZODMLYHJONKNPXREODMFC6YZVDHUXBQC","Add header guard to commands.h"]],"deps":["SMB3M6ESOIR2LMFII2VFQJSPFIUYXHD7CXYARIGOKPB2QF2ORFLAC"],"known":["B3XLVPNC4COLLC3FUE34Y7HIKTMF6CJZUASZOU3YM2YGPZKJZP7QC","Q7TKZCJP2Z75EICZYKCEZDHKGERSOKZGMTSU3UXETBHTF663T66AC","XTKRT6OQYN4LARQRDLI2KBSAJTOFZNT4AMBZ46CPUDZXD7IDYYWQC","XJ2PEH74CLJUELZBR47QHGUSKXB4Z5T7EKEF6Y4CYY2VBHZXUTDAC","L3HKOF4WYZZLJJY2Q6YJ65WGAB74GQ2A7ICD23M5NQGBP4BXF6DQC","YM2LC6QP2D7TK3JUKOXWUWTQEGMCEGQDGPTOZPWC3BRDFNRKSZWQC","ZPNA2D42RFGGC45PLDYDGQUDPC7D4NBEH2HD4Y2L5P2CK3R52FAQC"]},"hunks":[{"Replacement":{"inode":{"change":3,"pos":36},"path":"meson.build","line":32,"ins":{"up_context":[{"change":3,"pos":14}],"down_context":[{"change":3,"pos":357}],"flag":"BLOCK","start":0,"end":24,"inode":{"change":3,"pos":36}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":14},"to":{"change":2,"start":10185,"end":10198},"introduced_by":2}],"inode":{"change":3,"pos":36}},"ins_contents":[{"Add":" 'change.c',"},{"Add":" 'db.c',"}],"del_contents":[{"Del":" 'change.c'\n"}]}},{"Edit":{"inode":{"change":3,"pos":36},"path":"meson.build","line":46,"atom":{"NewVertex":{"up_context":[{"change":11,"pos":124}],"down_context":[{"change":11,"pos":137}],"flag":"BLOCK","start":25,"end":45,"inode":{"change":3,"pos":36}}},"contents":[{"Add":" 'cmd-pristine.c',"}]}},{"FileAdd":{"meta":{"basename":"db.h","metadata":0},"context":[{"change":12,"pos":1}],"contents":[{"Add":"#ifndef ANI_DB_H"},{"Add":"#define ANI_DB_H"},{"Add":""},{"Add":"struct globalheader {"},{"Add":"\tu16 version; // sanakirja version"},{"Add":"\tu8 root; // which page is currently the root page?"},{"Add":"\tu8 nroots; // how many root pages are there?"},{"Add":"\tu32 crc; // CRC of this page"},{"Add":"\tu64 length; // first free page at the end of the file"},{"Add":"\tu64 freedb; // offset of the free list"},{"Add":"\tu64 rcdb; // offset of the RC db"},{"Add":"};"},{"Add":""},{"Add":"void dbrun(char *);"},{"Add":""},{"Add":"#endif"}]}},{"FileAdd":{"meta":{"basename":"db.c","metadata":0},"context":[{"change":12,"pos":1}],"contents":[{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":""},{"Add":"#include "},{"Add":""},{"Add":"#include \"common.h\""},{"Add":"#include \"types.h\""},{"Add":"#include \"scaffold.h\""},{"Add":"#include \"db.h\""},{"Add":""},{"Add":"#define err(msg) \\"},{"Add":"\tdo { \\"},{"Add":"\t\tperror(msg); \\"},{"Add":"\t\texit(EXIT_FAILURE); \\"},{"Add":"\t} while (0)"},{"Add":""},{"Add":"static void"},{"Add":"dumpbytes(u8 *mem, usize len)"},{"Add":"{"},{"Add":"\tusize i;"},{"Add":"\tfor (i = 0; i < len; i++) {"},{"Add":"\t\tprintf(\"%02x \", mem[i]);"},{"Add":"\t}"},{"Add":"\tprintf(\"\\n\");"},{"Add":"}"},{"Add":""},{"Add":"static void"},{"Add":"readglobalheader(u8 *mem, struct globalheader *gh)"},{"Add":"{"},{"Add":"\tdumpbytes(mem, sizeof(struct globalheader));"},{"Add":""},{"Add":"\t// FIXME: Does not work for big-endian systems"},{"Add":"\t*gh = *((struct globalheader *)mem);"},{"Add":"}"},{"Add":""},{"Add":"static void"},{"Add":"printglobalheader(struct globalheader *gh, bool currentroot)"},{"Add":"{"},{"Add":"\tprintf(\"version = %u root = %u %s nroots = %u\\n\", gh->version, gh->root,"},{"Add":"\t currentroot ? \"(current)\" : \"\", gh->nroots);"},{"Add":"\tprintf(\"CRC = 0x%04x (%u)\\n\", gh->crc, gh->crc);"},{"Add":"\tprintf(\"length = %lu (0x%08lx)\\n\", gh->length, gh->length);"},{"Add":"\tprintf(\"freedb = %lu\\n\", gh->freedb);"},{"Add":"\tprintf(\"rcdb = %lu\\n\", gh->rcdb);"},{"Add":"}"},{"Add":""},{"Add":"void"},{"Add":"dbrun(char *db)"},{"Add":"{"},{"Add":"\tint fd;"},{"Add":"\tu8 *addr;"},{"Add":"\tu8 nroots, curroot;"},{"Add":"\tsize i;"},{"Add":"\tstruct globalheader gh;"},{"Add":""},{"Add":"\tprintf(\"opening %s\\n\", db);"},{"Add":""},{"Add":"\tfd = open(db, O_RDONLY);"},{"Add":"\tif (fd == -1)"},{"Add":"\t\terr(\"open\");"},{"Add":""},{"Add":"\tusize length = 4096;"},{"Add":"\tint prot = PROT_READ; // memory protection; PROT_{EXEC,READ,WRITE,NONE}"},{"Add":"\tint flags = MAP_PRIVATE; // determines visibility"},{"Add":"\toff_t offset = 0;"},{"Add":"\taddr = mmap(NULL, length, prot, flags, fd, offset);"},{"Add":"\tif (addr == MAP_FAILED)"},{"Add":"\t\terr(\"mmap\");"},{"Add":""},{"Add":"\treadglobalheader(addr, &gh);"},{"Add":"\tmunmap(addr, length);"},{"Add":"\tnroots = gh.nroots;"},{"Add":"\tcurroot = gh.root;"},{"Add":""},{"Add":"\tprintglobalheader(&gh, curroot == 0);"},{"Add":""},{"Add":"\t// for nroots-1 times, read the i << 12'th page"},{"Add":"\tfor (i = 1; i < nroots; i++) {"},{"Add":"\t\taddr = mmap(NULL, length, prot, flags, fd, i << 12);"},{"Add":"\t\tif (addr == MAP_FAILED)"},{"Add":"\t\t\terr(\"mmap2\");"},{"Add":"\t\treadglobalheader(addr, &gh);"},{"Add":"\t\tmunmap(addr, length);"},{"Add":""},{"Add":"\t\tprintglobalheader(&gh, curroot == i);"},{"Add":"\t}"},{"Add":""},{"Add":"\tclose(fd);"},{"Add":"}"}]}},{"Edit":{"inode":{"change":13,"pos":1044},"path":"commands.h","line":6,"atom":{"NewVertex":{"up_context":[{"change":14,"pos":423}],"down_context":[{"change":15,"pos":40}],"flag":"BLOCK","start":2471,"end":2530,"inode":{"change":13,"pos":1044}}},"contents":[{"Add":"int cmd_pristine(int, const char **, struct repository *);"}]}},{"FileAdd":{"meta":{"basename":"cmd-pristine.c","metadata":0},"context":[{"change":12,"pos":1}],"contents":[{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":"#include "},{"Add":""},{"Add":"#include \"common.h\""},{"Add":"#include \"types.h\""},{"Add":"#include \"repository.h\""},{"Add":"#include \"db.h\""},{"Add":""},{"Add":"static void"},{"Add":"formatdbpath(char *dst, const char *repodir)"},{"Add":"{"},{"Add":"\tchar *p;"},{"Add":""},{"Add":"\tp = stpncpy(dst, repodir, PATH_MAX);"},{"Add":"\t*p++ = '/';"},{"Add":"\tp = stpncpy(p, DOTPIJUL, 6);"},{"Add":"\t*p++ = '/';"},{"Add":"\tp = stpncpy(p, \"pristine/db\", 11);"},{"Add":"}"},{"Add":""},{"Add":"int"},{"Add":"cmd_pristine(int argc, char *argv, struct repository *repo)"},{"Add":"{"},{"Add":"\tchar dbpath[4096] = { 0 };"},{"Add":""},{"Add":"\t(void)argc;"},{"Add":"\t(void)argv;"},{"Add":"\t"},{"Add":"\tformatdbpath(dbpath, repo->path);"},{"Add":""},{"Add":"\tdbrun(dbpath);"},{"Add":""},{"Add":"\treturn 0;"},{"Add":"}"}]}},{"Replacement":{"inode":{"change":3,"pos":30},"path":"ani.c","line":18,"ins":{"up_context":[{"change":3,"pos":129}],"down_context":[{"change":3,"pos":173}],"flag":"BLOCK","start":3125,"end":3289,"inode":{"change":3,"pos":30}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":129},"to":{"change":3,"start":129,"end":170},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":170},"to":{"change":3,"start":3154,"end":3211},"introduced_by":3}],"inode":{"change":3,"pos":30}},"ins_contents":[{"Add":"\t\" init Initialize empty repository\\n\""},{"Add":"\t\" change Show information about a particular change\\n\""},{"Add":"\t\" pristine Show information about the repository database\\n\";"}],"del_contents":[{"Del":"\t\" init Initialize empty repository\\n\"\n"},{"Del":"\t\" change Show information about a particular change\\n\";\n"}]}},{"Edit":{"inode":{"change":3,"pos":30},"path":"ani.c","line":32,"atom":{"NewVertex":{"up_context":[{"change":3,"pos":1921}],"down_context":[{"change":13,"pos":1297}],"flag":"BLOCK","start":3290,"end":3337,"inode":{"change":3,"pos":30}}},"contents":[{"Add":"\t{ \"pristine\", cmd_pristine, NEED_WORK_TREE },"}]}}],"owner":"laumann","repo":"ani","token":"K0ZqImtq1+Yc/6ipR8TLZYz8Cm8lb3mOHj6H1i6IRc8=","login":null}

…

Dependencies

Change contents