git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: BUG: sendemail-validate hook is run too early

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 2, 2020, 20:26 UTC
Message-ID
<xmqqk169ehb1.fsf@gitster-ct.c.googlers.com>
In-Reply-To
<875zhut5yd.fsf@intel.com>
Jani Nikula <jani.nikula@intel.com> writes:
> I'm trying to use the sendemail-validate hook to validate the recipients
> of the patch email, among other things. Turns out the hook gets run
> immediately on the input patches, *not* on the "e-mail to be sent" as
> claimed by githooks(5).

I will make two suggestions, so please do not react before reading both ;-)

The purpose of the validate hook, at least as it was originally designed, was to vet the log message and patch contents, so what you reported is not at all surprising. After all, the sub that uses the hook is called "validate_patch" ;-).

A low-hanging documentation fix (this is one suggestion) is to phrase "e-mail to be sent" as "e-mail that has been submitted (to git-send-email)" to avoid the confusion.

You do not want to use the sendemail-validate hook for checking for the recipients, because the e-mail message is not a good source of that information.

When a recipient is added, two things happen:
 * The recipient is added to the (internal) list of recipients on
   the underlying sendmail command line arguments.  This is the list
   of addresses that actually matter where the piece of email goes.
 * The recipient is added to the text of the message being sent, if
   s/he is being added to either To: or Cc: (this is purely for
   human consumption and does not affect where the piece of email
   goes).  A blind-carbon-copy recipient would not be added for
   obvious reasons.

If you truly want to validate where the message goes, you'd need to vet the former list, not the latter one. Otherwise, you'll miss BCC recipients.

So the other suggestion is to have a separate hook to validate the list of recipients. This might be a bit more involved if we want to execute cleanly, but should not be rocket science.

The send_message() sub prepares @recipients list to form quite a bit of processing at the beginning, and the uses the resulting list to drive the sendmail by adding it to @sendmail_parameters(). The contents of this @recipients list is what you want to vet before the code talks to the sendmail program or daemon later in the function.

Previous: Jani NikulaNext: Jani Nikula
Message 2 of 4 in “BUG: sendemail-validate hook is run too early”
  1. Jani NikulaJan 2, 2020
  2. Junio C HamanoJan 2, 2020
  3. Jani NikulaJan 3, 2020
  4. Jani NikulaJan 3, 2020

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.