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  */
16 
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;
37 
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
44 
45 	/* SHA1 of corresponding blob in repository. */
46 	uint8_t blob_sha1[SHA1_DIGEST_LENGTH];
47 
48 	/* SHA1 of corresponding base commit in repository. */
49 	uint8_t commit_sha1[SHA1_DIGEST_LENGTH];
50 
51 	uint32_t flags;
52 
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 
59 	/* More data could be here if F_EXTENDED is set; To be determined... */
60 };
61 
62 /* "Stages" of a file afflicted by a 3-way merge conflict. */
63 #define GOT_FILEIDX_STAGE_MERGED	0
64 #define GOT_FILEIDX_STAGE_ANCESTOR	1
65 #define GOT_FILEIDX_STAGE_OURS		2
66 #define GOT_FILEIDX_STAGE_THEIRS	3
67 
68 struct got_fileindex;
69 
70 RB_HEAD(got_fileindex_tree, got_fileindex_entry);
71 
72 static inline int
73 got_fileindex_cmp(const struct got_fileindex_entry *e1,
74     const struct got_fileindex_entry *e2)
75 {
76 	return got_path_cmp(e1->path, e2->path);
77 }
78 
79 RB_PROTOTYPE(got_fileindex_tree, got_fileindex_entry, entry, got_fileindex_cmp);
80 
81 /* On-disk file index header structure. */
82 struct got_fileindex_hdr {
83 	uint32_t signature;	/* big-endian */
84 #define GOT_FILE_INDEX_SIGNATURE	0x676f7449 /* 'g', 'o', 't', 'I' */
85 	uint32_t version;	/* big-endian */
86 #define GOT_FILE_INDEX_VERSION	1
87 	uint32_t nentries;	/* big-endian */
88 	/* list of concatenated fileindex entries */
89 	uint8_t sha1[SHA1_DIGEST_LENGTH]; /* checksum of above on-disk data */
90 };
91 
92 const struct got_error *got_fileindex_entry_update(struct got_fileindex_entry *,
93     const char *, uint8_t *, uint8_t *, int);
94 const struct got_error *got_fileindex_entry_alloc(struct got_fileindex_entry **,
95     const char *, const char *, uint8_t *, uint8_t *);
96 void got_fileindex_entry_free(struct got_fileindex_entry *);
97 struct got_fileindex *got_fileindex_alloc(void);
98 void got_fileindex_free(struct got_fileindex *);
99 const struct got_error *got_fileindex_write(struct got_fileindex *, FILE *);
100 const struct got_error *got_fileindex_entry_add(struct got_fileindex *,
101     struct got_fileindex_entry *);
102 void got_fileindex_entry_remove(struct got_fileindex *,
103     struct got_fileindex_entry *);
104 struct got_fileindex_entry *got_fileindex_entry_get(struct got_fileindex *,
105     const char *);
106 const struct got_error *got_fileindex_read(struct got_fileindex *, FILE *);
107 typedef const struct got_error *(*got_fileindex_cb)(void *,
108     struct got_fileindex_entry *);
109 const struct got_error *got_fileindex_for_each_entry_safe(
110     struct got_fileindex *, got_fileindex_cb cb, void *);
111 
112 typedef const struct got_error *(*got_fileindex_diff_tree_old_new_cb)(void *,
113     struct got_fileindex_entry *, struct got_tree_entry *, const char *);
114 typedef const struct got_error *(*got_fileindex_diff_tree_old_cb)(void *,
115     struct got_fileindex_entry *, const char *);
116 typedef const struct got_error *(*got_fileindex_diff_tree_new_cb)(void *,
117     struct got_tree_entry *, const char *);
118 struct got_fileindex_diff_tree_cb {
119 	got_fileindex_diff_tree_old_new_cb diff_old_new;
120 	got_fileindex_diff_tree_old_cb diff_old;
121 	got_fileindex_diff_tree_new_cb diff_new;
122 };
123 const struct got_error *got_fileindex_diff_tree(struct got_fileindex *,
124     struct got_tree_object *, const char *, const char *,
125     struct got_repository *, struct got_fileindex_diff_tree_cb *, void *);
126 
127 typedef const struct got_error *(*got_fileindex_diff_dir_old_new_cb)(void *,
128     struct got_fileindex_entry *, struct dirent *, const char *);
129 typedef const struct got_error *(*got_fileindex_diff_dir_old_cb)(void *,
130     struct got_fileindex_entry *, const char *);
131 typedef const struct got_error *(*got_fileindex_diff_dir_new_cb)(void *,
132     struct dirent *, const char *);
133 struct got_fileindex_diff_dir_cb {
134 	got_fileindex_diff_dir_old_new_cb diff_old_new;
135 	got_fileindex_diff_dir_old_cb diff_old;
136 	got_fileindex_diff_dir_new_cb diff_new;
137 };
138 const struct got_error *got_fileindex_diff_dir(struct got_fileindex *, DIR *,
139     const char *, const char *, struct got_repository *,
140     struct got_fileindex_diff_dir_cb *, void *);
141 
142 int got_fileindex_entry_has_blob(struct got_fileindex_entry *);
143 int got_fileindex_entry_has_commit(struct got_fileindex_entry *);
144 int got_fileindex_entry_has_file_on_disk(struct got_fileindex_entry *);
145 
146 void got_fileindex_entry_mark_deleted_from_disk(struct got_fileindex_entry *);