On 02/21, Dorian Taylor wrote:
>
> > On Feb 21, 2018, at 9:37 PM, Jonathan Nieder <jrnieder@xxxxxxxxx> wrote:
> >
> > Thanks for writing it.
> >
> > Do you mind if we forge your sign-off? (See Documentation/SubmittingPatches
> > item '(5) Certify your work' for details about what this means.)
>
> Sure, or I can just re-paste:
>
> Signed-off-by: Dorian Taylor <dorian.taylor.lists@xxxxxxxxx>
>
> ---
> Documentation/technical/http-protocol.txt | 10 +++++++---
> 1 file changed, 7 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/technical/http-protocol.txt b/Documentation/technical/http-protocol.txt
> index a0e45f2889e6e..19d73f7efb338 100644
> --- a/Documentation/technical/http-protocol.txt
> +++ b/Documentation/technical/http-protocol.txt
> @@ -214,14 +214,17 @@ smart server reply:
> S: Cache-Control: no-cache
> S:
> S: 001e# service=git-upload-pack\n
> + S: 0000
> S: 004895dcfa3633004da0049d3d0fa03f80589cbcaf31 refs/heads/maint\0multi_ack\n
> S: 0042d049f6c27a2244e12041955e262a404c7faba355 refs/heads/master\n
> S: 003c2cb58b79488a98d2721cea644875a8dd0026b115 refs/tags/v1.0\n
> S: 003fa3c2e2402b99163d1d59756e5f207ae21cccba4c refs/tags/v1.0^{}\n
> + S: 0000
>
> The client may send Extra Parameters (see
> Documentation/technical/pack-protocol.txt) as a colon-separated string
> -in the Git-Protocol HTTP header.
> +in the Git-Protocol HTTP header. Note as well that there is *no* newline
> +after the `0000`.
>
> Dumb Server Response
> ^^^^^^^^^^^^^^^^^^^^
> @@ -264,8 +267,8 @@ Servers MUST set $servicename to be the request parameter value.
> Servers SHOULD include an LF at the end of this line.
> Clients MUST ignore an LF at the end of the line.
>
> -Servers MUST terminate the response with the magic `0000` end
> -pkt-line marker.
> +Servers MUST follow the first pkt-line, as well as terminate the
> +response, with the magic `0000` end pkt-line marker.
>
> The returned response is a pkt-line stream describing each ref and
> its known value. The stream SHOULD be sorted by name according to
> @@ -278,6 +281,7 @@ Extra Parameter.
>
> smart_reply = PKT-LINE("# service=$servicename" LF)
> *1("version 1")
> + "0000"
> ref_list
> "0000"
> ref_list = empty_list / non_empty_list
>
> ---
>
> >
> >> Note I am not sure what the story is behind that `version 1`
> >> element, whether it's supposed to go before or after the null packet
> >> or if there should be another null packet or what. Perhaps somebody
> >> more fluent with the smart protocol can advise.
> >
> > I believe the 'version 1' goes after the flush-packet.
>
> I took a traipse through the code and couldn’t determine it one way or another, but my money is on that looking something like `000aversion 1\n` on the wire.
Yes the version string goes along with the ref_list in v1 like so:
# service=<service>
0000
version 1
ref_list
0000
This is because it is part of the payload which is actually delivered to
the git fetch/push binary where as the "# service" bit is used by the
remote helper to identify smart vs not smart servers.
>
> --
> Dorian Taylor
> Make things. Make sense.
> https://doriantaylor.com
>
--
Brandon Williams
