From: Jeff King <peff@peff.net>
To: Ben Peart <Ben.Peart@microsoft.com>
Cc: "git@vger.kernel.org" <git@vger.kernel.org>,
"gitster@pobox.com" <gitster@pobox.com>,
"sandals@crustytoothpaste.net" <sandals@crustytoothpaste.net>,
"stolee@gmail.com" <stolee@gmail.com>
Subject: Re: [PATCH v1] convert log_ref_write_fd() to use strbuf
Date: Tue, 10 Jul 2018 14:45:34 -0400 [thread overview]
Message-ID: <20180710184534.GA27535@sigill.intra.peff.net> (raw)
In-Reply-To: <20180710182000.21404-1-benpeart@microsoft.com>
On Tue, Jul 10, 2018 at 06:20:22PM +0000, Ben Peart wrote:
> log_ref_write_fd() was written long before strbuf was fleshed out. Remove
> the old manual buffer management code and replace it with strbuf(). Also
> update copy_reflog_msg() which is called only by log_ref_write_fd() to use
> strbuf as it keeps things consistent.
Yay! In all of my buffer size auditing over the years, I've repeatedly
come across this "+ 100" but it never quite made the cut for fixing,
since it wasn't (yet) actually broken. Thanks for tackling it.
> -int copy_reflog_msg(char *buf, const char *msg)
> +void copy_reflog_msg(struct strbuf *sb, const char *msg)
Glad to see this "int" go; it should have been size_t anyway.
> {
> - char *cp = buf;
> char c;
> int wasspace = 1;
>
> - *cp++ = '\t';
> + strbuf_addch(sb, '\t');
> while ((c = *msg++)) {
> if (wasspace && isspace(c))
> continue;
> wasspace = isspace(c);
> if (wasspace)
> c = ' ';
> - *cp++ = c;
> + strbuf_addch(sb, c);
> }
This is all fairly straight-forward.
> - while (buf < cp && isspace(cp[-1]))
> - cp--;
> - *cp++ = '\n';
> - return cp - buf;
> + strbuf_rtrim(sb);
Using rtrim is a nice reduction in complexity. A pure translation would
include a final strbuf_addch(sb, '\n'). It looks like you moved that to
the caller. There's only one, so that's OK now, but it may affect topics
in flight (and I do in fact have an old topic that calls it).
But I think it's OK, as the change in function signature means that any
callers will need updated anyway. So there's little risk of a silent
mis-merge.
> diff --git a/refs/files-backend.c b/refs/files-backend.c
> index a9a066dcfb..c0e892d0c8 100644
> --- a/refs/files-backend.c
> +++ b/refs/files-backend.c
> @@ -1582,22 +1582,15 @@ static int log_ref_write_fd(int fd, const struct object_id *old_oid,
> const struct object_id *new_oid,
> const char *committer, const char *msg)
> {
> - int msglen, written;
> - unsigned maxlen, len;
> - char *logrec;
> -
> - msglen = msg ? strlen(msg) : 0;
> - maxlen = strlen(committer) + msglen + 100;
> - logrec = xmalloc(maxlen);
> - len = xsnprintf(logrec, maxlen, "%s %s %s\n",
> - oid_to_hex(old_oid),
> - oid_to_hex(new_oid),
> - committer);
> - if (msglen)
> - len += copy_reflog_msg(logrec + len - 1, msg) - 1;
> -
> - written = len <= maxlen ? write_in_full(fd, logrec, len) : -1;
> - free(logrec);
> + int written;
> + struct strbuf sb = STRBUF_INIT;
> +
> + strbuf_addf(&sb, "%s %s %s", oid_to_hex(old_oid), oid_to_hex(new_oid), committer);
> + if (msg && *msg)
> + copy_reflog_msg(&sb, msg);
> + strbuf_addch(&sb, '\n');
> + written = write_in_full(fd, sb.buf, sb.len);
> + strbuf_release(&sb);
> if (written < 0)
> return -1;
This looks like another straight-forward translation.
While we're here, is it worth turning "written" into an ssize_t, which
is the correct return from write_in_full()? Alternatively, I wonder if
the logic would be simpler to follow with:
int ret;
...strbuf bits...
if (write_in_full(fd, sb.buf, sb.len) < 0)
ret = -1;
else
ret = 0;
strbuf_release(&sb);
return ret;
We don't actually care about the number of bytes at all.
That's minor, though. With or without such a change, I'd be happy to see
it applied.
-Peff
next prev parent reply other threads:[~2018-07-10 18:45 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-10 18:20 [PATCH v1] convert log_ref_write_fd() to use strbuf Ben Peart
2018-07-10 18:45 ` Jeff King [this message]
2018-07-10 19:41 ` Junio C Hamano
2018-07-10 20:21 ` Jeff King
2018-07-10 20:57 ` Ben Peart
2018-07-10 21:08 ` [PATCH v2] " Ben Peart
2018-07-10 21:22 ` Junio C Hamano
2018-07-13 18:12 ` brian m. carlson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180710184534.GA27535@sigill.intra.peff.net \
--to=peff@peff.net \
--cc=Ben.Peart@microsoft.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=sandals@crustytoothpaste.net \
--cc=stolee@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).