From de33be8ad62f2c3c2f7c4030b1ebb301a73e0872 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Sat, 7 Feb 2026 14:08:53 +0000 Subject: final batch of code, this should be complete! --- doc/qmail-remote-io.html | 53 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 doc/qmail-remote-io.html (limited to 'doc/qmail-remote-io.html') diff --git a/doc/qmail-remote-io.html b/doc/qmail-remote-io.html new file mode 100644 index 0000000..bdede26 --- /dev/null +++ b/doc/qmail-remote-io.html @@ -0,0 +1,53 @@ + + + + + + smtpd-starttls-proxy: the qmail-remote-io internal program + + + + + + +

+smtpd-starttls-proxy
+Software
+skarnet.org +

+ +

The `qmail-remote-io` internal program

+ +

+qmail-remote-io is a part of the SMTP client implemented by +qmail-remote. It manages the entirety +of the SMTP transaction except EHLO and STARTTLS. +

+ +

+qmail-remote-io is not meant to be invoked directly. It is +meant to be executed into by qmail-remote. +

+ +

Internal details

+ +

qmail-remote does the job of finding a +suitable SMTP server and connecting to it, saying EHLO and, if the user +has defined a control/trustanchors file and the server supports it, +STARTTLS.
If the connection is not encrypted, +qmail-remote execs qmail-remote-io +immediately, and qmail-remote-io proceeds with all the rest of the +SMTP transaction.
If the connection is encrypted, +qmail-remote execs +s6-tlsc +qmail-remote-io, instead, so any further exchange with the SMTP server +is protected by TLS.
qmail-remote-io does the same job in either case: it speaks +plaintext SMTP.

+ + + -- cgit v1.3.1

The qmail-remote-io internal program

Internal details

The `qmail-remote-io` internal program