From 84e6c066fab5afd6b512cff321f064c7e94f4b12 Mon Sep 17 00:00:00 2001 From: Alberto Bertogli Date: Mon, 24 May 2021 01:00:40 +0100 Subject: [PATCH] docs: Add known issue about dkimsign and post-data hook There's a known issue in versions 0.07 to 1.5 where the post-data hook invocation can fail if the dkimsign binary exists, due to a bug in the post-data hook check. This was fixed by commit b6248f3, but it is found on occasion since the current Debian stable ships 0.07, and Ubuntu 20.04 LTS ships 1.2. So this patch adds it to the known issues list. --- docs/knownissues.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/knownissues.md b/docs/knownissues.md index 9645ea4..37dc503 100644 --- a/docs/knownissues.md +++ b/docs/knownissues.md @@ -9,3 +9,19 @@ Entries are eventually be purged once their affected versions become uncommon, to prevent confusion. +## `dkimsign` causes parsing errors in post-data hook (0.07 to 1.5) + +The default post-data hook in versions 0.07 to 1.5 has a bug where if the +`dkimsign` command exists, unwanted output will be emitted and cause the +post-data hook invocation to fail. + +The problem can be identified by the following error in the logs: + +``` +Hook.Post-DATA 1.2.3.4:5678: error: error parsing post-data output: \"/usr/bin/dkimsign\\n... +``` + +As a workaround, you can edit the hook and make the change +[seen here](https://blitiri.com.ar/git/r/chasquid/c/b6248f3089d7df93035bbbc0c11edf50709d5eb0/). + +The issue is fixed in 1.6.