[PATCH] eml: header_raw converts octets to Perl UTF-8

[Eric Wong]

Konstantin Ryabitsev  wrote:
> Hello:
> 
> There's a bit of inconsistency handling messages with utf8 content in the
> headers:
> 
> https://lore.kernel.org/b4-sent/20221122-gud-shadow-plane-v1-0-9de3afa33...@tronnes.org/
> 
> You can see that the name in the From: line is mangled, but in the thread
> overview it is displayed correctly.

Thanks, the overview and Xapian/SQLite DBs were correct because
PublicInbox::Smsg->populate had a special case.

The below case generalizes it to all HTML displays and removes
the special case.

> I know older SMTP standards still require 7bit escaping in the headers, but
> with SMTPUTF8 being very widely available, it should be possible to store and
> properly display messages with 8bit unicode in the headers.

Oops, I barely knew about it :x

Anyways, the below should fix it and I've deployed it to:
https://yhbt.net/lore/b4-sent/20221122-gud-shadow-plane-v1-0-9de3afa33...@tronnes.org/

I'm pretty sure it's safe, but my HW is problematic and I'm not
sure if it can finish a full reindex.

-8<
Subject: [PATCH] eml: header_raw converts octets to Perl UTF-8

This fixes the display of raw (non-RFC 2047) names and subjects
in HTML message views.

SMTPUTF8 (RFC 6531) allows raw UTF-8 in headers without RFC 2047
encoding, so let Perl handle it as a character sequence for the
rest of our consumers.  Thus, the old special case in
PublicInbox::Smsg->populate is no longer necessary and gone.

The one regression notice so far (and fixed here) is compressed
IMAP envelope responses still needs raw bytes since the zlib
wrapper is designed for octets, Perl UTF-8 bytes.  Thus we
reverse utf8::decode with utf8::encode in PublicInbox::IMAP::_esc.

->header_set also forces encoding to bytes, since all existing
callers would either be dealing with ->header_raw results or
be RFC-2047-encoded anyways.

Reindexing is not necessary with this change due to the prior
PublicInbox::Smsg->populate special case.

Reported-by: Konstantin Ryabitsev 
Link: 
https://public-inbox.org/meta/20221124153715.3nenjpjzj43vqxr2@meerkat.local/
---
 lib/PublicInbox/Eml.pm  |  8 +---
 lib/PublicInbox/IMAP.pm |  2 ++
 lib/PublicInbox/Smsg.pm |  3 ---
 t/imapd.t   | 28 
 t/psgi_search.t |  7 ++-
 5 files changed, 41 insertions(+), 7 deletions(-)

diff --git a/lib/PublicInbox/Eml.pm b/lib/PublicInbox/Eml.pm
index 485f637a..8b999e1a 100644
--- a/lib/PublicInbox/Eml.pm
+++ b/lib/PublicInbox/Eml.pm
@@ -1,4 +1,4 @@
-# Copyright (C) 2020-2021 all contributors 
+# Copyright (C) all contributors 
 # License: AGPL-3.0+ 
 #
 # Lazy MIME parser, it still slurps the full message but keeps short
@@ -144,6 +144,7 @@ sub header_raw {
my $re = re_memo($_[1]);
my @v = (${ $_[0]->{hdr} } =~ /$re/g);
for (@v) {
+   utf8::decode($_); # SMTPUTF8
# for compatibility w/ Email::Simple::Header,
s/\s+\z//s;
s/\A\s+//s;
@@ -359,14 +360,15 @@ sub header_set {
$pfx .= ': ';
my $len = 78 - length($pfx);
@vals = map {;
+   utf8::encode(my $v = $_); # to bytes, support SMTPUTF8
# folding differs from Email::Simple::Header,
# we favor tabs for visibility (and space savings :P)
if (length($_) >= $len && (/\n[^ \t]/s || !/\n/s)) {
local $Text::Wrap::columns = $len;
local $Text::Wrap::huge = 'overflow';
-   $pfx . wrap('', "\t", $_) . $self->{crlf};
+   $pfx . wrap('', "\t", $v) . $self->{crlf};
} else {
-   $pfx . $_ . $self->{crlf};
+   $pfx . $v . $self->{crlf};
}
} @vals;
$$hdr =~ s!$re!shift(@vals) // ''!ge; # replace current headers, first
diff --git a/lib/PublicInbox/IMAP.pm b/lib/PublicInbox/IMAP.pm
index 1f65aa65..37317948 100644
--- a/lib/PublicInbox/IMAP.pm
+++ b/lib/PublicInbox/IMAP.pm
@@ -426,8 +426,10 @@ sub _esc ($) {
if (!defined($v)) {
'NIL';
} elsif ($v =~ /[{"\r\n%*\\\[]/) { # literal string
+   utf8::encode($v);
'{' . length($v) . "}\r\n" . $v;
} else { # quoted string
+   utf8::encode($v);
qq{"$v"}
}
 }
diff --git a/lib/PublicInbox/Smsg.pm b/lib/PublicInbox/Smsg.pm
index 2026c7d9..b132381b 100644
--- a/lib/PublicInbox/Smsg.pm
+++ b/lib/PublicInbox/Smsg.pm
@@ -99,9 +99,6 @@ sub populate {
# to protect git and NNTP clients
$val =~ tr/\0\t\n/   /;
 
-   # rare: in case headers have wide chars (not RFC2047-encoded)
-   utf8::decode($val);
-
# lower-case fields for read-only stuff
$self->{lc($f)} = $val;
 
diff --git a/t/imapd.t b/t/imapd.t
index 3c74aefd..cbd6c1b9 100644
--- a/t/imapd.t
+++ b/t/imapd.

handling unquoted utf8 in the headers

[Konstantin Ryabitsev]

Hello:

There's a bit of inconsistency handling messages with utf8 content in the
headers:

https://lore.kernel.org/b4-sent/20221122-gud-shadow-plane-v1-0-9de3afa33...@tronnes.org/

You can see that the name in the From: line is mangled, but in the thread
overview it is displayed correctly.

I know older SMTP standards still require 7bit escaping in the headers, but
with SMTPUTF8 being very widely available, it should be possible to store and
properly display messages with 8bit unicode in the headers.

-K