path: root/Documentation/technical/protocol-capabilities.txt
diff options
authorJeff Hostetler <>2017-12-08 15:58:39 (GMT)
committerJunio C Hamano <>2017-12-08 17:58:51 (GMT)
commit10ac85c785afed4163ed931149a87b30c7c5eaf9 (patch)
treed71b7b3fa091e08ed27bb8330e27ae5dfafb3254 /Documentation/technical/protocol-capabilities.txt
parent0c16cd499dee09b7fc6dd10cb6a476e96c147ef6 (diff)
upload-pack: add object filtering for partial clone
Teach upload-pack to negotiate object filtering over the protocol and to send filter parameters to pack-objects. This is intended for partial clone and fetch. The idea to make upload-pack configurable using uploadpack.allowFilter comes from Jonathan Tan's work in [1]. [1] Signed-off-by: Jeff Hostetler <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/technical/protocol-capabilities.txt')
1 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/technical/protocol-capabilities.txt b/Documentation/technical/protocol-capabilities.txt
index 26dcc6f..332d209 100644
--- a/Documentation/technical/protocol-capabilities.txt
+++ b/Documentation/technical/protocol-capabilities.txt
@@ -309,3 +309,11 @@ to accept a signed push certificate, and asks the <nonce> to be
included in the push certificate. A send-pack client MUST NOT
send a push-cert packet unless the receive-pack server advertises
this capability.
+If the upload-pack server advertises the 'filter' capability,
+fetch-pack may send "filter" commands to request a partial clone
+or partial fetch and request that the server omit various objects
+from the packfile.