gpg-interface: allow sign_buffer() to use default signing key

The `sign_commit_to_strbuf()` helper in "commit.c" provides fallback logic to get the default configured signing key when a key is not provided and handles generating the commit signature accordingly. This signing operation is not really specific to commits as any arbitrary buffer can be signed. Also, in a subsequent commit, this same logic is reused by git-fast-import(1) when signing commits with invalid signatures. Remove the `sign_commit_to_strbuf()` helper from "commit.c" and extend `sign_buffer()` in "gpg-interface.c" to support using the default key as a fallback when the `SIGN_BUFFER_USE_DEFAULT_KEY` flag is provided. Call sites are updated accordingly. Signed-off-by: Justin Tobler <jltobler@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Justin Tobler committed Mar 12, 2026 at 20:39 UTC 86ebf870b909a7f4707aa2601d290bc992d21a53
5 files changed +29 -21
builtin/tag.c
+2 -2
@@ -167,7 +167,7 @@ static int do_sign(struct strbuf *buffer, struct object_id **compat_oid,
167 char *keyid = get_signing_key();
168 int ret = -1;
169
170 - if (sign_buffer(buffer, &sig, keyid))
170 + if (sign_buffer(buffer, &sig, keyid, 0))
171 goto out;
172
173 if (compat) {
@@ -176,7 +176,7 @@ static int do_sign(struct strbuf *buffer, struct object_id **compat_oid,
176 if (convert_object_file(the_repository ,&compat_buf, algo, compat,
177 buffer->buf, buffer->len, OBJ_TAG, 1))
178 goto out;
179 - if (sign_buffer(&compat_buf, &compat_sig, keyid))
179 + if (sign_buffer(&compat_buf, &compat_sig, keyid, 0))
180 goto out;
181 add_header_signature(&compat_buf, &sig, algo);
182 strbuf_addbuf(&compat_buf, &compat_sig);
commit.c
+5 -14
@@ -1170,18 +1170,6 @@ int add_header_signature(struct strbuf *buf, struct strbuf *sig, const struct gi
1170 return 0;
1171 }
1172
1173 -static int sign_commit_to_strbuf(struct strbuf *sig, struct strbuf *buf, const char *keyid)
1174 -{
1175 - char *keyid_to_free = NULL;
1176 - int ret = 0;
1177 - if (!keyid || !*keyid)
1178 - keyid = keyid_to_free = get_signing_key();
1179 - if (sign_buffer(buf, sig, keyid))
1180 - ret = -1;
1181 - free(keyid_to_free);
1182 - return ret;
1183 -}
1184 -
1173 int parse_signed_commit(const struct commit *commit,
1174 struct strbuf *payload, struct strbuf *signature,
1175 const struct git_hash_algo *algop)
@@ -1759,7 +1747,8 @@ int commit_tree_extended(const char *msg, size_t msg_len,
1747 oidcpy(&parent_buf[i++], &p->item->object.oid);
1748
1749 write_commit_tree(&buffer, msg, msg_len, tree, parent_buf, nparents, author, committer, extra);
1762 - if (sign_commit && sign_commit_to_strbuf(&sig, &buffer, sign_commit)) {
1750 + if (sign_commit && sign_buffer(&buffer, &sig, sign_commit,
1751 + SIGN_BUFFER_USE_DEFAULT_KEY)) {
1752 result = -1;
1753 goto out;
1754 }
@@ -1791,7 +1780,9 @@ int commit_tree_extended(const char *msg, size_t msg_len,
1780 free_commit_extra_headers(compat_extra);
1781 free(mapped_parents);
1782
1794 - if (sign_commit && sign_commit_to_strbuf(&compat_sig, &compat_buffer, sign_commit)) {
1783 + if (sign_commit && sign_buffer(&compat_buffer, &compat_sig,
1784 + sign_commit,
1785 + SIGN_BUFFER_USE_DEFAULT_KEY)) {
1786 result = -1;
1787 goto out;
1788 }
gpg-interface.c
+11 -2
@@ -974,11 +974,20 @@ const char *gpg_trust_level_to_str(enum signature_trust_level level)
974 return sigcheck_gpg_trust_level[level].display_key;
975 }
976
977 -int sign_buffer(struct strbuf *buffer, struct strbuf *signature, const char *signing_key)
977 +int sign_buffer(struct strbuf *buffer, struct strbuf *signature,
978 + const char *signing_key, enum sign_buffer_flags flags)
979 {
980 + char *keyid_to_free = NULL;
981 + int ret = 0;
982 +
983 gpg_interface_lazy_init();
984
981 - return use_format->sign_buffer(buffer, signature, signing_key);
985 + if ((flags & SIGN_BUFFER_USE_DEFAULT_KEY) && (!signing_key || !*signing_key))
986 + signing_key = keyid_to_free = get_signing_key();
987 +
988 + ret = use_format->sign_buffer(buffer, signature, signing_key);
989 + free(keyid_to_free);
990 + return ret;
991 }
992
993 /*
gpg-interface.h
+10 -2
@@ -74,6 +74,15 @@ int parse_signature(const char *buf, size_t size, struct strbuf *payload, struct
74 */
75 size_t parse_signed_buffer(const char *buf, size_t size);
76
77 +/* Flags for sign_buffer(). */
78 +enum sign_buffer_flags {
79 + /*
80 + * Use the default configured signing key as returned by `get_signing_key()`
81 + * when the provided "signing_key" is NULL or empty.
82 + */
83 + SIGN_BUFFER_USE_DEFAULT_KEY = (1 << 0),
84 +};
85 +
86 /*
87 * Create a detached signature for the contents of "buffer" and append
88 * it after "signature"; "buffer" and "signature" can be the same
@@ -81,8 +90,7 @@ size_t parse_signed_buffer(const char *buf, size_t size);
90 * at the end. Returns 0 on success, non-zero on failure.
91 */
92 int sign_buffer(struct strbuf *buffer, struct strbuf *signature,
84 - const char *signing_key);
85 -
93 + const char *signing_key, enum sign_buffer_flags flags);
94
95 /*
96 * Returns corresponding string in lowercase for a given member of
send-pack.c
+1 -1
@@ -391,7 +391,7 @@ static int generate_push_cert(struct strbuf *req_buf,
391 if (!update_seen)
392 goto free_return;
393
394 - if (sign_buffer(&cert, &cert, signing_key))
394 + if (sign_buffer(&cert, &cert, signing_key, 0))
395 die(_("failed to sign the push certificate"));
396
397 packet_buf_write(req_buf, "push-cert%c%s", 0, cap_string);