summaryrefslogtreecommitdiff
path: root/Documentation/technical
diff options
context:
space:
mode:
authorJonathan Tan <jonathantanmy@google.com>2018-05-03 23:46:56 (GMT)
committerJunio C Hamano <gitster@pobox.com>2018-05-06 04:17:19 (GMT)
commitba95710a3bdcb2a80495b1d93a0e482dd69905e1 (patch)
tree8336ff3d7af8a17c68a144edf627700643a457a2 /Documentation/technical
parent5459268751941a71b32816902698376b7932cec5 (diff)
downloadgit-ba95710a3bdcb2a80495b1d93a0e482dd69905e1.zip
git-ba95710a3bdcb2a80495b1d93a0e482dd69905e1.tar.gz
git-ba95710a3bdcb2a80495b1d93a0e482dd69905e1.tar.bz2
{fetch,upload}-pack: support filter in protocol v2
The fetch-pack/upload-pack protocol v2 was developed independently of the filter parameter (used in partial fetches), thus it did not include support for it. Add support for the filter parameter. Like in the legacy protocol, the server advertises and supports "filter" only if uploadpack.allowfilter is configured. Like in the legacy protocol, the client continues with a warning if "--filter" is specified, but the server does not advertise it. Signed-off-by: Jonathan Tan <jonathantanmy@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/technical')
-rw-r--r--Documentation/technical/protocol-v2.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/Documentation/technical/protocol-v2.txt b/Documentation/technical/protocol-v2.txt
index 136179d..38d24fd 100644
--- a/Documentation/technical/protocol-v2.txt
+++ b/Documentation/technical/protocol-v2.txt
@@ -290,6 +290,15 @@ included in the clients request as well as the potential addition of the
Cannot be used with "deepen", but can be used with
"deepen-since".
+If the 'filter' feature is advertised, the following argument can be
+included in the client's request:
+
+ filter <filter-spec>
+ Request that various objects from the packfile be omitted
+ using one of several filtering techniques. These are intended
+ for use with partial clone and partial fetch operations. See
+ `rev-list` for possible "filter-spec" values.
+
The response of `fetch` is broken into a number of sections separated by
delimiter packets (0001), with each section beginning with its section
header.