summaryrefslogtreecommitdiff
path: root/connected.h
blob: eba5c261bac1887289ac70425cee8c97e9006ece (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
#ifndef CONNECTED_H
#define CONNECTED_H
 
struct object_id;
struct transport;
 
/*
 * Take callback data, and return next object name in the buffer.
 * When called after returning the name for the last object, return -1
 * to signal EOF, otherwise return 0.
 */
typedef int (*oid_iterate_fn)(void *, struct object_id *oid);
 
/*
 * Named-arguments struct for check_connected. All arguments are
 * optional, and can be left to defaults as set by CHECK_CONNECTED_INIT.
 */
struct check_connected_options {
	/* Avoid printing any errors to stderr. */
	int quiet;
 
	/* --shallow-file to pass to rev-list sub-process */
	const char *shallow_file;
 
	/* Transport whose objects we are checking, if available. */
	struct transport *transport;
 
	/*
	 * If non-zero, send error messages to this descriptor rather
	 * than stderr. The descriptor is closed before check_connected
	 * returns.
	 */
	int err_fd;
 
	/* If non-zero, show progress as we traverse the objects. */
	int progress;
 
	/*
	 * Insert these variables into the environment of the child process.
	 */
	const char **env;
 
	/*
	 * If non-zero, check the ancestry chain completely, not stopping at
	 * any existing ref. This is necessary when deepening existing refs
	 * during a fetch.
	 */
	unsigned is_deepening_fetch : 1;
 
	/*
	 * If non-zero, only check that the top-level objects referenced by the
	 * wanted refs (passed in as cb_data) are promisor objects. This is
	 * useful for partial clones, where enumerating and excluding all
	 * promisor objects is very slow and the commit-walk itself becomes a
	 * no-op.
	 */
	unsigned check_refs_are_promisor_objects_only : 1;
};
 
#define CHECK_CONNECTED_INIT { 0 }
 
/*
 * Make sure that all given objects and all objects reachable from them
 * either exist in our object store or (if the repository is a partial
 * clone) are promised to be available.
 *
 * Return 0 if Ok, non zero otherwise (i.e. some missing objects)
 *
 * If "opt" is NULL, behaves as if CHECK_CONNECTED_INIT was passed.
 */
int check_connected(oid_iterate_fn fn, void *cb_data,
		    struct check_connected_options *opt);
 
#endif /* CONNECTED_H */