Merge branch 'mh/http-urlmatch-cleanup'
[git/git.git] / fetch-pack.h
CommitLineData
2d4177c0
DB
1#ifndef FETCH_PACK_H
2#define FETCH_PACK_H
3
8bee93dd 4#include "string-list.h"
47a59185 5#include "run-command.h"
685fbd32 6#include "protocol.h"
640d8b72 7#include "list-objects-filter-options.h"
8bee93dd 8
910650d2 9struct oid_array;
beea4152 10
9cba13ca 11struct fetch_pack_args {
2d4177c0 12 const char *uploadpack;
2d4177c0 13 int unpacklimit;
2d4177c0 14 int depth;
508ea882 15 const char *deepen_since;
a45a2600 16 const struct string_list *deepen_not;
640d8b72 17 struct list_objects_filter_options filter_options;
5e3548ef 18 const struct string_list *server_options;
3390e42a
JT
19
20 /*
21 * If not NULL, during packfile negotiation, fetch-pack will send "have"
22 * lines only with these tips and their ancestors.
23 */
24 const struct oid_array *negotiation_tips;
25
cccf74e2 26 unsigned deepen_relative:1;
f6486f07
NTND
27 unsigned quiet:1;
28 unsigned keep_pack:1;
29 unsigned lock_pack:1;
30 unsigned use_thin_pack:1;
31 unsigned fetch_all:1;
32 unsigned stdin_refs:1;
92251b1b 33 unsigned diag_url:1;
f6486f07
NTND
34 unsigned verbose:1;
35 unsigned no_progress:1;
36 unsigned include_tag:1;
37 unsigned stateless_rpc:1;
38 unsigned check_self_contained_and_connected:1;
39 unsigned self_contained_and_connected:1;
beea4152 40 unsigned cloning:1;
48d25cae 41 unsigned update_shallow:1;
79891cb9 42 unsigned deepen:1;
88e2f9ed
JT
43 unsigned from_promisor:1;
44
45 /*
4c7f9567
JT
46 * Attempt to fetch only the wanted objects, and not any objects
47 * referred to by them. Due to protocol limitations, extraneous
48 * objects may still be included. (When fetching non-blob
49 * objects, only blobs are excluded; when fetching a blob, the
50 * blob itself will still be sent. The client does not need to
51 * know whether a wanted object is a blob or not.)
52 *
88e2f9ed
JT
53 * If 1, fetch_pack() will also not modify any object flags.
54 * This allows fetch_pack() to safely be called by any function,
55 * regardless of which object flags it uses (if any).
56 */
57 unsigned no_dependents:1;
cf1e7c07
JT
58
59 /*
60 * Because fetch_pack() overwrites the shallow file upon a
61 * successful deepening non-clone fetch, if this struct
62 * specifies such a fetch, fetch_pack() needs to perform a
63 * connectivity check before deciding if a fetch is successful
64 * (and overwriting the shallow file). fetch_pack() sets this
65 * field to 1 if such a connectivity check was performed.
66 *
67 * This is different from check_self_contained_and_connected
68 * in that the former allows existing objects in the
69 * repository to satisfy connectivity needs, whereas the
70 * latter doesn't.
71 */
72 unsigned connectivity_checked:1;
2d4177c0
DB
73};
74
4ba15999 75/*
f2db854d
JH
76 * sought represents remote references that should be updated from.
77 * On return, the names that were found on the remote will have been
78 * marked as such.
4ba15999 79 */
fa740529 80struct ref *fetch_pack(struct fetch_pack_args *args,
0f804b0b 81 int fd[],
63c69453 82 const struct ref *ref,
f2db854d
JH
83 struct ref **sought,
84 int nr_sought,
910650d2 85 struct oid_array *shallow,
685fbd32
BW
86 char **pack_lockfile,
87 enum protocol_version version);
2d4177c0 88
e860d96b
MM
89/*
90 * Print an appropriate error message for each sought ref that wasn't
91 * matched. Return 0 if all sought refs were matched, otherwise 1.
92 */
93int report_unmatched_refs(struct ref **sought, int nr_sought);
94
2d4177c0 95#endif