]>
Commit | Line | Data |
---|---|---|
e83c5163 LT |
1 | #ifndef CACHE_H |
2 | #define CACHE_H | |
3 | ||
4050c0df | 4 | #include "git-compat-util.h" |
e83c5163 | 5 | |
cef661fc | 6 | #include SHA1_HEADER |
e83c5163 LT |
7 | #include <zlib.h> |
8 | ||
9da3acfb ET |
9 | #if ZLIB_VERNUM < 0x1200 |
10 | #define deflateBound(c,s) ((s) + (((s) + 7) >> 3) + (((s) + 63) >> 6) + 11) | |
11 | #endif | |
12 | ||
962554c6 | 13 | #if defined(DT_UNKNOWN) && !defined(NO_D_TYPE_IN_DIRENT) |
b6829693 ET |
14 | #define DTYPE(de) ((de)->d_type) |
15 | #else | |
0bdd79af JH |
16 | #undef DT_UNKNOWN |
17 | #undef DT_DIR | |
18 | #undef DT_REG | |
19 | #undef DT_LNK | |
b6829693 ET |
20 | #define DT_UNKNOWN 0 |
21 | #define DT_DIR 1 | |
22 | #define DT_REG 2 | |
a15c1c60 | 23 | #define DT_LNK 3 |
b6829693 ET |
24 | #define DTYPE(de) DT_UNKNOWN |
25 | #endif | |
26 | ||
2386d658 LT |
27 | /* |
28 | * Intensive research over the course of many years has shown that | |
29 | * port 9418 is totally unused by anything else. Or | |
30 | * | |
31 | * Your search - "port 9418" - did not match any documents. | |
32 | * | |
33 | * as www.google.com puts it. | |
ba8a4970 LT |
34 | * |
35 | * This port has been properly assigned for git use by IANA: | |
36 | * git (Assigned-9418) [I06-050728-0001]. | |
37 | * | |
38 | * git 9418/tcp git pack transfer service | |
39 | * git 9418/udp git pack transfer service | |
40 | * | |
41 | * with Linus Torvalds <torvalds@osdl.org> as the point of | |
42 | * contact. September 2005. | |
43 | * | |
44 | * See http://www.iana.org/assignments/port-numbers | |
2386d658 LT |
45 | */ |
46 | #define DEFAULT_GIT_PORT 9418 | |
47 | ||
e83c5163 LT |
48 | /* |
49 | * Basic data structures for the directory cache | |
e83c5163 LT |
50 | */ |
51 | ||
52 | #define CACHE_SIGNATURE 0x44495243 /* "DIRC" */ | |
53 | struct cache_header { | |
ccc4feb5 LT |
54 | unsigned int hdr_signature; |
55 | unsigned int hdr_version; | |
56 | unsigned int hdr_entries; | |
e83c5163 LT |
57 | }; |
58 | ||
59 | /* | |
60 | * The "cache_time" is just the low 32 bits of the | |
61 | * time. It doesn't matter if it overflows - we only | |
62 | * check it for equality in the 32 bits we save. | |
63 | */ | |
64 | struct cache_time { | |
65 | unsigned int sec; | |
66 | unsigned int nsec; | |
67 | }; | |
68 | ||
69 | /* | |
70 | * dev/ino/uid/gid/size are also just tracked to the low 32 bits | |
71 | * Again - this is just a (very strong in practice) heuristic that | |
72 | * the inode hasn't changed. | |
ccc4feb5 LT |
73 | * |
74 | * We save the fields in big-endian order to allow using the | |
75 | * index file over NFS transparently. | |
e83c5163 LT |
76 | */ |
77 | struct cache_entry { | |
ccc4feb5 LT |
78 | struct cache_time ce_ctime; |
79 | struct cache_time ce_mtime; | |
80 | unsigned int ce_dev; | |
81 | unsigned int ce_ino; | |
82 | unsigned int ce_mode; | |
83 | unsigned int ce_uid; | |
84 | unsigned int ce_gid; | |
85 | unsigned int ce_size; | |
e83c5163 | 86 | unsigned char sha1[20]; |
f5cabd13 | 87 | unsigned short ce_flags; |
8f1d2e6f | 88 | char name[FLEX_ARRAY]; /* more */ |
e83c5163 LT |
89 | }; |
90 | ||
95fd5bf8 LT |
91 | #define CE_NAMEMASK (0x0fff) |
92 | #define CE_STAGEMASK (0x3000) | |
220a0b52 | 93 | #define CE_UPDATE (0x4000) |
5f73076c | 94 | #define CE_VALID (0x8000) |
aee46198 | 95 | #define CE_STAGESHIFT 12 |
95fd5bf8 | 96 | |
aee46198 JH |
97 | #define create_ce_flags(len, stage) htons((len) | ((stage) << CE_STAGESHIFT)) |
98 | #define ce_namelen(ce) (CE_NAMEMASK & ntohs((ce)->ce_flags)) | |
99 | #define ce_size(ce) cache_entry_size(ce_namelen(ce)) | |
100 | #define ce_stage(ce) ((CE_STAGEMASK & ntohs((ce)->ce_flags)) >> CE_STAGESHIFT) | |
101 | ||
e4479470 | 102 | #define ce_permissions(mode) (((mode) & 0100) ? 0755 : 0644) |
8ae0a8c5 KS |
103 | static inline unsigned int create_ce_mode(unsigned int mode) |
104 | { | |
8ae0a8c5 KS |
105 | if (S_ISLNK(mode)) |
106 | return htonl(S_IFLNK); | |
db823d4a | 107 | return htonl(S_IFREG | ce_permissions(mode)); |
8ae0a8c5 | 108 | } |
1b0c7174 JH |
109 | #define canon_mode(mode) \ |
110 | (S_ISREG(mode) ? (S_IFREG | ce_permissions(mode)) : \ | |
111 | S_ISLNK(mode) ? S_IFLNK : S_IFDIR) | |
e4479470 | 112 | |
aee46198 | 113 | #define cache_entry_size(len) ((offsetof(struct cache_entry,name) + (len) + 8) & ~7) |
f5cabd13 | 114 | |
88355048 PB |
115 | extern struct cache_entry **active_cache; |
116 | extern unsigned int active_nr, active_alloc, active_cache_changed; | |
bad68ec9 | 117 | extern struct cache_tree *active_cache_tree; |
e83c5163 | 118 | |
8ac069ac JH |
119 | #define GIT_DIR_ENVIRONMENT "GIT_DIR" |
120 | #define DEFAULT_GIT_DIR_ENVIRONMENT ".git" | |
d19938ab | 121 | #define DB_ENVIRONMENT "GIT_OBJECT_DIRECTORY" |
bb233d69 | 122 | #define INDEX_ENVIRONMENT "GIT_INDEX_FILE" |
5da5c8f4 | 123 | #define GRAFT_ENVIRONMENT "GIT_GRAFT_FILE" |
bb233d69 | 124 | |
5da1606d | 125 | extern char *get_git_dir(void); |
8ac069ac | 126 | extern char *get_object_directory(void); |
95fc7512 | 127 | extern char *get_refs_directory(void); |
8ac069ac | 128 | extern char *get_index_file(void); |
5da5c8f4 | 129 | extern char *get_graft_file(void); |
8ac069ac JH |
130 | |
131 | #define ALTERNATE_DB_ENVIRONMENT "GIT_ALTERNATE_OBJECT_DIRECTORIES" | |
bb233d69 | 132 | |
6b5ee137 | 133 | extern const char **get_pathspec(const char *prefix, const char **pathspec); |
4ca06608 | 134 | extern const char *setup_git_directory_gently(int *); |
d288a700 | 135 | extern const char *setup_git_directory(void); |
6b5ee137 | 136 | extern const char *prefix_path(const char *prefix, int len, const char *path); |
4ca06608 | 137 | extern const char *prefix_filename(const char *prefix, int len, const char *path); |
e23d0b4a | 138 | extern void verify_filename(const char *prefix, const char *name); |
ea92f41f | 139 | extern void verify_non_filename(const char *prefix, const char *name); |
d288a700 | 140 | |
e83c5163 LT |
141 | #define alloc_nr(x) (((x)+16)*3/2) |
142 | ||
734aab75 | 143 | /* Initialize and use the cache information */ |
e83c5163 | 144 | extern int read_cache(void); |
197ee8c9 | 145 | extern int write_cache(int newfd, struct cache_entry **cache, int entries); |
8dcf39c4 | 146 | extern int verify_path(const char *path); |
eb38c22f | 147 | extern int cache_name_pos(const char *name, int namelen); |
192268c1 JH |
148 | #define ADD_CACHE_OK_TO_ADD 1 /* Ok to add */ |
149 | #define ADD_CACHE_OK_TO_REPLACE 2 /* Ok to replace file/directory */ | |
b155725d | 150 | #define ADD_CACHE_SKIP_DFCHECK 4 /* Ok to skip DF conflict checks */ |
192268c1 | 151 | extern int add_cache_entry(struct cache_entry *ce, int option); |
dbbce55b | 152 | extern int remove_cache_entry_at(int pos); |
6b5ee137 | 153 | extern int remove_file_from_cache(const char *path); |
dbbce55b | 154 | extern int ce_same_name(struct cache_entry *a, struct cache_entry *b); |
5f73076c JH |
155 | extern int ce_match_stat(struct cache_entry *ce, struct stat *st, int); |
156 | extern int ce_modified(struct cache_entry *ce, struct stat *st, int); | |
c0fd1f51 | 157 | extern int ce_path_match(const struct cache_entry *ce, const char **pathspec); |
7672db20 | 158 | extern int index_fd(unsigned char *sha1, int fd, struct stat *st, int write_object, const char *type); |
e7332f96 | 159 | extern int read_pipe(int fd, char** return_buf, unsigned long* return_size); |
024510c8 | 160 | extern int index_pipe(unsigned char *sha1, int fd, const char *type, int write_object); |
ec1fcc16 | 161 | extern int index_path(unsigned char *sha1, const char *path, struct stat *st, int write_object); |
415e96c8 JH |
162 | extern void fill_stat_cache_info(struct cache_entry *ce, struct stat *st); |
163 | ||
405e5b2f LT |
164 | #define REFRESH_REALLY 0x0001 /* ignore_valid */ |
165 | #define REFRESH_UNMERGED 0x0002 /* allow unmerged */ | |
166 | #define REFRESH_QUIET 0x0004 /* be quiet about it */ | |
167 | #define REFRESH_IGNORE_MISSING 0x0008 /* ignore non-existent */ | |
168 | extern int refresh_cache(unsigned int flags); | |
169 | ||
021b6e45 JH |
170 | struct lock_file { |
171 | struct lock_file *next; | |
172 | char filename[PATH_MAX]; | |
415e96c8 | 173 | }; |
021b6e45 JH |
174 | extern int hold_lock_file_for_update(struct lock_file *, const char *path); |
175 | extern int commit_lock_file(struct lock_file *); | |
176 | extern void rollback_lock_file(struct lock_file *); | |
734aab75 | 177 | |
2ae1c53b | 178 | /* Environment bits from configuration mechanism */ |
17712991 | 179 | extern int trust_executable_bit; |
5f73076c | 180 | extern int assume_unchanged; |
9f0bb90d | 181 | extern int prefer_symlink_refs; |
6de08ae6 | 182 | extern int log_all_ref_updates; |
2f8acdb3 | 183 | extern int warn_ambiguous_refs; |
457f06d6 | 184 | extern int shared_repository; |
2ae1c53b | 185 | extern const char *apply_default_whitespace; |
17712991 | 186 | |
ab9cb76f JH |
187 | #define GIT_REPO_VERSION 0 |
188 | extern int repository_format_version; | |
189 | extern int check_repository_format(void); | |
190 | ||
734aab75 LT |
191 | #define MTIME_CHANGED 0x0001 |
192 | #define CTIME_CHANGED 0x0002 | |
193 | #define OWNER_CHANGED 0x0004 | |
194 | #define MODE_CHANGED 0x0008 | |
195 | #define INODE_CHANGED 0x0010 | |
196 | #define DATA_CHANGED 0x0020 | |
8ae0a8c5 | 197 | #define TYPE_CHANGED 0x0040 |
e83c5163 LT |
198 | |
199 | /* Return a statically allocated filename matching the sha1 signature */ | |
4ec99bf0 TS |
200 | extern char *mkpath(const char *fmt, ...) __attribute__((format (printf, 1, 2))); |
201 | extern char *git_path(const char *fmt, ...) __attribute__((format (printf, 1, 2))); | |
73134b6d | 202 | extern char *sha1_file_name(const unsigned char *sha1); |
bf592c50 DB |
203 | extern char *sha1_pack_name(const unsigned char *sha1); |
204 | extern char *sha1_pack_index_name(const unsigned char *sha1); | |
013f276e | 205 | extern const char *find_unique_abbrev(const unsigned char *sha1, int); |
88cd621d | 206 | extern const unsigned char null_sha1[20]; |
e83c5163 | 207 | |
f2db68ed HE |
208 | int git_mkstemp(char *path, size_t n, const char *template); |
209 | ||
94df2506 JH |
210 | enum sharedrepo { |
211 | PERM_UMASK = 0, | |
212 | PERM_GROUP, | |
213 | PERM_EVERYBODY | |
214 | }; | |
215 | int git_config_perm(const char *var, const char *value); | |
457f06d6 | 216 | int adjust_shared_perm(const char *path); |
b2cb9425 | 217 | int safe_create_leading_directories(char *path); |
bd22c904 | 218 | char *enter_repo(char *path, int strict); |
b2cb9425 | 219 | |
e83c5163 | 220 | /* Read and unpack a sha1 file into memory, write memory to a sha1 file */ |
c4483576 | 221 | extern int unpack_sha1_header(z_stream *stream, void *map, unsigned long mapsize, void *buffer, unsigned long size); |
5180cacc | 222 | extern int parse_sha1_header(char *hdr, char *type, unsigned long *sizep); |
36e4d74a | 223 | extern int sha1_object_info(const unsigned char *, char *, unsigned long *); |
2ade9340 | 224 | extern void * unpack_sha1_file(void *map, unsigned long mapsize, char *type, unsigned long *size); |
73134b6d | 225 | extern void * read_sha1_file(const unsigned char *sha1, char *type, unsigned long *size); |
bf0f910d | 226 | extern int write_sha1_file(void *buf, unsigned long len, const char *type, unsigned char *return_sha1); |
7672db20 BL |
227 | extern char *write_sha1_file_prepare(void *buf, |
228 | unsigned long len, | |
229 | const char *type, | |
230 | unsigned char *sha1, | |
231 | unsigned char *hdr, | |
232 | int *hdrlen); | |
8237b185 | 233 | |
5d6ccf5c | 234 | extern int check_sha1_signature(const unsigned char *sha1, void *buf, unsigned long size, const char *type); |
e83c5163 | 235 | |
70b9829e DB |
236 | extern int write_sha1_from_fd(const unsigned char *sha1, int fd, char *buffer, |
237 | size_t bufsize, size_t *bufposn); | |
a5eda52b | 238 | extern int write_sha1_to_fd(int fd, const unsigned char *sha1); |
b721e01f | 239 | extern int move_temp_to_file(const char *tmpfile, char *filename); |
8237b185 | 240 | |
dade09c2 | 241 | extern int has_sha1_pack(const unsigned char *sha1); |
8237b185 DB |
242 | extern int has_sha1_file(const unsigned char *sha1); |
243 | ||
bf592c50 DB |
244 | extern int has_pack_file(const unsigned char *sha1); |
245 | extern int has_pack_index(const unsigned char *sha1); | |
246 | ||
e83c5163 | 247 | /* Convert to/from hex/sha1 representation */ |
46a6c262 JH |
248 | #define MINIMUM_ABBREV 4 |
249 | #define DEFAULT_ABBREV 7 | |
250 | ||
3c249c95 | 251 | extern int get_sha1(const char *str, unsigned char *sha1); |
197ee8c9 LT |
252 | extern int get_sha1_hex(const char *hex, unsigned char *sha1); |
253 | extern char *sha1_to_hex(const unsigned char *sha1); /* static buffer result! */ | |
ca8db142 | 254 | extern int read_ref(const char *filename, unsigned char *sha1); |
a876ed83 | 255 | extern const char *resolve_ref(const char *path, unsigned char *sha1, int); |
8098a178 JH |
256 | extern int create_symref(const char *git_HEAD, const char *refs_heads_master); |
257 | extern int validate_symref(const char *git_HEAD); | |
e83c5163 | 258 | |
958ba6c9 | 259 | extern int base_name_compare(const char *name1, int len1, int mode1, const char *name2, int len2, int mode2); |
79517a06 | 260 | extern int cache_name_compare(const char *name1, int len1, const char *name2, int len2); |
e83c5163 | 261 | |
40469ee9 | 262 | extern void *read_object_with_reference(const unsigned char *sha1, |
bf0f910d | 263 | const char *required_type, |
40469ee9 JH |
264 | unsigned long *size, |
265 | unsigned char *sha1_ret); | |
f4913f91 | 266 | |
f80cd783 | 267 | const char *show_date(unsigned long time, int timezone); |
2a387043 | 268 | const char *show_rfc2822_date(unsigned long time, int timezone); |
2a39064c | 269 | int parse_date(const char *date, char *buf, int bufsize); |
ecee9d9e | 270 | void datestamp(char *buf, int bufsize); |
3c07b1d1 | 271 | unsigned long approxidate(const char *); |
ecee9d9e | 272 | |
6aa33f40 | 273 | extern int setup_ident(void); |
749be728 JH |
274 | extern const char *git_author_info(int); |
275 | extern const char *git_committer_info(int); | |
6aa33f40 | 276 | |
12dccc16 LT |
277 | struct checkout { |
278 | const char *base_dir; | |
279 | int base_dir_len; | |
280 | unsigned force:1, | |
281 | quiet:1, | |
282 | not_new:1, | |
283 | refresh_cache:1; | |
284 | }; | |
285 | ||
de84f99c | 286 | extern int checkout_entry(struct cache_entry *ce, struct checkout *state, char *topath); |
12dccc16 | 287 | |
9a217f2a | 288 | extern struct alternate_object_database { |
d5a63b99 | 289 | struct alternate_object_database *next; |
9a217f2a | 290 | char *name; |
8f1d2e6f | 291 | char base[FLEX_ARRAY]; /* more */ |
d5a63b99 | 292 | } *alt_odb_list; |
9a217f2a JH |
293 | extern void prepare_alt_odb(void); |
294 | ||
295 | extern struct packed_git { | |
296 | struct packed_git *next; | |
297 | unsigned long index_size; | |
298 | unsigned long pack_size; | |
299 | unsigned int *index_base; | |
300 | void *pack_base; | |
301 | unsigned int pack_last_used; | |
f9253394 | 302 | unsigned int pack_use_cnt; |
9d835df2 | 303 | int pack_local; |
bf592c50 | 304 | unsigned char sha1[20]; |
8f1d2e6f JH |
305 | /* something like ".git/objects/pack/xxxxx.pack" */ |
306 | char pack_name[FLEX_ARRAY]; /* more */ | |
9a217f2a | 307 | } *packed_git; |
f3bf9224 JH |
308 | |
309 | struct pack_entry { | |
310 | unsigned int offset; | |
311 | unsigned char sha1[20]; | |
312 | struct packed_git *p; | |
313 | }; | |
314 | ||
d1c133f5 LT |
315 | struct ref { |
316 | struct ref *next; | |
317 | unsigned char old_sha1[20]; | |
318 | unsigned char new_sha1[20]; | |
ff27adf3 | 319 | unsigned char force; |
f88395ac | 320 | struct ref *peer_ref; /* when renaming */ |
8f1d2e6f | 321 | char name[FLEX_ARRAY]; /* more */ |
d1c133f5 LT |
322 | }; |
323 | ||
f7192598 LT |
324 | extern int git_connect(int fd[2], char *url, const char *prog); |
325 | extern int finish_connect(pid_t pid); | |
013e7c7f | 326 | extern int path_match(const char *path, int nr, char **match); |
f88395ac JH |
327 | extern int match_refs(struct ref *src, struct ref *dst, struct ref ***dst_tail, |
328 | int nr_refspec, char **refspec, int all); | |
41cb7488 | 329 | extern int get_ack(int fd, unsigned char *result_sha1); |
1a7141ff | 330 | extern struct ref **get_remote_heads(int in, struct ref **list, int nr_match, char **match, int ignore_funny); |
211b5f9e | 331 | extern int server_supports(const char *feature); |
f7192598 | 332 | |
bf592c50 | 333 | extern struct packed_git *parse_pack_index(unsigned char *sha1); |
2ab141a2 | 334 | extern struct packed_git *parse_pack_index_file(const unsigned char *sha1, |
c508df5e | 335 | char *idx_path); |
bf592c50 | 336 | |
9a217f2a | 337 | extern void prepare_packed_git(void); |
bf592c50 DB |
338 | extern void install_packed_git(struct packed_git *pack); |
339 | ||
340 | extern struct packed_git *find_sha1_pack(const unsigned char *sha1, | |
341 | struct packed_git *packs); | |
342 | ||
f9253394 JH |
343 | extern int use_packed_git(struct packed_git *); |
344 | extern void unuse_packed_git(struct packed_git *); | |
9d835df2 | 345 | extern struct packed_git *add_packed_git(char *, int, int); |
9a217f2a JH |
346 | extern int num_packed_objects(const struct packed_git *p); |
347 | extern int nth_packed_object_sha1(const struct packed_git *, int, unsigned char*); | |
f3bf9224 JH |
348 | extern int find_pack_entry_one(const unsigned char *, struct pack_entry *, struct packed_git *); |
349 | extern void *unpack_entry_gently(struct pack_entry *, char *, unsigned long *); | |
f8f135c9 | 350 | extern void packed_object_info_detail(struct pack_entry *, char *, unsigned long *, unsigned long *, unsigned int *, unsigned char *); |
9a217f2a | 351 | |
8f3f9b09 JH |
352 | /* Dumb servers support */ |
353 | extern int update_server_info(int); | |
354 | ||
17712991 LT |
355 | typedef int (*config_fn_t)(const char *, const char *); |
356 | extern int git_default_config(const char *, const char *); | |
4f629539 | 357 | extern int git_config_from_file(config_fn_t fn, const char *); |
17712991 LT |
358 | extern int git_config(config_fn_t fn); |
359 | extern int git_config_int(const char *, const char *); | |
360 | extern int git_config_bool(const char *, const char *); | |
10bea152 | 361 | extern int git_config_set(const char *, const char *); |
4ddba79d | 362 | extern int git_config_set_multivar(const char *, const char *, const char *, int); |
ab9cb76f | 363 | extern int check_repository_format_version(const char *var, const char *value); |
17712991 | 364 | |
e1b10391 LT |
365 | #define MAX_GITNAME (1000) |
366 | extern char git_default_email[MAX_GITNAME]; | |
367 | extern char git_default_name[MAX_GITNAME]; | |
368 | ||
4e72dcec JH |
369 | #define MAX_ENCODING_LENGTH 64 |
370 | extern char git_commit_encoding[MAX_ENCODING_LENGTH]; | |
371 | ||
f3123c4a | 372 | extern int copy_fd(int ifd, int ofd); |
ad897215 JH |
373 | |
374 | /* Finish off pack transfer receiving end */ | |
583b7ea3 JH |
375 | extern int receive_unpack_pack(int fd[2], const char *me, int quiet, int); |
376 | extern int receive_keep_pack(int fd[2], const char *me, int quiet, int); | |
ad897215 | 377 | |
f67b45f8 LT |
378 | /* pager.c */ |
379 | extern void setup_pager(void); | |
380 | ||
051308f6 JH |
381 | /* base85 */ |
382 | int decode_85(char *dst, char *line, int linelen); | |
0660626c | 383 | void encode_85(char *buf, unsigned char *data, int bytes); |
051308f6 | 384 | |
855419f7 LT |
385 | /* alloc.c */ |
386 | struct blob; | |
387 | struct tree; | |
388 | struct commit; | |
389 | struct tag; | |
390 | extern struct blob *alloc_blob_node(void); | |
391 | extern struct tree *alloc_tree_node(void); | |
392 | extern struct commit *alloc_commit_node(void); | |
393 | extern struct tag *alloc_tag_node(void); | |
394 | extern void alloc_report(void); | |
395 | ||
e83c5163 | 396 | #endif /* CACHE_H */ |