fetch-pack.h 2.85 KB
Newer Older
1 2 3
#ifndef FETCH_PACK_H
#define FETCH_PACK_H

4
#include "string-list.h"
5
#include "run-command.h"
6
#include "protocol.h"
7
#include "list-objects-filter-options.h"
8

9
struct oid_array;
10

11
struct fetch_pack_args {
12 13 14
	const char *uploadpack;
	int unpacklimit;
	int depth;
15
	const char *deepen_since;
16
	const struct string_list *deepen_not;
17
	struct list_objects_filter_options filter_options;
18
	const struct string_list *server_options;
19 20 21 22 23 24 25

	/*
	 * If not NULL, during packfile negotiation, fetch-pack will send "have"
	 * lines only with these tips and their ancestors.
	 */
	const struct oid_array *negotiation_tips;

26
	unsigned deepen_relative:1;
27 28 29 30 31 32
	unsigned quiet:1;
	unsigned keep_pack:1;
	unsigned lock_pack:1;
	unsigned use_thin_pack:1;
	unsigned fetch_all:1;
	unsigned stdin_refs:1;
33
	unsigned diag_url:1;
34 35 36 37 38 39
	unsigned verbose:1;
	unsigned no_progress:1;
	unsigned include_tag:1;
	unsigned stateless_rpc:1;
	unsigned check_self_contained_and_connected:1;
	unsigned self_contained_and_connected:1;
40
	unsigned cloning:1;
41
	unsigned update_shallow:1;
42
	unsigned deepen:1;
43 44 45
	unsigned from_promisor:1;

	/*
46 47 48 49 50 51 52
	 * Attempt to fetch only the wanted objects, and not any objects
	 * referred to by them. Due to protocol limitations, extraneous
	 * objects may still be included. (When fetching non-blob
	 * objects, only blobs are excluded; when fetching a blob, the
	 * blob itself will still be sent. The client does not need to
	 * know whether a wanted object is a blob or not.)
	 *
53 54 55 56 57
	 * If 1, fetch_pack() will also not modify any object flags.
	 * This allows fetch_pack() to safely be called by any function,
	 * regardless of which object flags it uses (if any).
	 */
	unsigned no_dependents:1;
58 59 60 61 62 63 64 65 66 67 68 69 70 71 72

	/*
	 * Because fetch_pack() overwrites the shallow file upon a
	 * successful deepening non-clone fetch, if this struct
	 * specifies such a fetch, fetch_pack() needs to perform a
	 * connectivity check before deciding if a fetch is successful
	 * (and overwriting the shallow file). fetch_pack() sets this
	 * field to 1 if such a connectivity check was performed.
	 *
	 * This is different from check_self_contained_and_connected
	 * in that the former allows existing objects in the
	 * repository to satisfy connectivity needs, whereas the
	 * latter doesn't.
	 */
	unsigned connectivity_checked:1;
73 74
};

75
/*
76 77 78
 * sought represents remote references that should be updated from.
 * On return, the names that were found on the remote will have been
 * marked as such.
79
 */
80
struct ref *fetch_pack(struct fetch_pack_args *args,
81
		       int fd[],
82
		       const struct ref *ref,
83 84
		       struct ref **sought,
		       int nr_sought,
85
		       struct oid_array *shallow,
86 87
		       char **pack_lockfile,
		       enum protocol_version version);
88

89 90 91 92 93 94
/*
 * Print an appropriate error message for each sought ref that wasn't
 * matched.  Return 0 if all sought refs were matched, otherwise 1.
 */
int report_unmatched_refs(struct ref **sought, int nr_sought);

95
#endif