Blob


1 /*
2 * Copyright (c) 2018, 2019 Stefan Sperling <stsp@openbsd.org>
3 *
4 * Permission to use, copy, modify, and distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
7 *
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 */
17 /*
18 * State information for a tracked file in a work tree.
19 * When written to disk, multi-byte fields are written in big-endian.
20 * Some fields are based on results from stat(2). These are only used in
21 * order to detect modifications made to on-disk files, they are never
22 * applied back to the filesystem.
23 */
24 struct got_fileindex_entry {
25 RB_ENTRY(got_fileindex_entry) entry;
26 uint64_t ctime_sec;
27 uint64_t ctime_nsec;
28 uint64_t mtime_sec;
29 uint64_t mtime_nsec;
30 uint32_t uid;
31 uint32_t gid;
32 /*
33 * On-disk size is truncated to the lower 32 bits.
34 * The value is only used to check for modifications anyway.
35 */
36 uint32_t size;
38 uint16_t mode;
39 #define GOT_FILEIDX_MODE_FILE_TYPE 0x000f
40 #define GOT_FILEIDX_MODE_REGULAR_FILE 1
41 #define GOT_FILEIDX_MODE_SYMLINK 2
42 #define GOT_FILEIDX_MODE_PERMS 0xff10
43 #define GOT_FILEIDX_MODE_PERMS_SHIFT 4
45 /* SHA1 of corresponding blob in repository. */
46 uint8_t blob_sha1[SHA1_DIGEST_LENGTH];
48 /* SHA1 of corresponding base commit in repository. */
49 uint8_t commit_sha1[SHA1_DIGEST_LENGTH];
51 uint32_t flags;
53 /*
54 * UNIX-style path, relative to work tree root.
55 * Variable length, and NUL-padded to a multiple of 8 on disk.
56 */
57 char *path;
58 size_t path_len; /* strlen(path) -- kept in memory only! */
59 };
61 struct got_fileindex;
63 RB_HEAD(got_fileindex_tree, got_fileindex_entry);
65 static inline int
66 got_fileindex_cmp(const struct got_fileindex_entry *e1,
67 const struct got_fileindex_entry *e2)
68 {
69 return got_path_cmp(e1->path, e2->path, e1->path_len, e2->path_len);
70 }
72 RB_PROTOTYPE(got_fileindex_tree, got_fileindex_entry, entry, got_fileindex_cmp);
74 /* On-disk file index header structure. */
75 struct got_fileindex_hdr {
76 uint32_t signature; /* big-endian */
77 #define GOT_FILE_INDEX_SIGNATURE 0x676f7449 /* 'g', 'o', 't', 'I' */
78 uint32_t version; /* big-endian */
79 #define GOT_FILE_INDEX_VERSION 1
80 uint32_t nentries; /* big-endian */
81 /* list of concatenated fileindex entries */
82 uint8_t sha1[SHA1_DIGEST_LENGTH]; /* checksum of above on-disk data */
83 };
85 uint16_t got_fileindex_perms_from_st(struct stat *);
86 mode_t got_fileindex_perms_to_st(struct got_fileindex_entry *);
88 const struct got_error *got_fileindex_entry_update(struct got_fileindex_entry *,
89 const char *, uint8_t *, uint8_t *, int);
90 const struct got_error *got_fileindex_entry_alloc(struct got_fileindex_entry **,
91 const char *, const char *, uint8_t *, uint8_t *);
92 void got_fileindex_entry_free(struct got_fileindex_entry *);
93 struct got_fileindex *got_fileindex_alloc(void);
94 void got_fileindex_free(struct got_fileindex *);
95 const struct got_error *got_fileindex_write(struct got_fileindex *, FILE *);
96 const struct got_error *got_fileindex_entry_add(struct got_fileindex *,
97 struct got_fileindex_entry *);
98 void got_fileindex_entry_remove(struct got_fileindex *,
99 struct got_fileindex_entry *);
100 struct got_fileindex_entry *got_fileindex_entry_get(struct got_fileindex *,
101 const char *, size_t);
102 const struct got_error *got_fileindex_read(struct got_fileindex *, FILE *);
103 typedef const struct got_error *(*got_fileindex_cb)(void *,
104 struct got_fileindex_entry *);
105 const struct got_error *got_fileindex_for_each_entry_safe(
106 struct got_fileindex *, got_fileindex_cb cb, void *);
108 typedef const struct got_error *(*got_fileindex_diff_tree_old_new_cb)(void *,
109 struct got_fileindex_entry *, struct got_tree_entry *, const char *);
110 typedef const struct got_error *(*got_fileindex_diff_tree_old_cb)(void *,
111 struct got_fileindex_entry *, const char *);
112 typedef const struct got_error *(*got_fileindex_diff_tree_new_cb)(void *,
113 struct got_tree_entry *, const char *);
114 struct got_fileindex_diff_tree_cb {
115 got_fileindex_diff_tree_old_new_cb diff_old_new;
116 got_fileindex_diff_tree_old_cb diff_old;
117 got_fileindex_diff_tree_new_cb diff_new;
118 };
119 const struct got_error *got_fileindex_diff_tree(struct got_fileindex *,
120 struct got_tree_object *, const char *, const char *,
121 struct got_repository *, struct got_fileindex_diff_tree_cb *, void *);
123 typedef const struct got_error *(*got_fileindex_diff_dir_old_new_cb)(void *,
124 struct got_fileindex_entry *, struct dirent *, const char *);
125 typedef const struct got_error *(*got_fileindex_diff_dir_old_cb)(void *,
126 struct got_fileindex_entry *, const char *);
127 typedef const struct got_error *(*got_fileindex_diff_dir_new_cb)(void *,
128 struct dirent *, const char *);
129 struct got_fileindex_diff_dir_cb {
130 got_fileindex_diff_dir_old_new_cb diff_old_new;
131 got_fileindex_diff_dir_old_cb diff_old;
132 got_fileindex_diff_dir_new_cb diff_new;
133 };
134 const struct got_error *got_fileindex_diff_dir(struct got_fileindex *, DIR *,
135 const char *, const char *, struct got_repository *,
136 struct got_fileindex_diff_dir_cb *, void *);
138 int got_fileindex_entry_has_blob(struct got_fileindex_entry *);
139 int got_fileindex_entry_has_commit(struct got_fileindex_entry *);
140 int got_fileindex_entry_has_file_on_disk(struct got_fileindex_entry *);
142 void got_fileindex_entry_mark_deleted_from_disk(struct got_fileindex_entry *);