upload-pack: allow stateless client EOF just prior to haves
PATCH 1/1 upload-pack: allow stateless client EOF just prior to haves
During stateless packfile negotiation, it is normal behavior for stateless RPC clients (e.g. git-remote-curl) to send multiple upload-pack requests with the first containing only the wants/shallows/deepens/filters followed by a flush.
When run in stateless mode, continuing on without first checking that the client request has reached EOF can result in a bad file descriptor during get_common_commits.
Instead, upload-pack should gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
--- t/t9904-upload-pack-stateless-timely-eof.sh | 24 ++++++++++++++++++++++++ upload-pack.c | 13 ++++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100755 t/t9904-upload-pack-stateless-timely-eof.sh
t/t9904-upload-pack-stateless-timely-eof.sh new file +24 -0
@@ -0,0 +1,24 @@ +#!/bin/sh + +test_description='stateless upload-pack gently handles EOF just after want/shallow/depth/flush' + +. ./test-lib.sh + +D=$(pwd) + +test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + hexsz=$(test_oid hexsz) && + + printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ + $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request && + + git upload-pack --stateless-rpc "$(pwd)" <request >actual && + + printf "0000" >expect && + + test_cmp expect actual +' + +test_done
upload-pack.c +12 -1
@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);receive_needs (&data, &reader); -if (data.want_obj.nr) { + +/* +* An EOF at this exact point in negotiation should be +* acceptable from stateless clients as they will consume the +* shallow list before doing subsequent rpc with haves/etc. +*/ +if (data.stateless_rpc) + reader.options |=PACKET_READ_GENTLE_ON_EOF ; + +if (data.want_obj.nr && +packet_reader_peek (&reader) !=PACKET_READ_EOF ) { + reader.options ^=PACKET_READ_GENTLE_ON_EOF ;get_common_commits (&data, &reader);create_pack_file (&data,NULL ); }
Signature · 1 line
2.6.1
Quoted 9 lines · Daniel Duvall
[...]
Instead, upload-pack should gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.Signed-off-by Daniel Duvall <[email protected]>---
t/t9904-upload-pack-stateless-timely-eof.sh line 7
Quoted 7 lines
t/t9904-upload-pack-stateless-timely-eof.sh +7
-0@@ -0,0 +1,24 @@ +#!/bin/sh + +test_description='stateless upload-pack gently handles EOF just after want/shallow/depth/flush' + +. ./test-lib.sh + +D=$(pwd)
What is the purpose of this assignment? It doesn't seem to be used anywhere in this script.
Quoted 16 lines
t/t9904-upload-pack-stateless-timely-eof.sh +16
-0+test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + hexsz=$(test_oid hexsz) && + + printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ + $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request && + + git upload-pack --stateless-rpc "$(pwd)" <request >actual && + + printf "0000" >expect && + + test_cmp expect actual +' + +test_done
Quoted 7 lines · Eric Sunshine
Quoted 5 lines · Daniel Duvall
[...]
Instead, upload-pack should gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
Quoted 14 lines
t/t9904-upload-pack-stateless-timely-eof.sh line 7
Quoted 11 lines
Signed-off-by Daniel Duvall <[email protected]>---
t/t9904-upload-pack-stateless-timely-eof.sh +7
-0@@ -0,0 +1,24 @@ +#!/bin/sh + +test_description='stateless upload-pack gently handles EOF just after want/shallow/depth/flush' + +. ./test-lib.sh + +D=$(pwd)What is the purpose of this assignment? It doesn't seem to be used anywhere in this script.
It's an artifact of my copying/pasting a previous test script as a template. I didn't see it used in that script either, so I assumed it was needed somewhere in the test libs. If that's not the case, I can definitely remove it.
Quoted 17 lines
Quoted 17 lines
t/t9904-upload-pack-stateless-timely-eof.sh +16
-0+test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + hexsz=$(test_oid hexsz) && + + printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ + $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request && + + git upload-pack --stateless-rpc "$(pwd)" <request >actual && + + printf "0000" >expect && + + test_cmp expect actual +' + +test_done
PATCH 1/1 upload-pack: allow stateless client EOF just prior to haves
In reply to Daniel DuvallDuring stateless packfile negotiation, it is normal behavior for stateless RPC clients (e.g. git-remote-curl) to send multiple upload-pack requests with the first containing only the wants/shallows/deepens/filters followed by a flush.
When run in stateless mode, continuing on without first checking that the client request has reached EOF can result in a bad file descriptor during get_common_commits.
Instead, upload-pack should gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
--- t/t9904-upload-pack-stateless-timely-eof.sh | 22 ++++++++++++++++++++++ upload-pack.c | 13 ++++++++++++- 2 files changed, 34 insertions(+), 1 deletion(-) create mode 100755 t/t9904-upload-pack-stateless-timely-eof.sh
t/t9904-upload-pack-stateless-timely-eof.sh new file +22 -0
@@ -0,0 +1,22 @@ +#!/bin/sh + +test_description='stateless upload-pack gently handles EOF just after want/shallow/depth/flush' + +. ./test-lib.sh + +test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + hexsz=$(test_oid hexsz) && + + printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ + $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request && + + git upload-pack --stateless-rpc "$(pwd)" <request >actual && + + printf "0000" >expect && + + test_cmp expect actual +' + +test_done
upload-pack.c +12 -1
@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);receive_needs (&data, &reader); -if (data.want_obj.nr) { + +/* +* An EOF at this exact point in negotiation should be +* acceptable from stateless clients as they will consume the +* shallow list before doing subsequent rpc with haves/etc. +*/ +if (data.stateless_rpc) + reader.options |=PACKET_READ_GENTLE_ON_EOF ; + +if (data.want_obj.nr && +packet_reader_peek (&reader) !=PACKET_READ_EOF ) { + reader.options ^=PACKET_READ_GENTLE_ON_EOF ;get_common_commits (&data, &reader);create_pack_file (&data,NULL ); }
Signature · 1 line
2.6.1
Quoted 11 lines · Daniel Duvall
upload-pack.c +2
-1@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);receive_needs (&data, &reader); -if (data.want_obj.nr) { + +/*
upload-pack.c void upload_pack(struct upload_pack_options *options) · line 1358
Quoted 10 lines
upload-pack.c +10
-0+* An EOF at this exact point in negotiation should be +* acceptable from stateless clients as they will consume the +* shallow list before doing subsequent rpc with haves/etc. +*/ +if (data.stateless_rpc) + reader.options |=PACKET_READ_GENTLE_ON_EOF ; + +if (data.want_obj.nr && +packet_reader_peek (&reader) !=PACKET_READ_EOF ) { + reader.options ^=PACKET_READ_GENTLE_ON_EOF ;
I am a bit puzzled why it is sensible to
(1) unconditionally
(2) toggle
the GENTLE bit.
upload-pack.c void upload_pack(struct upload_pack_options *options) · line 1361
Quoted 3 lines
upload-pack.c +0
-0get_common_commits (&data, &reader);create_pack_file (&data,NULL ); }
If we are not doing stateless_rpc, we call get_common_commits() with a reader that is gentle on eof, which is not an intended behaviour change, no?
I would have understood if this were more like
if (data.stateless_rpc)
reader.options |= PACKET_READ_GENTLE_ON_EOF;
if (data.want_obj.nr &&
packet_reader_peek(&reader) != PACKET_READ_EOF) {
if (data.stateless_rpc)
reader.options &= ~PACKET_READ_GENTLE_ON_EOF;i.e. only when we know we set the bit when the bit was originally clear, revert to the original state.
Note. initially I thought we may need to check the original value of the bit in reader.options before flipping it on, but this packet_reader has freshly been initialized in the inner block we see here, so we know that nobody other than this new code would have set the bit.
Or for that matter, just unconditionally turn it off, e.g.
if (data.want_obj.nr &&
packet_reader_peek(&reader) != PACKET_READ_EOF) {
reader.options &= ~PACKET_READ_GENTLE_ON_EOF;Puzzled...
Quoted 6 lines · Junio C Hamano
I am a bit puzzled why it is sensible to
(1) unconditionally
(2) togglethe GENTLE bit.
That was pure carelessness on my part in flipping it instead of using &= ~. Fixed in v2
Quoted 4 lines · Daniel Duvall
During stateless packfile negotiation, it is normal behavior for stateless RPC clients (e.g. git-remote-curl) to send multiple upload-pack requests with the first containing only the wants/shallows/deepens/filters followed by a flush.
Hmm, is this normal? I'd expect it to send a "done" after the flush, and indeed that's what happens if I try it. I see:
E.g., here's GIT_TRACE_CURL output from a v0 request (fetching into an empty repo):
Send data: 00a8want 4b379b7a1b97790f805c365b1e58b75b70d3d904 multi_ack_ Send data: detailed no-done side-band-64k thin-pack ofs-delta deepen-si Send data: nce deepen-not agent=git/2.29.2.477.g2cec8aa0af.00000009done Send data: .
Info: upload completely sent off: 181 out of 181 bytes
However, if I add --depth 1 to my fetch, I get:
Send data: 00a8want 4b379b7a1b97790f805c365b1e58b75b70d3d904 multi_ack_ Send data: detailed no-done side-band-64k thin-pack ofs-delta deepen-si Send data: nce deepen-not agent=git/2.29.2.477.g2cec8aa0af.000cdeepen 1 Send data: 0000
Info: upload completely sent off: 184 out of 184 bytes
Which maybe makes sense if we need the shallow response from the server to determine the next step of the request. It doesn't matter for my trivial case here (we end up resending the same request with a "done" added), but I guess it could in other cases.
This client side code is in fetch-pack.c:
static int find_common(struct fetch_negotiator *negotiator, [...]
{
[...]
if (args->deepen) {
[...]
send_request(args, fd[1], &req_buf);
while (packet_reader_read(&reader) == PACKET_READ_NORMAL) {
if (skip_prefix(reader.line, "shallow ", &arg)) {
[...etc...]
}
} else if (!args->stateless_rpc)
send_request(args, fd[1], &req_buf);and dates all the way back to 249b2004d8 (Smart fetch over HTTP: client side, 2009-10-30). Curiously we don't send it in non-stateless-rpc mode, even if we're shallow. So I'm a little puzzled why we need the response first in the stateless case, as we start writing "have" lines at the server whether before we get the shallow lines back from the server in either case.
So I'm not entirely convinced there isn't a small bug lurking on the client side here. Not one that produces a wrong answer, but one which wastes an extra round trip to the server. I won't be at all surprised if there is some subtle timing dependency here, though, and the extra request really is necessary.
But even if it is a client-side bug, it has been in the wild for a long time, and it may be worth having the server side handle this more gracefully.
Quoted 3 lines
When run in stateless mode, continuing on without first checking that the client request has reached EOF can result in a bad file descriptor during
get_common_commits.
When you say "bad file descriptor" that makes me think we're getting EBADF after trying to use a closed descriptor. But we'd die() as soon as the pkt-line code tries to read and gets eof, right?
That's also worth fixing, but I want to make sure I understand the problem completely. I think this part of the commit message would be a good place to talk about the real-world effects:
- the client doesn't care; by definition it has hung up at this point and will keep going with its next request
- likewise, the server doesn't care in terms of its response; by definition it is stateless, so the next request the client makes will start fresh
- it is annoying for server admins who get a bunch of useless logs with "remote end hung up unexpected", or if they are tracking exit codes from upload-pack
As somebody who has admin'd a busy git site, unexpected client network drops are just a fact of life and you have to look past them in your logs. But I still think it's worth keeping it as uncluttered as possible and having upload-pack handle this without an error message.
Quoted 3 lines
Instead, upload-pack should gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
Should we do this only if we saw a deepen line? From my reading of the client code, that's the only thing that would cause this early request. I don't know if there's any particular advantage to being more strict here.
If we're _not_ going to be strict, then I actually wonder if we ought to simply teach get_common_commits() that seeing an EOF is OK in stateless mode, wherever it comes. It can't possibly impact the correctness of the protocol conversation (since we're stateless and the client is gone), but maybe it's useful if you're trying to count how often clients really do hang up.
t/t9904-upload-pack-stateless-timely-eof.sh
Quoted 2 lines
t/t9904-upload-pack-stateless-timely-eof.sh new file +0
-0
We usually try to group related tests by number. Maybe t5705 would be a better spot? I also wondered if this could go into t5704, but its title is "protocol violations". It's not clear to me yet if this is a violation that happens to be mostly harmless, or something we need to be doing. :)
t/t9904-upload-pack-stateless-timely-eof.sh
Quoted 7 lines
t/t9904-upload-pack-stateless-timely-eof.sh new file +7
-0+test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + hexsz=$(test_oid hexsz) && + + printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ + $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request &&
We have a helper function that makes this a bit easier to read:
t/t9904-upload-pack-stateless-timely-eof.sh +6 -3
@@ -9,10 +9,13 @@ D=$(pwd) test_expect_success 'upload-pack outputs flush and exits ok' ' test_commit initial && head=$(git rev-parse HEAD) && - hexsz=$(test_oid hexsz) && - printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ - $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request && + { + packetize "want $head" && + packetize "shallow $head" && + packetize "deepen 1" && + printf "0000" + } >request && git upload-pack --stateless-rpc "$(pwd)" <request >actual &&
t/t9904-upload-pack-stateless-timely-eof.sh
Quoted 1 line
t/t9904-upload-pack-stateless-timely-eof.sh new file +1
-0+ git upload-pack --stateless-rpc "$(pwd)" <request >actual &&
You can just use "." here, which is a little shorter. It's not entirely cosmetic; the difference between $PWD and $(pwd) on Windows always trips me up, so I try to avoid using either whenever I can. ;)
It would be nice if we could test this through a real use of Git, but it might not be worth the hassle. I guess we'd have to mine the apache logs in one of our http test scripts to see if upload-pack failed. And I guess if we _do_ change the client side to stop sending the extra request but want to treat historical clients more gracefully, we'd still need a manual test like this.
upload-pack.c void upload_pack(struct upload_pack_options *options) · line 1344
Quoted 4 lines
upload-pack.c +0
-0@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);
The actual fix looks correct to me, modulo the alternatives I raised earlier.
This function only handles the v0 protocol. For v2, we end up in upload_pack_v2(). But my reading of the client side do_fetch_pack_v2() is that it _doesn't_ send this extra request. And a simple test seems to confirm it. Which gives me further pause as to whether the extra request is necessary for v0.
Well, that review ended up a bit longer than I had imagined. So let me add what I should have said at the top: welcome to the Git list, and thanks for looking into this issue. :)
-Peff
Thanks for the welcome! I appreciate the lengthy feedback, because above all else I'd love to understand the low-level workings of git better than I do now.
Quoted 28 lines · Jeff King
Quoted 4 lines · Daniel Duvall
During stateless packfile negotiation, it is normal behavior for stateless RPC clients (e.g. git-remote-curl) to send multiple upload-pack requests with the first containing only the wants/shallows/deepens/filters followed by a flush.
Hmm, is this normal? I'd expect it to send a "done" after the flush, and indeed that's what happens if I try it. I see:
E.g., here's
GIT_TRACE_CURLoutput from a v0 request (fetching into an empty repo):Send data: 00a8want
4b379b7a1b97790f805c365b1e58b75b70d3d904multi_ack_Send data: detailed no-done side-band-64k thin-pack ofs-delta deepen-si Send data: nce deepen-not agent=git/2.29.2.477.g2cec8aa0af.00000009done Send data: .
Info: upload completely sent off: 181 out of 181 bytesHowever, if I add --depth 1 to my fetch, I get:
Send data: 00a8want
4b379b7a1b97790f805c365b1e58b75b70d3d904multi_ack_Send data: detailed no-done side-band-64k thin-pack ofs-delta deepen-si Send data: nce deepen-not agent=git/2.29.2.477.g2cec8aa0af.000cdeepen 1 Send data: 0000
Info: upload completely sent off: 184 out of 184 bytes
Quoted 4 lines
Which maybe makes sense if we need the shallow response from the server to determine the next step of the request. It doesn't matter for my trivial case here (we end up resending the same request with a "done" added), but I guess it could in other cases.
Right. This is what I was observing too—in a trivial case, the same roundtrip being made again with nothing additional but "done". I should have clarified that I thought it was normal only when a depth was provided. I've been learning the packfile negotiation protocols as I've been debugging this issue, so I probably should have reserved my assertion of "normal" for when I have a firm grasp of them. :)
Quoted 8 lines
Quoted 4 lines
When run in stateless mode, continuing on without first checking that the client request has reached EOF can result in a bad file descriptor during
get_common_commits.When you say "bad file descriptor" that makes me think we're getting EBADF after trying to use a closed descriptor. But we'd
die()as soon as the pkt-line code tries to read and gets eof, right?
Right. It's still a valid file descriptor but a premature die() upon EOF. I'll clarify that.
Quoted 7 lines
That's also worth fixing, but I want to make sure I understand the problem completely. I think this part of the commit message would be a good place to talk about the real-world effects:
- the client doesn't care; by definition it has hung up at this point and will keep going with its next request
That's true in the case where the server doesn't surface the non-zero exit code from git-upload-pack—which results in git-http-backend existing non-zero as well. An apache setup I used in testing doesn't seem to care about the failure—it responds 200 and so the client is happy—but in our (dayjob) case, we're running a Phabricator instance which handles a non-zero exit from git-http-backend by responding 500, and the client dies.
$ git fetch --depth 1 https://phabricator.wikimedia.org/source/phabricator.git HEAD error: RPC failed; HTTP 500 curl 22 The requested URL returned error: 500 fatal: the remote end hung up unexpectedly
Quoted 4 lines
- likewise, the server doesn't care in terms of its response; by definition it is stateless, so the next request the client makes will start fresh
That makes sense to me.
Quoted 4 lines
- it is annoying for server admins who get a bunch of useless logs with "remote end hung up unexpected", or if they are tracking exit codes from upload-pack
Yes! Phabricator tries to work around this by detecting this stderr output with a regex, which doesn't seem to hold up too well over time.
See https://secure.phabricator.com/D21484
This is actually how I started down this rabbithole. It seemed odd to me that git-http-backend was exiting non-zero in the first place. Then again, I didn't much understand packfile negotiation, so it was just a hunch that there was some kind of bug. Knowing more about the protocol now, it definitely seems buggy.
Quoted 6 lines
As somebody who has admin'd a busy git site, unexpected client network drops are just a fact of life and you have to look past them in your logs. But I still think it's worth keeping it as uncluttered as possible and having upload-pack handle this without an error message.
Quoted 8 lines
Quoted 3 lines
Instead, upload-pack should gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
Should we do this only if we saw a deepen line? From my reading of the client code, that's the only thing that would cause this early request. I don't know if there's any particular advantage to being more strict here.
I'm not sure what would be more correct. It seems to go against the "server doesn't care" in a stateless case to be that strict, but maybe there are additional benefits to strictness I'm not aware of.
Quoted 7 lines
If we're _not_ going to be strict, then I actually wonder if we ought to simply teach
get_common_commits()that seeing an EOF is OK in stateless mode, wherever it comes. It can't possibly impact the correctness of the protocol conversation (since we're stateless and the client is gone), but maybe it's useful if you're trying to count how often clients really do hang up.
I originally took that approach, but gently handling an EOF in the get_common_commits loop resulted in a NAK being sent back because of:
if (packet_reader_read(reader) != PACKET_READ_NORMAL) {
[...]
if (data->have_obj.nr == 0 || data->multi_ack)
packet_write_fmt(1, "NAK\n");
[...]
if (data->stateless_rpc)
exit(0);
[...]
}which the client died on with an "expected shallow list" message. I didn't see a straightforward way of modifying the conditions _inside_ the loop while ensuring I wasn't changing any expected behavior upon EOF.
Quoted 9 lines
t/t9904-upload-pack-stateless-timely-eof.sh
Quoted 3 lines
t/t9904-upload-pack-stateless-timely-eof.sh new file +0
-0We usually try to group related tests by number. Maybe t5705 would be a better spot? I also wondered if this could go into t5704, but its title is "protocol violations". It's not clear to me yet if this is a violation that happens to be mostly harmless, or something we need to be doing. :)
Ah! Okay, I was wondering about that, whether the numbered prefixes were serial or otherwise meaningful. I'll try to group it appropriately.
Quoted 33 lines
t/t9904-upload-pack-stateless-timely-eof.sh
Quoted 8 lines
t/t9904-upload-pack-stateless-timely-eof.sh new file +7
-0+test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + hexsz=$(test_oid hexsz) && + + printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ + $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request &&We have a helper function that makes this a bit easier to read:
t/t9904-upload-pack-stateless-timely-eof.sh +6
-3@@ -9,10 +9,13 @@ D=$(pwd) test_expect_success 'upload-pack outputs flush and exits ok' ' test_commit initial && head=$(git rev-parse HEAD) && - hexsz=$(test_oid hexsz) && - printf "%04xwant %s\n%04xshallow %s\n000ddeepen 1\n0000" \ - $(($hexsz + 10)) $head $(($hexsz + 13)) $head >request && + { + packetize "want $head" && + packetize "shallow $head" && + packetize "deepen 1" && + printf "0000" + } >request && git upload-pack --stateless-rpc "$(pwd)" <request >actual &&
Quoted 5 lines
Quoted 1 line
+ git upload-pack --stateless-rpc "$(pwd)" <request >actual &&
You can just use "." here, which is a little shorter. It's not entirely cosmetic; the difference between $PWD and $(pwd) on Windows always trips me up, so I try to avoid using either whenever I can. ;)
Very cool re: the helpers. I'll make those changes.
Quoted 7 lines
It would be nice if we could test this through a real use of Git, but it might not be worth the hassle. I guess we'd have to mine the apache logs in one of our http test scripts to see if upload-pack failed. And I guess if we _do_ change the client side to stop sending the extra request but want to treat historical clients more gracefully, we'd still need a manual test like this.
Yeah I just went with the minimal case I'm familiar with, but I'm game to set up a more thorough case with some guidance.
Quoted 9 lines
upload-pack.c void upload_pack(struct upload_pack_options *options) · line 1344
Quoted 5 lines
upload-pack.c +0
-0@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);The actual fix looks correct to me, modulo the alternatives I raised earlier.
Quoted 5 lines
This function only handles the v0 protocol. For v2, we end up in
upload_pack_v2(). But my reading of the client sidedo_fetch_pack_v2()is that it _doesn't_ send this extra request. And a simple test seems to confirm it. Which gives me further pause as to whether the extra request is necessary for v0.
When I do a trace using v2, I see two roundtrip requests as well. I haven't tested the exit status of git-upload-pack in that case however. It's getting late for me but I'll investigate tomorrow.
Quoted 5 lines
Well, that review ended up a bit longer than I had imagined. So let me add what I should have said at the top: welcome to the Git list, and thanks for looking into this issue. :)
Thanks again! I appreciate all the feedback.
Quoted 11 lines · Daniel Duvall
Quoted 2 lines
- the client doesn't care; by definition it has hung up at this point and will keep going with its next request
That's true in the case where the server doesn't surface the non-zero exit code from git-upload-pack—which results in git-http-backend existing non-zero as well. An apache setup I used in testing doesn't seem to care about the failure—it responds 200 and so the client is happy—but in our (dayjob) case, we're running a Phabricator instance which handles a non-zero exit from git-http-backend by responding 500, and the client dies.
Quoted 4 lines
$ git fetch --depth 1 https://phabricator.wikimedia.org/source/phabricator.git HEAD error: RPC failed; HTTP 500 curl 22 The requested URL returned error: 500 fatal: the remote end hung up unexpectedly
Thanks, that's a really helpful data point. The flaw in my reasoning is that the client connection is bidirectional: just because the client hung up does not mean they are not still listening to the remainder of what the server has to say.
It sounds like Phabricator should probably be ignoring the exit code from http-backend. Or at least doing so when the CGI managed to produce an HTTP status code, and assuming that Git's response was either well-formed, or that the client will realize it was broken. (Or possibly http-backend should be less eager to pass along a non-zero exit code, but it amounts to the same thing).
But regardless, we should make sure that upload-pack is doing the right thing at least for this case.
Quoted 20 lines
Quoted 6 lines
If we're _not_ going to be strict, then I actually wonder if we ought to simply teach
get_common_commits()that seeing an EOF is OK in stateless mode, wherever it comes. It can't possibly impact the correctness of the protocol conversation (since we're stateless and the client is gone), but maybe it's useful if you're trying to count how often clients really do hang up.I originally took that approach, but gently handling an EOF in the
get_common_commitsloop resulted in a NAK being sent back because of:if (packet_reader_read(reader) != PACKET_READ_NORMAL) { [...] if (data->have_obj.nr == 0 || data->multi_ack) packet_write_fmt(1, "NAK\n"); [...] if (data->stateless_rpc) exit(0); [...] }
Quoted 4 lines
which the client died on with an "expected shallow list" message. I didn't see a straightforward way of modifying the conditions _inside_ the loop while ensuring I wasn't changing any expected behavior upon EOF.
I was thinking something more like:
upload-pack.c +9 -1
@@ -520,10 +520,18 @@ static int get_common_commits(struct upload_pack_data *data,for (;;) {const char *arg; +enum packet_read_status status;reset_timeout (data->timeout); -if (packet_reader_read (reader) !=PACKET_READ_NORMAL ) { + status =packet_reader_read (reader); +if (status ==PACKET_READ_EOF ) { +if (data->stateless_rpc) +exit (0 ); +die ("the remote end hung up unexpectedly" ); + } + +if (status !=PACKET_READ_NORMAL ) {if (data->multi_ack ==MULTI_ACK_DETAILED && got_common && !got_other
But after reading the rest of your response, I think it probably does make sense to be more strict here, and only handle the unexpected EOF before entering get_common_commits(). I don't _think_ it should matter to the client, because this whole "status != PACKET_READ_NORMAL" path would never be entered with the current code (we'd die() when we see the EOF inside packet_reader_read()).
Quoted 9 lines
Quoted 5 lines
This function only handles the v0 protocol. For v2, we end up in
upload_pack_v2(). But my reading of the client sidedo_fetch_pack_v2()is that it _doesn't_ send this extra request. And a simple test seems to confirm it. Which gives me further pause as to whether the extra request is necessary for v0.When I do a trace using v2, I see two roundtrip requests as well. I haven't tested the exit status of git-upload-pack in that case however. It's getting late for me but I'll investigate tomorrow.
There's an extra round-trip in v2: we probe for v2 and get the capabilities in the initial request, then we get the ref advertisement, then we start the object negotiation. In v0 the ref advertisement is lumped into the initial response.
Here's what I see with:
$ git init
$ GIT_TRACE_CURL=$PWD/trace.out \
git -c protocol.version=2 fetch --depth 1 \
https://github.com/git/git master
$ perl -lne '/(Send data:|Info: upload completely sent) .*/ and print $&' trace.out
Send data: 0014command=ls-refs.0024agent=git/2.29.2.477.g2cec8aa0af0001
Send data: 0009peel.000csymrefs.0016ref-prefix master.001bref-prefix re
Send data: fs/master.0020ref-prefix refs/tags/master.0021ref-prefix ref
Send data: s/heads/master.0023ref-prefix refs/remotes/master.0028ref-pr
Send data: efix refs/remotes/master/HEAD.001aref-prefix refs/tags/.0000
Info: upload completely sent off: 300 out of 300 bytes
Send data: 0011command=fetch0024agent=git/2.29.2.477.g2cec8aa0af0001000
Send data: dthin-pack000dofs-delta000cdeepen 10032want ad27df6a5cff694a
Send data: dd500ab8c7f97234feb4a91f.0009done.0000
Info: upload completely sent off: 158 out of 158 bytesSo the first one POST is getting the ref advertisement, and the second one is the full negotiation request, including the "done".
I'm still uncertain whether it could all be done in one request for v0. But one possible solution is: let's not care. If v2 does it correctly, that's the future anyway (or present; it's now the default in v2.29). And the change you're proposing in upload-pack would be desirable anyway to help deal with older clients.
If that's the route we go, we should make sure the commit message explains it.
-Peff
Quoted 8 lines · Jeff King
I'm still uncertain whether it could all be done in one request for v0. But one possible solution is: let's not care. If v2 does it correctly, that's the future anyway (or present; it's now the default in v2.29). And the change you're proposing in upload-pack would be desirable anyway to help deal with older clients.
If that's the route we go, we should make sure the commit message explains it.
Yeah, I'd agree that punting on v0 and making sure the current version would work well is good enough.
I lost track and am not sure what's the current status of the topic is. Is v3 [*1*] the latest and satisfactory one?
Thanks.
[Reference]
*1* https://lore.kernel.org/git/[email protected]/
Quoted 8 lines · Junio C Hamano
Quoted 6 lines · Jeff King
I'm still uncertain whether it could all be done in one request for v0. But one possible solution is: let's not care. If v2 does it correctly, that's the future anyway (or present; it's now the default in v2.29). And the change you're proposing in upload-pack would be desirable anyway to help deal with older clients.
Quoted 8 lines
Quoted 2 lines
If that's the route we go, we should make sure the commit message explains it.
Yeah, I'd agree that punting on v0 and making sure the current version would work well is good enough.
I lost track and am not sure what's the current status of the topic is. Is v3 [*1*] the latest and satisfactory one?
Yeah, I just read over v3 again and it looks good to me. Thanks, Daniel!
-Peff
Quoted 6 lines · Jeff King
Quoted 3 lines · Junio C Hamano
Yeah, I'd agree that punting on v0 and making sure the current version would work well is good enough.
Quoted 6 lines
Quoted 2 lines
I lost track and am not sure what's the current status of the topic is. Is v3 [*1*] the latest and satisfactory one?
Yeah, I just read over v3 again and it looks good to me. Thanks, Daniel!
-Peff
Contributing this tiny patch was a rewarding experience, getting to know Git more intimately and collaborating with you all. Thanks so much!
Kindly,
Daniel
Quoted 10 lines · Daniel Duvall
Quoted 9 lines · Jeff King
Quoted 5 lines · Junio C Hamano
Yeah, I'd agree that punting on v0 and making sure the current version would work well is good enough.
I lost track and am not sure what's the current status of the topic is. Is v3 [*1*] the latest and satisfactory one?
Quoted 7 lines
Quoted 3 lines
Yeah, I just read over v3 again and it looks good to me. Thanks, Daniel!
-Peff
Contributing this tiny patch was a rewarding experience, getting to know Git more intimately and collaborating with you all. Thanks so much!
Thanks, both of you. Marked v3 to be ready for 'next'.
PATCH v2 1/1 upload-pack: allow stateless client EOF just prior to haves
In reply to Daniel DuvallDuring stateless packfile negotiation where a depth is given, stateless RPC clients (e.g. git-remote-curl) will send multiple upload-pack requests with the first containing only the wants/shallows/deepens/filters and the subsequent containing haves/done.
When upload-pack handles such requests, entering get_common_commits without first whether the client has hung up can result in unexpected EOF during the negotiation loop and a die() with message "fatal: the remote end hung up unexpectedly".
Real world effects include:
- A client speaking to git-http-backend via a server that doesn't check the exit codes of CGIs (e.g. mod_cgi) doesn't know and doesn't care about the fatal. It continues to process the response body as normal.
- A client speaking to a server that does check the exit code and returns an errant HTTP status as a result will fail with the message "error: RPC failed; HTTP 500 curl 22 The requested URL returned error: 500."
- Admins running servers that surface the failure must workaround it by patching code that handles execution of git-http-backend to ignore exit codes or take other heuristic approaches.
- Admins may have to deal with "hung up unexpectedly" log spam related to the failures even in cases where the exit code isn't surfaced as an HTTP server-side error status.
To avoid these EOF related fatals, have upload-pack gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
---
Changes in v2:
- Replaced unconditional flipping (XOR) of PACKET_READ_GENTLE_ON_EOF bit w/ &= ~ to flip it back off (as it was when reader was initialized in previous clause)
- Renamed test filename to group with other upload-pack related tests
- Refactored test using packetize helper
- Clarified in commit message that file descriptor is still valid but client hangup/EOF is the core issue
- Added possible real-world effects of bug to commit message as suggested
--- t/t5705-upload-pack-stateless-shallow-eof.sh | 24 ++++++++++++++++++++ upload-pack.c | 13 ++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100755 t/t5705-upload-pack-stateless-shallow-eof.sh
t/t5705-upload-pack-stateless-shallow-eof.sh new file +24 -0
@@ -0,0 +1,24 @@ +#!/bin/sh + +test_description='stateless upload-pack gently handles EOF just after want/shallow/depth/flush' + +. ./test-lib.sh + +test_expect_success 'upload-pack outputs flush and exits ok' ' + test_commit initial && + head=$(git rev-parse HEAD) && + + { + packetize "want $head" && + packetize "shallow $head" && + packetize "deepen 1" && + printf "0000" + } >request && + + printf "0000" >expect && + git upload-pack --stateless-rpc . <request >actual && + + test_cmp expect actual +' + +test_done
upload-pack.c +12 -1
@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);receive_needs (&data, &reader); -if (data.want_obj.nr) { + +/* +* An EOF at this exact point in negotiation should be +* acceptable from stateless clients as they will consume the +* shallow list before doing subsequent rpc with haves/etc. +*/ +if (data.stateless_rpc) + reader.options |=PACKET_READ_GENTLE_ON_EOF ; + +if (data.want_obj.nr && +packet_reader_peek (&reader) !=PACKET_READ_EOF ) { + reader.options &= ~PACKET_READ_GENTLE_ON_EOF ;get_common_commits (&data, &reader);create_pack_file (&data,NULL ); }
Signature · 1 line
2.29.1.1.ge14d223
Quoted 4 lines
t/t5705-upload-pack-stateless-shallow-eof.sh | 24 ++++++++++++++++++++ upload-pack.c | 13 ++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100755 t/t5705-upload-pack-stateless-shallow-eof.sh
Yuck. Adding a new test file, only to hold a single test?
I'd rather see it folded in an existing test, if it makes sense.
Of course if we do not have any test for upload-pack, that's a different story, but I suspect we already do test the command in existing scripts.
Quoted 14 lines
upload-pack.c +5
-1@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);receive_needs (&data, &reader); -if (data.want_obj.nr) { + +/* +* An EOF at this exact point in negotiation should be +* acceptable from stateless clients as they will consume the +* shallow list before doing subsequent rpc with haves/etc.
upload-pack.c void upload_pack(struct upload_pack_options *options) · line 1361
Quoted 10 lines
upload-pack.c +7
-0+*/ +if (data.stateless_rpc) + reader.options |=PACKET_READ_GENTLE_ON_EOF ; + +if (data.want_obj.nr && +packet_reader_peek (&reader) !=PACKET_READ_EOF ) { + reader.options &= ~PACKET_READ_GENTLE_ON_EOF ;get_common_commits (&data, &reader);create_pack_file (&data,NULL ); }
Thanks.
Quoted 7 lines · Junio C Hamano
Quoted 5 lines
t/t5705-upload-pack-stateless-shallow-eof.sh | 24 ++++++++++++++++++++ upload-pack.c | 13 ++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100755 t/t5705-upload-pack-stateless-shallow-eof.shI'd rather see it folded in an existing test, if it makes sense.
With v3 I've moved it into t/t5530-upload-pack-error.sh. That test file seemed to mostly contain errant cases, but I thought it might be close enough as this was previously an errant case. If there's a better place for it I'm happy to move it again.
Quoted 7 lines · Daniel Duvall
Quoted 6 lines · Junio C Hamano
Quoted 5 lines
t/t5705-upload-pack-stateless-shallow-eof.sh | 24 ++++++++++++++++++++ upload-pack.c | 13 ++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100755 t/t5705-upload-pack-stateless-shallow-eof.sh
Quoted 6 lines
Quoted 1 line
I'd rather see it folded in an existing test, if it makes sense.
With v3 I've moved it into
t/t5530-upload-pack-error.sh. That test file seemed to mostly contain errant cases, but I thought it might be close enough as this was previously an errant case. If there's a better place for it I'm happy to move it again.
5530 is good. It is not too big or full of unrelated tests, and it is about sanity in the low level protocol exchange.
Thanks.
PATCH v3 1/1 upload-pack: allow stateless client EOF just prior to haves
In reply to Daniel DuvallDuring stateless packfile negotiation where a depth is given, stateless RPC clients (e.g. git-remote-curl) will send multiple upload-pack requests with the first containing only the wants/shallows/deepens/filters and the subsequent containing haves/done.
When upload-pack handles such requests, entering get_common_commits without checking whether the client has hung up can result in unexpected EOF during the negotiation loop and a die() with message "fatal: the remote end hung up unexpectedly".
Real world effects include:
- A client speaking to git-http-backend via a server that doesn't check the exit codes of CGIs (e.g. mod_cgi) doesn't know and doesn't care about the fatal. It continues to process the response body as normal.
- A client speaking to a server that does check the exit code and returns an errant HTTP status as a result will fail with the message "error: RPC failed; HTTP 500 curl 22 The requested URL returned error:
500."
- Admins running servers that surface the failure must workaround it by patching code that handles execution of git-http-backend to ignore exit codes or take other heuristic approaches.
- Admins may have to deal with "hung up unexpectedly" log spam related to the failures even in cases where the exit code isn't surfaced as an HTTP server-side error status.
To avoid these EOF related fatals, have upload-pack gently peek for an EOF between the sending of shallow/unshallow lines (followed by flush) and the reading of client haves. If the client has hung up at this point, exit normally.
---
Changes in v2:
- Replaced unconditional flipping (XOR) of PACKET_READ_GENTLE_ON_EOF bit w/ &= ~ to flip it back off (as it was when reader was initialized in previous clause)
- Renamed test filename to group with other upload-pack related tests
- Refactored test using packetize helper
- Clarified in commit message that file descriptor is still valid but client hangup/EOF is the core issue
- Added possible real-world effects of bug to commit message as suggested
Changes in v3:
- Moved test into existing t/t5530-upload-pack-error.sh
--- t/t5530-upload-pack-error.sh | 17 +++++++++++++++++ upload-pack.c | 13 ++++++++++++- 2 files changed, 29 insertions(+), 1 deletion(-)
t/t5530-upload-pack-error.sh +17 -0
@@ -88,6 +88,23 @@ test_expect_success 'upload-pack fails due to error in pack-objects enumeration' grep "pack-objects died" output.err ' +test_expect_success 'upload-pack tolerates EOF just after stateless client wants' ' + test_commit initial && + head=$(git rev-parse HEAD) && + + { + packetize "want $head" && + packetize "shallow $head" && + packetize "deepen 1" && + printf "0000" + } >request && + + printf "0000" >expect && + + git upload-pack --stateless-rpc . <request >actual && + test_cmp expect actual +' + test_expect_success 'create empty repository' ' mkdir foo &&
upload-pack.c +12 -1
@@ -1344,7 +1344,18 @@ void upload_pack(struct upload_pack_options *options) PACKET_READ_DIE_ON_ERR_PACKET);receive_needs (&data, &reader); -if (data.want_obj.nr) { + +/* +* An EOF at this exact point in negotiation should be +* acceptable from stateless clients as they will consume the +* shallow list before doing subsequent rpc with haves/etc. +*/ +if (data.stateless_rpc) + reader.options |=PACKET_READ_GENTLE_ON_EOF ; + +if (data.want_obj.nr && +packet_reader_peek (&reader) !=PACKET_READ_EOF ) { + reader.options &= ~PACKET_READ_GENTLE_ON_EOF ;get_common_commits (&data, &reader);create_pack_file (&data,NULL ); }
Signature · 1 line
2.29.2