2 5d56da81 2019-01-13 stsp * Copyright (c) 2018, 2019 Stefan Sperling <stsp@openbsd.org>
4 718b3ab0 2018-03-17 stsp * Permission to use, copy, modify, and distribute this software for any
5 718b3ab0 2018-03-17 stsp * purpose with or without fee is hereby granted, provided that the above
6 718b3ab0 2018-03-17 stsp * copyright notice and this permission notice appear in all copies.
8 718b3ab0 2018-03-17 stsp * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 718b3ab0 2018-03-17 stsp * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 718b3ab0 2018-03-17 stsp * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 718b3ab0 2018-03-17 stsp * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 718b3ab0 2018-03-17 stsp * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 718b3ab0 2018-03-17 stsp * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 718b3ab0 2018-03-17 stsp * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18 718b3ab0 2018-03-17 stsp * State information for a tracked file in a work tree.
19 718b3ab0 2018-03-17 stsp * When written to disk, multi-byte fields are written in big-endian.
20 718b3ab0 2018-03-17 stsp * Some fields are based on results from stat(2). These are only used in
21 718b3ab0 2018-03-17 stsp * order to detect modifications made to on-disk files, they are never
22 718b3ab0 2018-03-17 stsp * applied back to the filesystem.
24 718b3ab0 2018-03-17 stsp struct got_fileindex_entry {
25 133d2798 2019-01-08 stsp RB_ENTRY(got_fileindex_entry) entry;
26 718b3ab0 2018-03-17 stsp uint64_t ctime_sec;
27 718b3ab0 2018-03-17 stsp uint64_t ctime_nsec;
28 718b3ab0 2018-03-17 stsp uint64_t mtime_sec;
29 718b3ab0 2018-03-17 stsp uint64_t mtime_nsec;
30 718b3ab0 2018-03-17 stsp uint32_t uid;
31 718b3ab0 2018-03-17 stsp uint32_t gid;
33 718b3ab0 2018-03-17 stsp * On-disk size is truncated to the lower 32 bits.
34 718b3ab0 2018-03-17 stsp * The value is only used to check for modifications anyway.
36 718b3ab0 2018-03-17 stsp uint32_t size;
38 718b3ab0 2018-03-17 stsp uint16_t mode;
39 a7f9d64d 2019-01-13 stsp #define GOT_FILEIDX_MODE_FILE_TYPE 0x000f
40 a7f9d64d 2019-01-13 stsp #define GOT_FILEIDX_MODE_REGULAR_FILE 1
41 a7f9d64d 2019-01-13 stsp #define GOT_FILEIDX_MODE_SYMLINK 2
42 2e1fa222 2020-07-23 stsp #define GOT_FILEIDX_MODE_BAD_SYMLINK 3
43 ecd6d584 2020-06-27 stsp #define GOT_FILEIDX_MODE_PERMS 0xfff0
44 a7f9d64d 2019-01-13 stsp #define GOT_FILEIDX_MODE_PERMS_SHIFT 4
46 718b3ab0 2018-03-17 stsp /* SHA1 of corresponding blob in repository. */
47 718b3ab0 2018-03-17 stsp uint8_t blob_sha1[SHA1_DIGEST_LENGTH];
49 fc76cabb 2018-12-25 stsp /* SHA1 of corresponding base commit in repository. */
50 fc76cabb 2018-12-25 stsp uint8_t commit_sha1[SHA1_DIGEST_LENGTH];
52 718b3ab0 2018-03-17 stsp uint32_t flags;
55 718b3ab0 2018-03-17 stsp * UNIX-style path, relative to work tree root.
56 718b3ab0 2018-03-17 stsp * Variable length, and NUL-padded to a multiple of 8 on disk.
61 df335242 2019-08-03 stsp * (since GOT_FILE_INDEX_VERSION 2)
62 df335242 2019-08-03 stsp * SHA1 of staged blob in repository if stage equals either
63 df335242 2019-08-03 stsp * GOT_FILEIDX_STAGE_MODIFY or GOT_FILEIDX_STAGE_ADD.
64 df335242 2019-08-03 stsp * Otherwise, this field is not written to disk.
66 df335242 2019-08-03 stsp uint8_t staged_blob_sha1[SHA1_DIGEST_LENGTH];
69 83718700 2019-08-03 stsp /* Modifications explicitly staged for commit. */
70 83718700 2019-08-03 stsp #define GOT_FILEIDX_STAGE_NONE 0
71 83718700 2019-08-03 stsp #define GOT_FILEIDX_STAGE_MODIFY 1
72 83718700 2019-08-03 stsp #define GOT_FILEIDX_STAGE_ADD 2
73 83718700 2019-08-03 stsp #define GOT_FILEIDX_STAGE_DELETE 3
75 133d2798 2019-01-08 stsp struct got_fileindex;
77 7a9df742 2019-01-08 stsp RB_HEAD(got_fileindex_tree, got_fileindex_entry);
79 4d555405 2019-08-03 stsp size_t got_fileindex_entry_path_len(const struct got_fileindex_entry *);
81 7a9df742 2019-01-08 stsp static inline int
82 7a9df742 2019-01-08 stsp got_fileindex_cmp(const struct got_fileindex_entry *e1,
83 7a9df742 2019-01-08 stsp const struct got_fileindex_entry *e2)
85 4d555405 2019-08-03 stsp return got_path_cmp(e1->path, e2->path,
86 4d555405 2019-08-03 stsp got_fileindex_entry_path_len(e1),
87 4d555405 2019-08-03 stsp got_fileindex_entry_path_len(e2));
90 7a9df742 2019-01-08 stsp RB_PROTOTYPE(got_fileindex_tree, got_fileindex_entry, entry, got_fileindex_cmp);
92 718b3ab0 2018-03-17 stsp /* On-disk file index header structure. */
93 718b3ab0 2018-03-17 stsp struct got_fileindex_hdr {
94 718b3ab0 2018-03-17 stsp uint32_t signature; /* big-endian */
95 718b3ab0 2018-03-17 stsp #define GOT_FILE_INDEX_SIGNATURE 0x676f7449 /* 'g', 'o', 't', 'I' */
96 718b3ab0 2018-03-17 stsp uint32_t version; /* big-endian */
97 df335242 2019-08-03 stsp #define GOT_FILE_INDEX_VERSION 2
98 718b3ab0 2018-03-17 stsp uint32_t nentries; /* big-endian */
99 718b3ab0 2018-03-17 stsp /* list of concatenated fileindex entries */
100 718b3ab0 2018-03-17 stsp uint8_t sha1[SHA1_DIGEST_LENGTH]; /* checksum of above on-disk data */
103 26a7fe28 2019-07-27 stsp uint16_t got_fileindex_perms_from_st(struct stat *);
104 26a7fe28 2019-07-27 stsp mode_t got_fileindex_perms_to_st(struct got_fileindex_entry *);
106 51514078 2018-12-25 stsp const struct got_error *got_fileindex_entry_update(struct got_fileindex_entry *,
107 02c07007 2019-02-10 stsp const char *, uint8_t *, uint8_t *, int);
108 7426bbfd 2018-12-24 stsp const struct got_error *got_fileindex_entry_alloc(struct got_fileindex_entry **,
109 3969253a 2020-03-07 stsp const char *);
110 7426bbfd 2018-12-24 stsp void got_fileindex_entry_free(struct got_fileindex_entry *);
112 133d2798 2019-01-08 stsp struct got_fileindex *got_fileindex_alloc(void);
113 7426bbfd 2018-12-24 stsp void got_fileindex_free(struct got_fileindex *);
114 718b3ab0 2018-03-17 stsp const struct got_error *got_fileindex_write(struct got_fileindex *, FILE *);
115 718b3ab0 2018-03-17 stsp const struct got_error *got_fileindex_entry_add(struct got_fileindex *,
116 718b3ab0 2018-03-17 stsp struct got_fileindex_entry *);
117 133d2798 2019-01-08 stsp void got_fileindex_entry_remove(struct got_fileindex *,
118 512f0d0e 2019-01-02 stsp struct got_fileindex_entry *);
119 51514078 2018-12-25 stsp struct got_fileindex_entry *got_fileindex_entry_get(struct got_fileindex *,
120 d6c87207 2019-08-02 stsp const char *, size_t);
121 52a74475 2018-12-24 stsp const struct got_error *got_fileindex_read(struct got_fileindex *, FILE *);
122 b504a804 2019-01-08 stsp typedef const struct got_error *(*got_fileindex_cb)(void *,
123 b504a804 2019-01-08 stsp struct got_fileindex_entry *);
124 e1ed7f77 2019-01-06 stsp const struct got_error *got_fileindex_for_each_entry_safe(
125 b504a804 2019-01-08 stsp struct got_fileindex *, got_fileindex_cb cb, void *);
127 f44ffd20 2019-02-04 stsp typedef const struct got_error *(*got_fileindex_diff_tree_old_new_cb)(void *,
128 8da9e5f4 2019-01-12 stsp struct got_fileindex_entry *, struct got_tree_entry *, const char *);
129 f44ffd20 2019-02-04 stsp typedef const struct got_error *(*got_fileindex_diff_tree_old_cb)(void *,
130 8da9e5f4 2019-01-12 stsp struct got_fileindex_entry *, const char *);
131 f44ffd20 2019-02-04 stsp typedef const struct got_error *(*got_fileindex_diff_tree_new_cb)(void *,
132 8da9e5f4 2019-01-12 stsp struct got_tree_entry *, const char *);
133 f44ffd20 2019-02-04 stsp struct got_fileindex_diff_tree_cb {
134 f44ffd20 2019-02-04 stsp got_fileindex_diff_tree_old_new_cb diff_old_new;
135 f44ffd20 2019-02-04 stsp got_fileindex_diff_tree_old_cb diff_old;
136 f44ffd20 2019-02-04 stsp got_fileindex_diff_tree_new_cb diff_new;
138 8da9e5f4 2019-01-12 stsp const struct got_error *got_fileindex_diff_tree(struct got_fileindex *,
139 c4cdcb68 2019-04-03 stsp struct got_tree_object *, const char *, const char *,
140 c4cdcb68 2019-04-03 stsp struct got_repository *, struct got_fileindex_diff_tree_cb *, void *);
142 d1f6d47b 2019-02-04 stsp typedef const struct got_error *(*got_fileindex_diff_dir_old_new_cb)(void *,
143 7f91a133 2019-12-13 stsp struct got_fileindex_entry *, struct dirent *, const char *, int);
144 d1f6d47b 2019-02-04 stsp typedef const struct got_error *(*got_fileindex_diff_dir_old_cb)(void *,
145 d1f6d47b 2019-02-04 stsp struct got_fileindex_entry *, const char *);
146 d1f6d47b 2019-02-04 stsp typedef const struct got_error *(*got_fileindex_diff_dir_new_cb)(void *,
147 7f91a133 2019-12-13 stsp struct dirent *, const char *, int);
148 3143d852 2020-06-25 stsp typedef const struct got_error *(*got_fileindex_diff_dir_traverse)(void *,
149 3143d852 2020-06-25 stsp const char *, int);
150 d1f6d47b 2019-02-04 stsp struct got_fileindex_diff_dir_cb {
151 d1f6d47b 2019-02-04 stsp got_fileindex_diff_dir_old_new_cb diff_old_new;
152 d1f6d47b 2019-02-04 stsp got_fileindex_diff_dir_old_cb diff_old;
153 d1f6d47b 2019-02-04 stsp got_fileindex_diff_dir_new_cb diff_new;
154 3143d852 2020-06-25 stsp got_fileindex_diff_dir_traverse diff_traverse;
156 6fc93f37 2019-12-13 stsp const struct got_error *got_fileindex_diff_dir(struct got_fileindex *, int,
157 927df6b7 2019-02-10 stsp const char *, const char *, struct got_repository *,
158 927df6b7 2019-02-10 stsp struct got_fileindex_diff_dir_cb *, void *);
160 d00136be 2019-03-26 stsp int got_fileindex_entry_has_blob(struct got_fileindex_entry *);
161 d00136be 2019-03-26 stsp int got_fileindex_entry_has_commit(struct got_fileindex_entry *);
162 2ec1f75b 2019-03-26 stsp int got_fileindex_entry_has_file_on_disk(struct got_fileindex_entry *);
163 0cb83759 2019-08-03 stsp uint32_t got_fileindex_entry_stage_get(const struct got_fileindex_entry *);
164 0cb83759 2019-08-03 stsp void got_fileindex_entry_stage_set(struct got_fileindex_entry *ie, uint32_t);
165 2e1fa222 2020-07-23 stsp int got_fileindex_entry_filetype_get(struct got_fileindex_entry *);
166 2e1fa222 2020-07-23 stsp const struct got_error *got_fileindex_entry_filetype_set(
167 2e1fa222 2020-07-23 stsp struct got_fileindex_entry *, int);
169 2ec1f75b 2019-03-26 stsp void got_fileindex_entry_mark_deleted_from_disk(struct got_fileindex_entry *);
