Skip to content

Commit 1b421e7

Browse files
peffgitster
authored andcommitted
docs/protocol-v2: point readers transport config discussion
We recently added tips for server admins to configure various transports to support v2's GIT_PROTOCOL variable. While the protocol-v2 document is pretty technical and not of interest to most admins, it may be a starting point for them to figure out how to turn on v2. Let's put some pointers from there to the other documentation. Signed-off-by: Jeff King <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 2834a72 commit 1b421e7

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

Documentation/technical/protocol-v2.txt

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,8 @@ Initial Client Request
4242
In general a client can request to speak protocol v2 by sending
4343
`version=2` through the respective side-channel for the transport being
4444
used which inevitably sets `GIT_PROTOCOL`. More information can be
45-
found in `pack-protocol.txt` and `http-protocol.txt`. In all cases the
45+
found in `pack-protocol.txt` and `http-protocol.txt`, as well as the
46+
`GIT_PROTOCOL` definition in `git.txt`. In all cases the
4647
response from the server is the capability advertisement.
4748

4849
Git Transport
@@ -58,6 +59,8 @@ SSH and File Transport
5859

5960
When using either the ssh:// or file:// transport, the GIT_PROTOCOL
6061
environment variable must be set explicitly to include "version=2".
62+
The server may need to be configured to allow this environment variable
63+
to pass.
6164

6265
HTTP Transport
6366
~~~~~~~~~~~~~~
@@ -81,6 +84,9 @@ A v2 server would reply:
8184
Subsequent requests are then made directly to the service
8285
`$GIT_URL/git-upload-pack`. (This works the same for git-receive-pack).
8386

87+
The server may need to be configured to pass this header's contents via
88+
the `GIT_PROTOCOL` variable. See the discussion in `git-http-backend.txt`.
89+
8490
Capability Advertisement
8591
------------------------
8692

0 commit comments

Comments
 (0)